aws_sdk_quicksight/operation/
list_template_versions.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2/// Orchestration and serialization glue logic for `ListTemplateVersions`.
3#[derive(::std::clone::Clone, ::std::default::Default, ::std::fmt::Debug)]
4#[non_exhaustive]
5pub struct ListTemplateVersions;
6impl ListTemplateVersions {
7    /// Creates a new `ListTemplateVersions`
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::list_template_versions::ListTemplateVersionsInput,
14    ) -> ::std::result::Result<
15        crate::operation::list_template_versions::ListTemplateVersionsOutput,
16        ::aws_smithy_runtime_api::client::result::SdkError<
17            crate::operation::list_template_versions::ListTemplateVersionsError,
18            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
19        >,
20    > {
21        let map_err = |err: ::aws_smithy_runtime_api::client::result::SdkError<
22            ::aws_smithy_runtime_api::client::interceptors::context::Error,
23            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
24        >| {
25            err.map_service_error(|err| {
26                err.downcast::<crate::operation::list_template_versions::ListTemplateVersionsError>()
27                    .expect("correct error type")
28            })
29        };
30        let context = Self::orchestrate_with_stop_point(runtime_plugins, input, ::aws_smithy_runtime::client::orchestrator::StopPoint::None)
31            .await
32            .map_err(map_err)?;
33        let output = context.finalize().map_err(map_err)?;
34        ::std::result::Result::Ok(
35            output
36                .downcast::<crate::operation::list_template_versions::ListTemplateVersionsOutput>()
37                .expect("correct output type"),
38        )
39    }
40
41    pub(crate) async fn orchestrate_with_stop_point(
42        runtime_plugins: &::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins,
43        input: crate::operation::list_template_versions::ListTemplateVersionsInput,
44        stop_point: ::aws_smithy_runtime::client::orchestrator::StopPoint,
45    ) -> ::std::result::Result<
46        ::aws_smithy_runtime_api::client::interceptors::context::InterceptorContext,
47        ::aws_smithy_runtime_api::client::result::SdkError<
48            ::aws_smithy_runtime_api::client::interceptors::context::Error,
49            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
50        >,
51    > {
52        let input = ::aws_smithy_runtime_api::client::interceptors::context::Input::erase(input);
53        use ::tracing::Instrument;
54        ::aws_smithy_runtime::client::orchestrator::invoke_with_stop_point("QuickSight", "ListTemplateVersions", input, runtime_plugins, stop_point)
55            // Create a parent span for the entire operation. Includes a random, internal-only,
56            // seven-digit ID for the operation orchestration so that it can be correlated in the logs.
57            .instrument(::tracing::debug_span!(
58                "QuickSight.ListTemplateVersions",
59                "rpc.service" = "QuickSight",
60                "rpc.method" = "ListTemplateVersions",
61                "sdk_invocation_id" = ::fastrand::u32(1_000_000..10_000_000),
62                "rpc.system" = "aws-api",
63            ))
64            .await
65    }
66
67    pub(crate) fn operation_runtime_plugins(
68        client_runtime_plugins: ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins,
69        client_config: &crate::config::Config,
70        config_override: ::std::option::Option<crate::config::Builder>,
71    ) -> ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugins {
72        let mut runtime_plugins = client_runtime_plugins.with_operation_plugin(Self::new());
73
74        if let ::std::option::Option::Some(config_override) = config_override {
75            for plugin in config_override.runtime_plugins.iter().cloned() {
76                runtime_plugins = runtime_plugins.with_operation_plugin(plugin);
77            }
78            runtime_plugins = runtime_plugins.with_operation_plugin(crate::config::ConfigOverrideRuntimePlugin::new(
79                config_override,
80                client_config.config.clone(),
81                &client_config.runtime_components,
82            ));
83        }
84        runtime_plugins
85    }
86}
87impl ::aws_smithy_runtime_api::client::runtime_plugin::RuntimePlugin for ListTemplateVersions {
88    fn config(&self) -> ::std::option::Option<::aws_smithy_types::config_bag::FrozenLayer> {
89        let mut cfg = ::aws_smithy_types::config_bag::Layer::new("ListTemplateVersions");
90
91        cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedRequestSerializer::new(
92            ListTemplateVersionsRequestSerializer,
93        ));
94        cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedResponseDeserializer::new(
95            ListTemplateVersionsResponseDeserializer,
96        ));
97
98        cfg.store_put(::aws_smithy_runtime_api::client::auth::AuthSchemeOptionResolverParams::new(
99            crate::config::auth::Params::builder()
100                .operation_name("ListTemplateVersions")
101                .build()
102                .expect("required fields set"),
103        ));
104
105        cfg.store_put(::aws_smithy_runtime_api::client::orchestrator::Metadata::new(
106            "ListTemplateVersions",
107            "QuickSight",
108        ));
109        let mut signing_options = ::aws_runtime::auth::SigningOptions::default();
110        signing_options.double_uri_encode = true;
111        signing_options.content_sha256_header = false;
112        signing_options.normalize_uri_path = true;
113        signing_options.payload_override = None;
114
115        cfg.store_put(::aws_runtime::auth::SigV4OperationSigningConfig {
116            signing_options,
117            ..::std::default::Default::default()
118        });
119
120        ::std::option::Option::Some(cfg.freeze())
121    }
122
123    fn runtime_components(
124        &self,
125        _: &::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder,
126    ) -> ::std::borrow::Cow<'_, ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder> {
127        #[allow(unused_mut)]
128        let mut rcb = ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder::new("ListTemplateVersions")
129            .with_interceptor(::aws_smithy_runtime::client::stalled_stream_protection::StalledStreamProtectionInterceptor::default())
130            .with_interceptor(ListTemplateVersionsEndpointParamsInterceptor)
131            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::TransientErrorClassifier::<
132                crate::operation::list_template_versions::ListTemplateVersionsError,
133            >::new())
134            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::ModeledAsRetryableClassifier::<
135                crate::operation::list_template_versions::ListTemplateVersionsError,
136            >::new())
137            .with_retry_classifier(::aws_runtime::retries::classifiers::AwsErrorCodeClassifier::<
138                crate::operation::list_template_versions::ListTemplateVersionsError,
139            >::new());
140
141        ::std::borrow::Cow::Owned(rcb)
142    }
143}
144
145#[derive(Debug)]
146struct ListTemplateVersionsResponseDeserializer;
147impl ::aws_smithy_runtime_api::client::ser_de::DeserializeResponse for ListTemplateVersionsResponseDeserializer {
148    fn deserialize_nonstreaming(
149        &self,
150        response: &::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
151    ) -> ::aws_smithy_runtime_api::client::interceptors::context::OutputOrError {
152        let (success, status) = (response.status().is_success(), response.status().as_u16());
153        let headers = response.headers();
154        let body = response.body().bytes().expect("body loaded");
155        #[allow(unused_mut)]
156        let mut force_error = false;
157        ::tracing::debug!(request_id = ?::aws_types::request_id::RequestId::request_id(response));
158        let parse_result = if !success && status != 200 || force_error {
159            crate::protocol_serde::shape_list_template_versions::de_list_template_versions_http_error(status, headers, body)
160        } else {
161            crate::protocol_serde::shape_list_template_versions::de_list_template_versions_http_response(status, headers, body)
162        };
163        crate::protocol_serde::type_erase_result(parse_result)
164    }
165}
166#[derive(Debug)]
167struct ListTemplateVersionsRequestSerializer;
168impl ::aws_smithy_runtime_api::client::ser_de::SerializeRequest for ListTemplateVersionsRequestSerializer {
169    #[allow(unused_mut, clippy::let_and_return, clippy::needless_borrow, clippy::useless_conversion)]
170    fn serialize_input(
171        &self,
172        input: ::aws_smithy_runtime_api::client::interceptors::context::Input,
173        _cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
174    ) -> ::std::result::Result<::aws_smithy_runtime_api::client::orchestrator::HttpRequest, ::aws_smithy_runtime_api::box_error::BoxError> {
175        let input = input
176            .downcast::<crate::operation::list_template_versions::ListTemplateVersionsInput>()
177            .expect("correct type");
178        let _header_serialization_settings = _cfg
179            .load::<crate::serialization_settings::HeaderSerializationSettings>()
180            .cloned()
181            .unwrap_or_default();
182        let mut request_builder = {
183            fn uri_base(
184                _input: &crate::operation::list_template_versions::ListTemplateVersionsInput,
185                output: &mut ::std::string::String,
186            ) -> ::std::result::Result<(), ::aws_smithy_types::error::operation::BuildError> {
187                use ::std::fmt::Write as _;
188                let input_1 = &_input.aws_account_id;
189                let input_1 = input_1
190                    .as_ref()
191                    .ok_or_else(|| ::aws_smithy_types::error::operation::BuildError::missing_field("aws_account_id", "cannot be empty or unset"))?;
192                let aws_account_id = ::aws_smithy_http::label::fmt_string(input_1, ::aws_smithy_http::label::EncodingStrategy::Default);
193                if aws_account_id.is_empty() {
194                    return ::std::result::Result::Err(::aws_smithy_types::error::operation::BuildError::missing_field(
195                        "aws_account_id",
196                        "cannot be empty or unset",
197                    ));
198                }
199                let input_2 = &_input.template_id;
200                let input_2 = input_2
201                    .as_ref()
202                    .ok_or_else(|| ::aws_smithy_types::error::operation::BuildError::missing_field("template_id", "cannot be empty or unset"))?;
203                let template_id = ::aws_smithy_http::label::fmt_string(input_2, ::aws_smithy_http::label::EncodingStrategy::Default);
204                if template_id.is_empty() {
205                    return ::std::result::Result::Err(::aws_smithy_types::error::operation::BuildError::missing_field(
206                        "template_id",
207                        "cannot be empty or unset",
208                    ));
209                }
210                ::std::write!(
211                    output,
212                    "/accounts/{AwsAccountId}/templates/{TemplateId}/versions",
213                    AwsAccountId = aws_account_id,
214                    TemplateId = template_id
215                )
216                .expect("formatting should succeed");
217                ::std::result::Result::Ok(())
218            }
219            fn uri_query(
220                _input: &crate::operation::list_template_versions::ListTemplateVersionsInput,
221                mut output: &mut ::std::string::String,
222            ) -> ::std::result::Result<(), ::aws_smithy_types::error::operation::BuildError> {
223                let mut query = ::aws_smithy_http::query::Writer::new(output);
224                if let ::std::option::Option::Some(inner_3) = &_input.next_token {
225                    {
226                        query.push_kv("next-token", &::aws_smithy_http::query::fmt_string(inner_3));
227                    }
228                }
229                if let ::std::option::Option::Some(inner_4) = &_input.max_results {
230                    {
231                        query.push_kv("max-results", ::aws_smithy_types::primitive::Encoder::from(*inner_4).encode());
232                    }
233                }
234                ::std::result::Result::Ok(())
235            }
236            #[allow(clippy::unnecessary_wraps)]
237            fn update_http_builder(
238                input: &crate::operation::list_template_versions::ListTemplateVersionsInput,
239                builder: ::http::request::Builder,
240            ) -> ::std::result::Result<::http::request::Builder, ::aws_smithy_types::error::operation::BuildError> {
241                let mut uri = ::std::string::String::new();
242                uri_base(input, &mut uri)?;
243                uri_query(input, &mut uri)?;
244                ::std::result::Result::Ok(builder.method("GET").uri(uri))
245            }
246            let mut builder = update_http_builder(&input, ::http::request::Builder::new())?;
247            builder
248        };
249        let body = ::aws_smithy_types::body::SdkBody::from("");
250
251        ::std::result::Result::Ok(request_builder.body(body).expect("valid request").try_into().unwrap())
252    }
253}
254#[derive(Debug)]
255struct ListTemplateVersionsEndpointParamsInterceptor;
256
257impl ::aws_smithy_runtime_api::client::interceptors::Intercept for ListTemplateVersionsEndpointParamsInterceptor {
258    fn name(&self) -> &'static str {
259        "ListTemplateVersionsEndpointParamsInterceptor"
260    }
261
262    fn read_before_execution(
263        &self,
264        context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<
265            '_,
266            ::aws_smithy_runtime_api::client::interceptors::context::Input,
267            ::aws_smithy_runtime_api::client::interceptors::context::Output,
268            ::aws_smithy_runtime_api::client::interceptors::context::Error,
269        >,
270        cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
271    ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
272        let _input = context
273            .input()
274            .downcast_ref::<ListTemplateVersionsInput>()
275            .ok_or("failed to downcast to ListTemplateVersionsInput")?;
276
277        let params = crate::config::endpoint::Params::builder()
278            .set_region(cfg.load::<::aws_types::region::Region>().map(|r| r.as_ref().to_owned()))
279            .set_use_dual_stack(cfg.load::<::aws_types::endpoint_config::UseDualStack>().map(|ty| ty.0))
280            .set_use_fips(cfg.load::<::aws_types::endpoint_config::UseFips>().map(|ty| ty.0))
281            .set_endpoint(cfg.load::<::aws_types::endpoint_config::EndpointUrl>().map(|ty| ty.0.clone()))
282            .build()
283            .map_err(|err| {
284                ::aws_smithy_runtime_api::client::interceptors::error::ContextAttachedError::new("endpoint params could not be built", err)
285            })?;
286        cfg.interceptor_state()
287            .store_put(::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams::new(params));
288        ::std::result::Result::Ok(())
289    }
290}
291
292// The get_* functions below are generated from JMESPath expressions in the
293// operationContextParams trait. They target the operation's input shape.
294
295/// Error type for the `ListTemplateVersionsError` operation.
296#[non_exhaustive]
297#[derive(::std::fmt::Debug)]
298pub enum ListTemplateVersionsError {
299    /// <p>An internal failure occurred.</p>
300    InternalFailureException(crate::types::error::InternalFailureException),
301    /// <p>The <code>NextToken</code> value isn't valid.</p>
302    InvalidNextTokenException(crate::types::error::InvalidNextTokenException),
303    /// <p>One or more parameters has a value that isn't valid.</p>
304    InvalidParameterValueException(crate::types::error::InvalidParameterValueException),
305    /// <p>One or more resources can't be found.</p>
306    ResourceNotFoundException(crate::types::error::ResourceNotFoundException),
307    /// <p>Access is throttled.</p>
308    ThrottlingException(crate::types::error::ThrottlingException),
309    /// <p>This error indicates that you are calling an operation on an Amazon QuickSight subscription where the edition doesn't include support for that operation. Amazon Amazon QuickSight currently has Standard Edition and Enterprise Edition. Not every operation and capability is available in every edition.</p>
310    UnsupportedUserEditionException(crate::types::error::UnsupportedUserEditionException),
311    /// An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).
312    #[deprecated(note = "Matching `Unhandled` directly is not forwards compatible. Instead, match using a \
313    variable wildcard pattern and check `.code()`:
314     \
315    &nbsp;&nbsp;&nbsp;`err if err.code() == Some(\"SpecificExceptionCode\") => { /* handle the error */ }`
316     \
317    See [`ProvideErrorMetadata`](#impl-ProvideErrorMetadata-for-ListTemplateVersionsError) for what information is available for the error.")]
318    Unhandled(crate::error::sealed_unhandled::Unhandled),
319}
320impl ListTemplateVersionsError {
321    /// Creates the `ListTemplateVersionsError::Unhandled` variant from any error type.
322    pub fn unhandled(
323        err: impl ::std::convert::Into<::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>>,
324    ) -> Self {
325        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
326            source: err.into(),
327            meta: ::std::default::Default::default(),
328        })
329    }
330
331    /// Creates the `ListTemplateVersionsError::Unhandled` variant from an [`ErrorMetadata`](::aws_smithy_types::error::ErrorMetadata).
332    pub fn generic(err: ::aws_smithy_types::error::ErrorMetadata) -> Self {
333        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
334            source: err.clone().into(),
335            meta: err,
336        })
337    }
338    ///
339    /// Returns error metadata, which includes the error code, message,
340    /// request ID, and potentially additional information.
341    ///
342    pub fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
343        match self {
344            Self::InternalFailureException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
345            Self::InvalidNextTokenException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
346            Self::InvalidParameterValueException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
347            Self::ResourceNotFoundException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
348            Self::ThrottlingException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
349            Self::UnsupportedUserEditionException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
350            Self::Unhandled(e) => &e.meta,
351        }
352    }
353    /// Returns `true` if the error kind is `ListTemplateVersionsError::InternalFailureException`.
354    pub fn is_internal_failure_exception(&self) -> bool {
355        matches!(self, Self::InternalFailureException(_))
356    }
357    /// Returns `true` if the error kind is `ListTemplateVersionsError::InvalidNextTokenException`.
358    pub fn is_invalid_next_token_exception(&self) -> bool {
359        matches!(self, Self::InvalidNextTokenException(_))
360    }
361    /// Returns `true` if the error kind is `ListTemplateVersionsError::InvalidParameterValueException`.
362    pub fn is_invalid_parameter_value_exception(&self) -> bool {
363        matches!(self, Self::InvalidParameterValueException(_))
364    }
365    /// Returns `true` if the error kind is `ListTemplateVersionsError::ResourceNotFoundException`.
366    pub fn is_resource_not_found_exception(&self) -> bool {
367        matches!(self, Self::ResourceNotFoundException(_))
368    }
369    /// Returns `true` if the error kind is `ListTemplateVersionsError::ThrottlingException`.
370    pub fn is_throttling_exception(&self) -> bool {
371        matches!(self, Self::ThrottlingException(_))
372    }
373    /// Returns `true` if the error kind is `ListTemplateVersionsError::UnsupportedUserEditionException`.
374    pub fn is_unsupported_user_edition_exception(&self) -> bool {
375        matches!(self, Self::UnsupportedUserEditionException(_))
376    }
377}
378impl ::std::error::Error for ListTemplateVersionsError {
379    fn source(&self) -> ::std::option::Option<&(dyn ::std::error::Error + 'static)> {
380        match self {
381            Self::InternalFailureException(_inner) => ::std::option::Option::Some(_inner),
382            Self::InvalidNextTokenException(_inner) => ::std::option::Option::Some(_inner),
383            Self::InvalidParameterValueException(_inner) => ::std::option::Option::Some(_inner),
384            Self::ResourceNotFoundException(_inner) => ::std::option::Option::Some(_inner),
385            Self::ThrottlingException(_inner) => ::std::option::Option::Some(_inner),
386            Self::UnsupportedUserEditionException(_inner) => ::std::option::Option::Some(_inner),
387            Self::Unhandled(_inner) => ::std::option::Option::Some(&*_inner.source),
388        }
389    }
390}
391impl ::std::fmt::Display for ListTemplateVersionsError {
392    fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
393        match self {
394            Self::InternalFailureException(_inner) => _inner.fmt(f),
395            Self::InvalidNextTokenException(_inner) => _inner.fmt(f),
396            Self::InvalidParameterValueException(_inner) => _inner.fmt(f),
397            Self::ResourceNotFoundException(_inner) => _inner.fmt(f),
398            Self::ThrottlingException(_inner) => _inner.fmt(f),
399            Self::UnsupportedUserEditionException(_inner) => _inner.fmt(f),
400            Self::Unhandled(_inner) => {
401                if let ::std::option::Option::Some(code) = ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self) {
402                    write!(f, "unhandled error ({code})")
403                } else {
404                    f.write_str("unhandled error")
405                }
406            }
407        }
408    }
409}
410impl ::aws_smithy_types::retry::ProvideErrorKind for ListTemplateVersionsError {
411    fn code(&self) -> ::std::option::Option<&str> {
412        ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self)
413    }
414    fn retryable_error_kind(&self) -> ::std::option::Option<::aws_smithy_types::retry::ErrorKind> {
415        ::std::option::Option::None
416    }
417}
418impl ::aws_smithy_types::error::metadata::ProvideErrorMetadata for ListTemplateVersionsError {
419    fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
420        match self {
421            Self::InternalFailureException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
422            Self::InvalidNextTokenException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
423            Self::InvalidParameterValueException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
424            Self::ResourceNotFoundException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
425            Self::ThrottlingException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
426            Self::UnsupportedUserEditionException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
427            Self::Unhandled(_inner) => &_inner.meta,
428        }
429    }
430}
431impl ::aws_smithy_runtime_api::client::result::CreateUnhandledError for ListTemplateVersionsError {
432    fn create_unhandled_error(
433        source: ::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>,
434        meta: ::std::option::Option<::aws_smithy_types::error::ErrorMetadata>,
435    ) -> Self {
436        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
437            source,
438            meta: meta.unwrap_or_default(),
439        })
440    }
441}
442impl ::aws_types::request_id::RequestId for crate::operation::list_template_versions::ListTemplateVersionsError {
443    fn request_id(&self) -> Option<&str> {
444        self.meta().request_id()
445    }
446}
447
448pub use crate::operation::list_template_versions::_list_template_versions_output::ListTemplateVersionsOutput;
449
450pub use crate::operation::list_template_versions::_list_template_versions_input::ListTemplateVersionsInput;
451
452mod _list_template_versions_input;
453
454mod _list_template_versions_output;
455
456/// Builders
457pub mod builders;
458
459/// Paginator for this operation
460pub mod paginator;