aws_sdk_sts/operation/
assume_root.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2/// Orchestration and serialization glue logic for `AssumeRoot`.
3#[derive(::std::clone::Clone, ::std::default::Default, ::std::fmt::Debug)]
4#[non_exhaustive]
5pub struct AssumeRoot;
6impl AssumeRoot {
7    /// Creates a new `AssumeRoot`
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::assume_root::AssumeRootInput,
14                    ) -> ::std::result::Result<crate::operation::assume_root::AssumeRootOutput, ::aws_smithy_runtime_api::client::result::SdkError<crate::operation::assume_root::AssumeRootError, ::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::assume_root::AssumeRootError>().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::assume_root::AssumeRootOutput>().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::assume_root::AssumeRootInput,
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                            "AssumeRoot",
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.AssumeRoot",
45                                "rpc.service" = "STS",
46                                "rpc.method" = "AssumeRoot",
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 AssumeRoot {
72                fn config(&self) -> ::std::option::Option<::aws_smithy_types::config_bag::FrozenLayer> {
73                    let mut cfg = ::aws_smithy_types::config_bag::Layer::new("AssumeRoot");
74
75                    cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedRequestSerializer::new(AssumeRootRequestSerializer));
76                    cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedResponseDeserializer::new(AssumeRootResponseDeserializer));
77
78                    cfg.store_put(::aws_smithy_runtime_api::client::auth::AuthSchemeOptionResolverParams::new(
79                        crate::config::auth::Params::builder()
80                            .operation_name("AssumeRoot")
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                            "AssumeRoot",
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("AssumeRoot")
107                            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(AssumeRootTelemetryInputCaptureInterceptor))
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(AssumeRootEndpointParamsInterceptor))
110                            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::TransientErrorClassifier::<crate::operation::assume_root::AssumeRootError>::new())
111.with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::ModeledAsRetryableClassifier::<crate::operation::assume_root::AssumeRootError>::new())
112.with_retry_classifier(::aws_runtime::retries::classifiers::AwsErrorCodeClassifier::<crate::operation::assume_root::AssumeRootError>::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.with_retry_classifier(::aws_runtime::service_clock_skew::ServiceClockSkewClassifier::<crate::operation::assume_root::AssumeRootError>::new());
118
119                    ::std::borrow::Cow::Owned(rcb)
120                }
121            }
122
123            #[derive(Debug)]
124            struct AssumeRootTelemetryInputCaptureInterceptor;
125
126            #[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
127            impl ::aws_smithy_runtime_api::client::interceptors::Intercept for AssumeRootTelemetryInputCaptureInterceptor {
128                fn name(&self) -> &'static str {
129                    "AssumeRootTelemetryInputCaptureInterceptor"
130                }
131
132                fn read_before_execution(
133                    &self,
134                    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>,
135                    cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
136                ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
137                    // Nothing to do unless the customer opted in by naming members to record.
138                    let ::std::option::Option::Some(requested) = cfg.load::<::aws_smithy_types::telemetry::RequestedTelemetryAttributes>().filter(|r| !r.is_empty()) else {
139                        return ::std::result::Result::Ok(());
140                    };
141
142                    let ::std::option::Option::Some(input) = context.input().downcast_ref::<AssumeRootInput>() else {
143                        // A mismatched input is not this interceptor's concern; skip quietly.
144                        return ::std::result::Result::Ok(());
145                    };
146
147                    let mut captured = ::aws_smithy_types::telemetry::CapturedTelemetryAttributes::default();
148                    if requested.should_capture("TargetPrincipal") {
149                            if let ::std::option::Option::Some(value) = input.target_principal.as_deref() {
150                                captured.insert("TargetPrincipal", value);
151                            }
152                        }
153
154                    cfg.interceptor_state().store_put(captured);
155                    ::std::result::Result::Ok(())
156                }
157            }
158#[derive(Debug)]
159            struct AssumeRootResponseDeserializer;
160            impl ::aws_smithy_runtime_api::client::ser_de::DeserializeResponse for AssumeRootResponseDeserializer {
161
162
163                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 {
164                    let (success, status) = (response.status().is_success(), response.status().as_u16());
165            let headers = response.headers();
166            let body = response.body().bytes().expect("body loaded");
167            #[allow(unused_mut)]
168            let mut force_error = false;
169            ::tracing::debug!(request_id = ?::aws_types::request_id::RequestId::request_id(response));
170            let parse_result = if !success && status != 200 || force_error {
171                crate::protocol_serde::shape_assume_root::de_assume_root_http_error(status, headers, body, _cfg)
172            } else {
173                crate::protocol_serde::shape_assume_root::de_assume_root_http_response(status, headers, body, _cfg)
174            };
175            crate::protocol_serde::type_erase_result(parse_result)
176                }
177            }
178#[derive(Debug)]
179            struct AssumeRootRequestSerializer;
180            impl ::aws_smithy_runtime_api::client::ser_de::SerializeRequest for AssumeRootRequestSerializer {
181                #[allow(unused_mut, clippy::let_and_return, clippy::needless_borrow, clippy::useless_conversion)]
182                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> {
183                    let input = input.downcast::<crate::operation::assume_root::AssumeRootInput>().expect("correct type");
184                    let _header_serialization_settings = _cfg.load::<crate::serialization_settings::HeaderSerializationSettings>().cloned().unwrap_or_default();
185                    let mut request_builder = {
186                        #[allow(clippy::uninlined_format_args)]
187fn uri_base(_input: &crate::operation::assume_root::AssumeRootInput, output: &mut ::std::string::String) -> ::std::result::Result<(), ::aws_smithy_types::error::operation::BuildError> {
188    use ::std::fmt::Write as _;
189    ::std::write!(output, "/").expect("formatting should succeed");
190    ::std::result::Result::Ok(())
191}
192#[allow(clippy::unnecessary_wraps)]
193fn update_http_builder(
194                input: &crate::operation::assume_root::AssumeRootInput,
195                builder: ::http_1x::request::Builder
196            ) -> ::std::result::Result<::http_1x::request::Builder, ::aws_smithy_types::error::operation::BuildError> {
197    let mut uri = ::std::string::String::new();
198    uri_base(input, &mut uri)?;
199    ::std::result::Result::Ok(builder.method("POST").uri(uri))
200}
201let mut builder = update_http_builder(&input, ::http_1x::request::Builder::new())?;
202builder = _header_serialization_settings.set_default_header(builder, ::http_1x::header::CONTENT_TYPE, "application/x-www-form-urlencoded");
203builder
204                    };
205                    let body = ::aws_smithy_types::body::SdkBody::from(crate::protocol_serde::shape_assume_root_input::ser_assume_root_input_input_input(&input)?);
206                    if let Some(content_length) = body.content_length() {
207                                let content_length = content_length.to_string();
208                                request_builder = _header_serialization_settings.set_default_header(request_builder, ::http_1x::header::CONTENT_LENGTH, &content_length);
209                            }
210                    ::std::result::Result::Ok(request_builder.body(body).expect("valid request").try_into().unwrap())
211                }
212            }
213#[derive(Debug)]
214            struct AssumeRootEndpointParamsInterceptor;
215
216            #[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
217            impl ::aws_smithy_runtime_api::client::interceptors::Intercept for AssumeRootEndpointParamsInterceptor {
218                fn name(&self) -> &'static str {
219                    "AssumeRootEndpointParamsInterceptor"
220                }
221
222                fn read_before_execution(
223                    &self,
224                    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>,
225                    cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
226                ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
227                    let _input = context.input()
228                        .downcast_ref::<AssumeRootInput>()
229                        .ok_or("failed to downcast to AssumeRootInput")?;
230
231
232
233                    let params = crate::config::endpoint::Params::builder()
234                        .set_region(cfg.load::<::aws_types::region::Region>().map(|r|r.as_ref().to_owned()))
235.set_use_dual_stack(cfg.load::<::aws_types::endpoint_config::UseDualStack>().map(|ty| ty.0))
236.set_use_fips(cfg.load::<::aws_types::endpoint_config::UseFips>().map(|ty| ty.0))
237.set_endpoint(cfg.load::<::aws_types::endpoint_config::EndpointUrl>().map(|ty| ty.0.clone()))
238                        .build()
239                        .map_err(|err| ::aws_smithy_runtime_api::client::interceptors::error::ContextAttachedError::new("endpoint params could not be built", err))?;
240                    cfg.interceptor_state().store_put(::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams::new(params));
241                    ::std::result::Result::Ok(())
242                }
243            }
244
245            // The get_* functions below are generated from JMESPath expressions in the
246            // operationContextParams trait. They target the operation's input shape.
247
248
249
250/// Error type for the `AssumeRootError` operation.
251#[non_exhaustive]
252#[derive(::std::fmt::Debug)]
253pub enum AssumeRootError {
254    /// <p>The web identity token that was passed is expired or is not valid. Get a new identity token from the identity provider and then retry the request.</p>
255    ExpiredTokenException(crate::types::error::ExpiredTokenException),
256    /// <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>
257    RegionDisabledException(crate::types::error::RegionDisabledException),
258    /// An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).
259                    #[deprecated(note = "Matching `Unhandled` directly is not forwards compatible. Instead, match using a \
260    variable wildcard pattern and check `.code()`:
261     \
262    &nbsp;&nbsp;&nbsp;`err if err.code() == Some(\"SpecificExceptionCode\") => { /* handle the error */ }`
263     \
264    See [`ProvideErrorMetadata`](#impl-ProvideErrorMetadata-for-AssumeRootError) for what information is available for the error.")]
265                    Unhandled(crate::error::sealed_unhandled::Unhandled),
266}
267impl AssumeRootError {
268    /// Creates the `AssumeRootError::Unhandled` variant from any error type.
269                    pub fn unhandled(err: impl ::std::convert::Into<::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>>) -> Self {
270                        Self::Unhandled(crate::error::sealed_unhandled::Unhandled { source: err.into(), meta: ::std::default::Default::default() })
271                    }
272
273                    /// Creates the `AssumeRootError::Unhandled` variant from an [`ErrorMetadata`](::aws_smithy_types::error::ErrorMetadata).
274                    pub fn generic(err: ::aws_smithy_types::error::ErrorMetadata) -> Self {
275                        Self::Unhandled(crate::error::sealed_unhandled::Unhandled { source: err.clone().into(), meta: err })
276                    }
277    ///
278    /// Returns error metadata, which includes the error code, message,
279    /// request ID, and potentially additional information.
280    ///
281    pub fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
282        match self {
283            Self::ExpiredTokenException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
284            Self::RegionDisabledException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
285            Self::Unhandled(e) => &e.meta,
286        }
287    }
288    /// Returns `true` if the error kind is `AssumeRootError::ExpiredTokenException`.
289    pub fn is_expired_token_exception(&self) -> bool {
290        matches!(self, Self::ExpiredTokenException(_))
291    }
292    /// Returns `true` if the error kind is `AssumeRootError::RegionDisabledException`.
293    pub fn is_region_disabled_exception(&self) -> bool {
294        matches!(self, Self::RegionDisabledException(_))
295    }
296}
297impl ::std::error::Error for AssumeRootError {
298    fn source(&self) -> ::std::option::Option<&(dyn ::std::error::Error + 'static)> {
299        match self {
300            Self::ExpiredTokenException(_inner) =>
301            ::std::option::Option::Some(_inner)
302            ,
303            Self::RegionDisabledException(_inner) =>
304            ::std::option::Option::Some(_inner)
305            ,
306            Self::Unhandled(_inner) => {
307                ::std::option::Option::Some(&*_inner.source)
308            }
309        }
310    }
311}
312impl ::std::fmt::Display for AssumeRootError {
313    fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
314        match self {
315            Self::ExpiredTokenException(_inner) =>
316            _inner.fmt(f)
317            ,
318            Self::RegionDisabledException(_inner) =>
319            _inner.fmt(f)
320            ,
321            Self::Unhandled(_inner) => {
322                if let ::std::option::Option::Some(code) = ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self) {
323                                                        write!(f, "unhandled error ({code})")
324                                                    } else {
325                                                        f.write_str("unhandled error")
326                                                    }
327            }
328        }
329    }
330}
331impl ::aws_smithy_types::retry::ProvideErrorKind for AssumeRootError {
332    fn code(&self) -> ::std::option::Option<&str> {
333        ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self)
334    }
335    fn retryable_error_kind(&self) -> ::std::option::Option<::aws_smithy_types::retry::ErrorKind> {
336        ::std::option::Option::None
337    }
338}
339impl ::aws_smithy_types::error::metadata::ProvideErrorMetadata for AssumeRootError {
340    fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
341        match self {
342            Self::ExpiredTokenException(_inner) =>
343            ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner)
344            ,
345            Self::RegionDisabledException(_inner) =>
346            ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner)
347            ,
348            Self::Unhandled(_inner) => {
349                &_inner.meta
350            }
351        }
352    }
353}
354impl ::aws_smithy_runtime_api::client::result::CreateUnhandledError for AssumeRootError {
355    fn create_unhandled_error(
356                        source: ::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>,
357                        meta: ::std::option::Option<::aws_smithy_types::error::ErrorMetadata>
358                    ) -> Self {
359        Self::Unhandled(crate::error::sealed_unhandled::Unhandled { source, meta: meta.unwrap_or_default() })
360    }
361}
362impl ::aws_types::request_id::RequestId for crate::operation::assume_root::AssumeRootError {
363                                fn request_id(&self) -> Option<&str> {
364                                    self.meta().request_id()
365                                }
366                            }
367
368pub use crate::operation::assume_root::_assume_root_input::AssumeRootInput;
369
370pub use crate::operation::assume_root::_assume_root_output::AssumeRootOutput;
371
372mod _assume_root_input;
373
374mod _assume_root_output;
375
376/// Builders
377pub mod builders;
378
aws_sdk_sts/operation/assume_root.rs

aws_sdk_sts/operation/
assume_root.rs
