Skip to main content

aws_sdk_sts/operation/
get_federation_token.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2/// Orchestration and serialization glue logic for `GetFederationToken`.
3#[derive(::std::clone::Clone, ::std::default::Default, ::std::fmt::Debug)]
4#[non_exhaustive]
5pub struct GetFederationToken;
6impl GetFederationToken {
7    /// Creates a new `GetFederationToken`
8    pub fn new() -> Self {
9        Self
10    }
11    pub(crate) async fn orchestrate(
12                        runtime_plugins: &::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins,
13                        input: crate::operation::get_federation_token::GetFederationTokenInput,
14                    ) -> ::std::result::Result<crate::operation::get_federation_token::GetFederationTokenOutput, ::aws_smithy_runtime_api::client::result::SdkError<crate::operation::get_federation_token::GetFederationTokenError, ::aws_smithy_runtime_api::client::orchestrator::HttpResponse>> {
15                        let map_err = |err: ::aws_smithy_runtime_api::client::result::SdkError<::aws_smithy_runtime_api::client::interceptors::context::Error, ::aws_smithy_runtime_api::client::orchestrator::HttpResponse>| {
16                            err.map_service_error(|err| {
17                                err.downcast::<crate::operation::get_federation_token::GetFederationTokenError>().expect("correct error type")
18                            })
19                        };
20                        let context = Self::orchestrate_with_stop_point(runtime_plugins, input, ::aws_smithy_runtime::client::orchestrator::StopPoint::None)
21                            .await
22                            .map_err(map_err)?;
23                        let output = context.finalize().map_err(map_err)?;
24                        ::std::result::Result::Ok(output.downcast::<crate::operation::get_federation_token::GetFederationTokenOutput>().expect("correct output type"))
25                    }
26
27                    pub(crate) async fn orchestrate_with_stop_point(
28                        runtime_plugins: &::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins,
29                        input: crate::operation::get_federation_token::GetFederationTokenInput,
30                        stop_point: ::aws_smithy_runtime::client::orchestrator::StopPoint,
31                    ) -> ::std::result::Result<::aws_smithy_runtime_api::client::interceptors::context::InterceptorContext, ::aws_smithy_runtime_api::client::result::SdkError<::aws_smithy_runtime_api::client::interceptors::context::Error, ::aws_smithy_runtime_api::client::orchestrator::HttpResponse>> {
32                        let input = ::aws_smithy_runtime_api::client::interceptors::context::Input::erase(input);
33                        use ::tracing::Instrument;
34                        ::aws_smithy_runtime::client::orchestrator::invoke_with_stop_point(
35                            "STS",
36                            "GetFederationToken",
37                            input,
38                            runtime_plugins,
39                            stop_point
40                        )
41                        // Create a parent span for the entire operation. Includes a random, internal-only,
42                        // seven-digit ID for the operation orchestration so that it can be correlated in the logs.
43                        .instrument(::tracing::debug_span!(
44                                "STS.GetFederationToken",
45                                "rpc.service" = "STS",
46                                "rpc.method" = "GetFederationToken",
47                                "sdk_invocation_id" = ::fastrand::u32(1_000_000..10_000_000),
48                                "rpc.system" = "aws-api",
49                            ))
50                        .await
51                    }
52
53                    pub(crate) fn operation_runtime_plugins(
54                        client_runtime_plugins: ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins,
55                        client_config: &crate::config::Config,
56                        config_override: ::std::option::Option<crate::config::Builder>,
57                    ) -> ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins {
58                        let mut runtime_plugins = client_runtime_plugins.with_operation_plugin(Self::new());
59
60                        if let ::std::option::Option::Some(config_override) = config_override {
61                            for plugin in config_override.runtime_plugins.iter().cloned() {
62                                runtime_plugins = runtime_plugins.with_operation_plugin(plugin);
63                            }
64                            runtime_plugins = runtime_plugins.with_operation_plugin(
65                                crate::config::ConfigOverrideRuntimePlugin::new(config_override, client_config.config.clone(), &client_config.runtime_components)
66                            );
67                        }
68                        runtime_plugins
69                    }
70}
71impl ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugin for GetFederationToken {
72                fn config(&self) -> ::std::option::Option<::aws_smithy_types::config_bag::FrozenLayer> {
73                    let mut cfg = ::aws_smithy_types::config_bag::Layer::new("GetFederationToken");
74
75                    cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedRequestSerializer::new(GetFederationTokenRequestSerializer));
76                    cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedResponseDeserializer::new(GetFederationTokenResponseDeserializer));
77
78                    cfg.store_put(::aws_smithy_runtime_api::client::auth::AuthSchemeOptionResolverParams::new(
79                        crate::config::auth::Params::builder()
80                            .operation_name("GetFederationToken")
81                            .build()
82                            .expect("required fields set")
83                    ));
84
85                    cfg.store_put(::aws_smithy_runtime_api::client::orchestrator::SensitiveOutput);
86cfg.store_put(::aws_smithy_runtime_api::client::orchestrator::Metadata::new(
87                            "GetFederationToken",
88                            "STS",
89                        ));
90let mut signing_options = ::aws_runtime::auth::SigningOptions::default();
91                            signing_options.double_uri_encode = true;
92                            signing_options.content_sha256_header = false;
93                            signing_options.normalize_uri_path = true;
94                            signing_options.payload_override = None;
95
96                            cfg.store_put(::aws_runtime::auth::SigV4OperationSigningConfig {
97                                signing_options,
98                                ..::std::default::Default::default()
99                            });
100
101                    ::std::option::Option::Some(cfg.freeze())
102                }
103
104                fn runtime_components(&self, _: &::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder) -> ::std::borrow::Cow<'_, ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder> {
105                    #[allow(unused_mut)]
106                    let mut rcb = ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder::new("GetFederationToken")
107                            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(GetFederationTokenTelemetryInputCaptureInterceptor))
108.with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(::aws_smithy_runtime::client::stalled_stream_protection::StalledStreamProtectionInterceptor::default()))
109.with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(GetFederationTokenEndpointParamsInterceptor))
110                            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::TransientErrorClassifier::<crate::operation::get_federation_token::GetFederationTokenError>::new())
111.with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::ModeledAsRetryableClassifier::<crate::operation::get_federation_token::GetFederationTokenError>::new())
112.with_retry_classifier(::aws_runtime::retries::classifiers::AwsErrorCodeClassifier::<crate::operation::get_federation_token::GetFederationTokenError>::builder().transient_errors({
113                                            let mut transient_errors: Vec<&'static str> = ::aws_runtime::retries::classifiers::TRANSIENT_ERRORS.into();
114                                            transient_errors.push("IDPCommunicationError");
115                                            ::std::borrow::Cow::Owned(transient_errors)
116                                            }).build());
117
118                    ::std::borrow::Cow::Owned(rcb)
119                }
120            }
121
122            #[derive(Debug)]
123            struct GetFederationTokenTelemetryInputCaptureInterceptor;
124
125            #[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
126            impl ::aws_smithy_runtime_api::client::interceptors::Intercept for GetFederationTokenTelemetryInputCaptureInterceptor {
127                fn name(&self) -> &'static str {
128                    "GetFederationTokenTelemetryInputCaptureInterceptor"
129                }
130
131                fn read_before_execution(
132                    &self,
133                    context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<'_, ::aws_smithy_runtime_api::client::interceptors::context::Input, ::aws_smithy_runtime_api::client::interceptors::context::Output, ::aws_smithy_runtime_api::client::interceptors::context::Error>,
134                    cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
135                ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
136                    // Nothing to do unless the customer opted in by naming members to record.
137                    let ::std::option::Option::Some(requested) = cfg.load::<::aws_smithy_types::telemetry::RequestedTelemetryAttributes>().filter(|r| !r.is_empty()) else {
138                        return ::std::result::Result::Ok(());
139                    };
140
141                    let ::std::option::Option::Some(input) = context.input().downcast_ref::<GetFederationTokenInput>() else {
142                        // A mismatched input is not this interceptor's concern; skip quietly.
143                        return ::std::result::Result::Ok(());
144                    };
145
146                    let mut captured = ::aws_smithy_types::telemetry::CapturedTelemetryAttributes::default();
147                    if requested.should_capture("Name") {
148                        if let ::std::option::Option::Some(value) = input.name.as_deref() {
149                            captured.insert("Name", value);
150                        }
151                    }
152if requested.should_capture("Policy") {
153                        if let ::std::option::Option::Some(value) = input.policy.as_deref() {
154                            captured.insert("Policy", value);
155                        }
156                    }
157
158                    cfg.interceptor_state().store_put(captured);
159                    ::std::result::Result::Ok(())
160                }
161            }
162#[derive(Debug)]
163            struct GetFederationTokenResponseDeserializer;
164            impl ::aws_smithy_runtime_api::client::ser_de::DeserializeResponse for GetFederationTokenResponseDeserializer {
165
166
167                fn deserialize_nonstreaming_with_config(&self, response: &::aws_smithy_runtime_api::client::orchestrator::HttpResponse, _cfg: &::aws_smithy_types::config_bag::ConfigBag) -> ::aws_smithy_runtime_api::client::interceptors::context::OutputOrError {
168                    let (success, status) = (response.status().is_success(), response.status().as_u16());
169            let headers = response.headers();
170            let body = response.body().bytes().expect("body loaded");
171            #[allow(unused_mut)]
172            let mut force_error = false;
173            ::tracing::debug!(request_id = ?::aws_types::request_id::RequestId::request_id(response));
174            let parse_result = if !success && status != 200 || force_error {
175                crate::protocol_serde::shape_get_federation_token::de_get_federation_token_http_error(status, headers, body)
176            } else {
177                crate::protocol_serde::shape_get_federation_token::de_get_federation_token_http_response(status, headers, body)
178            };
179            crate::protocol_serde::type_erase_result(parse_result)
180                }
181            }
182#[derive(Debug)]
183            struct GetFederationTokenRequestSerializer;
184            impl ::aws_smithy_runtime_api::client::ser_de::SerializeRequest for GetFederationTokenRequestSerializer {
185                #[allow(unused_mut, clippy::let_and_return, clippy::needless_borrow, clippy::useless_conversion)]
186                fn serialize_input(&self, input: ::aws_smithy_runtime_api::client::interceptors::context::Input, _cfg: &mut ::aws_smithy_types::config_bag::ConfigBag) -> ::std::result::Result<::aws_smithy_runtime_api::client::orchestrator::HttpRequest, ::aws_smithy_runtime_api::box_error::BoxError> {
187                    let input = input.downcast::<crate::operation::get_federation_token::GetFederationTokenInput>().expect("correct type");
188                    let _header_serialization_settings = _cfg.load::<crate::serialization_settings::HeaderSerializationSettings>().cloned().unwrap_or_default();
189                    let mut request_builder = {
190                        #[allow(clippy::uninlined_format_args)]
191fn uri_base(_input: &crate::operation::get_federation_token::GetFederationTokenInput, output: &mut ::std::string::String) -> ::std::result::Result<(), ::aws_smithy_types::error::operation::BuildError> {
192    use ::std::fmt::Write as _;
193    ::std::write!(output, "/").expect("formatting should succeed");
194    ::std::result::Result::Ok(())
195}
196#[allow(clippy::unnecessary_wraps)]
197fn update_http_builder(
198                input: &crate::operation::get_federation_token::GetFederationTokenInput,
199                builder: ::http_1x::request::Builder
200            ) -> ::std::result::Result<::http_1x::request::Builder, ::aws_smithy_types::error::operation::BuildError> {
201    let mut uri = ::std::string::String::new();
202    uri_base(input, &mut uri)?;
203    ::std::result::Result::Ok(builder.method("POST").uri(uri))
204}
205let mut builder = update_http_builder(&input, ::http_1x::request::Builder::new())?;
206builder = _header_serialization_settings.set_default_header(builder, ::http_1x::header::CONTENT_TYPE, "application/x-www-form-urlencoded");
207builder
208                    };
209                    let body = ::aws_smithy_types::body::SdkBody::from(crate::protocol_serde::shape_get_federation_token_input::ser_get_federation_token_input_input_input(&input)?);
210                    if let Some(content_length) = body.content_length() {
211                                let content_length = content_length.to_string();
212                                request_builder = _header_serialization_settings.set_default_header(request_builder, ::http_1x::header::CONTENT_LENGTH, &content_length);
213                            }
214                    ::std::result::Result::Ok(request_builder.body(body).expect("valid request").try_into().unwrap())
215                }
216            }
217#[derive(Debug)]
218            struct GetFederationTokenEndpointParamsInterceptor;
219
220            #[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
221            impl ::aws_smithy_runtime_api::client::interceptors::Intercept for GetFederationTokenEndpointParamsInterceptor {
222                fn name(&self) -> &'static str {
223                    "GetFederationTokenEndpointParamsInterceptor"
224                }
225
226                fn read_before_execution(
227                    &self,
228                    context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<'_, ::aws_smithy_runtime_api::client::interceptors::context::Input, ::aws_smithy_runtime_api::client::interceptors::context::Output, ::aws_smithy_runtime_api::client::interceptors::context::Error>,
229                    cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
230                ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
231                    let _input = context.input()
232                        .downcast_ref::<GetFederationTokenInput>()
233                        .ok_or("failed to downcast to GetFederationTokenInput")?;
234
235
236
237                    let params = crate::config::endpoint::Params::builder()
238                        .set_region(cfg.load::<::aws_types::region::Region>().map(|r|r.as_ref().to_owned()))
239.set_use_dual_stack(cfg.load::<::aws_types::endpoint_config::UseDualStack>().map(|ty| ty.0))
240.set_use_fips(cfg.load::<::aws_types::endpoint_config::UseFips>().map(|ty| ty.0))
241.set_endpoint(cfg.load::<::aws_types::endpoint_config::EndpointUrl>().map(|ty| ty.0.clone()))
242                        .build()
243                        .map_err(|err| ::aws_smithy_runtime_api::client::interceptors::error::ContextAttachedError::new("endpoint params could not be built", err))?;
244                    cfg.interceptor_state().store_put(::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams::new(params));
245                    ::std::result::Result::Ok(())
246                }
247            }
248
249            // The get_* functions below are generated from JMESPath expressions in the
250            // operationContextParams trait. They target the operation's input shape.
251
252
253
254/// Error type for the `GetFederationTokenError` operation.
255#[non_exhaustive]
256#[derive(::std::fmt::Debug)]
257pub enum GetFederationTokenError {
258    /// <p>The request was rejected because the policy document was malformed. The error message describes the specific error.</p>
259    MalformedPolicyDocumentException(crate::types::error::MalformedPolicyDocumentException),
260    /// <p>The request was rejected because the total packed size of the session policies and session tags combined was too large. An Amazon Web Services conversion compresses the session policy document, session policy ARNs, and session tags into a packed binary format that has a separate limit. The error message indicates by percentage how close the policies and tags are to the upper size limit. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Passing Session Tags in STS</a> in the <i>IAM User Guide</i>.</p>
261    /// <p>You could receive this error even though you meet other defined session policy and session tag limits. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html#reference_iam-limits-entity-length">IAM and STS Entity Character Limits</a> in the <i>IAM User Guide</i>.</p>
262    PackedPolicyTooLargeException(crate::types::error::PackedPolicyTooLargeException),
263    /// <p>STS is not activated in the requested region for the account that is being asked to generate credentials. The account administrator must use the IAM console to activate STS in that region. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html#sts-regions-activate-deactivate">Activating and Deactivating STS in an Amazon Web Services Region</a> in the <i>IAM User Guide</i>.</p>
264    RegionDisabledException(crate::types::error::RegionDisabledException),
265    /// An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).
266                    #[deprecated(note = "Matching `Unhandled` directly is not forwards compatible. Instead, match using a \
267    variable wildcard pattern and check `.code()`:
268     \
269    &nbsp;&nbsp;&nbsp;`err if err.code() == Some(\"SpecificExceptionCode\") => { /* handle the error */ }`
270     \
271    See [`ProvideErrorMetadata`](#impl-ProvideErrorMetadata-for-GetFederationTokenError) for what information is available for the error.")]
272                    Unhandled(crate::error::sealed_unhandled::Unhandled),
273}
274impl GetFederationTokenError {
275    /// Creates the `GetFederationTokenError::Unhandled` variant from any error type.
276                    pub fn unhandled(err: impl ::std::convert::Into<::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>>) -> Self {
277                        Self::Unhandled(crate::error::sealed_unhandled::Unhandled { source: err.into(), meta: ::std::default::Default::default() })
278                    }
279
280                    /// Creates the `GetFederationTokenError::Unhandled` variant from an [`ErrorMetadata`](::aws_smithy_types::error::ErrorMetadata).
281                    pub fn generic(err: ::aws_smithy_types::error::ErrorMetadata) -> Self {
282                        Self::Unhandled(crate::error::sealed_unhandled::Unhandled { source: err.clone().into(), meta: err })
283                    }
284    ///
285    /// Returns error metadata, which includes the error code, message,
286    /// request ID, and potentially additional information.
287    ///
288    pub fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
289        match self {
290            Self::MalformedPolicyDocumentException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
291            Self::PackedPolicyTooLargeException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
292            Self::RegionDisabledException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
293            Self::Unhandled(e) => &e.meta,
294        }
295    }
296    /// Returns `true` if the error kind is `GetFederationTokenError::MalformedPolicyDocumentException`.
297    pub fn is_malformed_policy_document_exception(&self) -> bool {
298        matches!(self, Self::MalformedPolicyDocumentException(_))
299    }
300    /// Returns `true` if the error kind is `GetFederationTokenError::PackedPolicyTooLargeException`.
301    pub fn is_packed_policy_too_large_exception(&self) -> bool {
302        matches!(self, Self::PackedPolicyTooLargeException(_))
303    }
304    /// Returns `true` if the error kind is `GetFederationTokenError::RegionDisabledException`.
305    pub fn is_region_disabled_exception(&self) -> bool {
306        matches!(self, Self::RegionDisabledException(_))
307    }
308}
309impl ::std::error::Error for GetFederationTokenError {
310    fn source(&self) -> ::std::option::Option<&(dyn ::std::error::Error + 'static)> {
311        match self {
312            Self::MalformedPolicyDocumentException(_inner) =>
313            ::std::option::Option::Some(_inner)
314            ,
315            Self::PackedPolicyTooLargeException(_inner) =>
316            ::std::option::Option::Some(_inner)
317            ,
318            Self::RegionDisabledException(_inner) =>
319            ::std::option::Option::Some(_inner)
320            ,
321            Self::Unhandled(_inner) => {
322                ::std::option::Option::Some(&*_inner.source)
323            }
324        }
325    }
326}
327impl ::std::fmt::Display for GetFederationTokenError {
328    fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
329        match self {
330            Self::MalformedPolicyDocumentException(_inner) =>
331            _inner.fmt(f)
332            ,
333            Self::PackedPolicyTooLargeException(_inner) =>
334            _inner.fmt(f)
335            ,
336            Self::RegionDisabledException(_inner) =>
337            _inner.fmt(f)
338            ,
339            Self::Unhandled(_inner) => {
340                if let ::std::option::Option::Some(code) = ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self) {
341                                                        write!(f, "unhandled error ({code})")
342                                                    } else {
343                                                        f.write_str("unhandled error")
344                                                    }
345            }
346        }
347    }
348}
349impl ::aws_smithy_types::retry::ProvideErrorKind for GetFederationTokenError {
350    fn code(&self) -> ::std::option::Option<&str> {
351        ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self)
352    }
353    fn retryable_error_kind(&self) -> ::std::option::Option<::aws_smithy_types::retry::ErrorKind> {
354        ::std::option::Option::None
355    }
356}
357impl ::aws_smithy_types::error::metadata::ProvideErrorMetadata for GetFederationTokenError {
358    fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
359        match self {
360            Self::MalformedPolicyDocumentException(_inner) =>
361            ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner)
362            ,
363            Self::PackedPolicyTooLargeException(_inner) =>
364            ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner)
365            ,
366            Self::RegionDisabledException(_inner) =>
367            ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner)
368            ,
369            Self::Unhandled(_inner) => {
370                &_inner.meta
371            }
372        }
373    }
374}
375impl ::aws_smithy_runtime_api::client::result::CreateUnhandledError for GetFederationTokenError {
376    fn create_unhandled_error(
377                        source: ::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>,
378                        meta: ::std::option::Option<::aws_smithy_types::error::ErrorMetadata>
379                    ) -> Self {
380        Self::Unhandled(crate::error::sealed_unhandled::Unhandled { source, meta: meta.unwrap_or_default() })
381    }
382}
383impl ::aws_types::request_id::RequestId for crate::operation::get_federation_token::GetFederationTokenError {
384                                fn request_id(&self) -> Option<&str> {
385                                    self.meta().request_id()
386                                }
387                            }
388
389pub use crate::operation::get_federation_token::_get_federation_token_input::GetFederationTokenInput;
390
391pub use crate::operation::get_federation_token::_get_federation_token_output::GetFederationTokenOutput;
392
393mod _get_federation_token_input;
394
395mod _get_federation_token_output;
396
397/// Builders
398pub mod builders;
399