aws_sdk_devopsguru/operation/
list_events.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2/// Orchestration and serialization glue logic for `ListEvents`.
3#[derive(::std::clone::Clone, ::std::default::Default, ::std::fmt::Debug)]
4#[non_exhaustive]
5pub struct ListEvents;
6impl ListEvents {
7    /// Creates a new `ListEvents`
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_events::ListEventsInput,
14    ) -> ::std::result::Result<
15        crate::operation::list_events::ListEventsOutput,
16        ::aws_smithy_runtime_api::client::result::SdkError<
17            crate::operation::list_events::ListEventsError,
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_events::ListEventsError>()
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_events::ListEventsOutput>()
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_events::ListEventsInput,
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("DevOps Guru", "ListEvents", 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                "DevOps Guru.ListEvents",
59                "rpc.service" = "DevOps Guru",
60                "rpc.method" = "ListEvents",
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 ListEvents {
88    fn config(&self) -> ::std::option::Option<::aws_smithy_types::config_bag::FrozenLayer> {
89        let mut cfg = ::aws_smithy_types::config_bag::Layer::new("ListEvents");
90
91        cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedRequestSerializer::new(
92            ListEventsRequestSerializer,
93        ));
94        cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedResponseDeserializer::new(
95            ListEventsResponseDeserializer,
96        ));
97
98        cfg.store_put(::aws_smithy_runtime_api::client::auth::AuthSchemeOptionResolverParams::new(
99            crate::config::auth::Params::builder()
100                .operation_name("ListEvents")
101                .build()
102                .expect("required fields set"),
103        ));
104
105        cfg.store_put(::aws_smithy_runtime_api::client::orchestrator::Metadata::new("ListEvents", "DevOps Guru"));
106        let mut signing_options = ::aws_runtime::auth::SigningOptions::default();
107        signing_options.double_uri_encode = true;
108        signing_options.content_sha256_header = false;
109        signing_options.normalize_uri_path = true;
110        signing_options.payload_override = None;
111
112        cfg.store_put(::aws_runtime::auth::SigV4OperationSigningConfig {
113            signing_options,
114            ..::std::default::Default::default()
115        });
116
117        ::std::option::Option::Some(cfg.freeze())
118    }
119
120    fn runtime_components(
121        &self,
122        _: &::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder,
123    ) -> ::std::borrow::Cow<'_, ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder> {
124        #[allow(unused_mut)]
125        let mut rcb = ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder::new("ListEvents")
126            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(
127                ListEventsTelemetryInputCaptureInterceptor,
128            ))
129            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(
130                ::aws_smithy_runtime::client::stalled_stream_protection::StalledStreamProtectionInterceptor::default(),
131            ))
132            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(
133                ListEventsEndpointParamsInterceptor,
134            ))
135            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::TransientErrorClassifier::<
136                crate::operation::list_events::ListEventsError,
137            >::new())
138            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::ModeledAsRetryableClassifier::<
139                crate::operation::list_events::ListEventsError,
140            >::new())
141            .with_retry_classifier(::aws_runtime::retries::classifiers::AwsErrorCodeClassifier::<
142                crate::operation::list_events::ListEventsError,
143            >::new());
144
145        ::std::borrow::Cow::Owned(rcb)
146    }
147}
148
149#[derive(Debug)]
150struct ListEventsTelemetryInputCaptureInterceptor;
151
152#[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
153impl ::aws_smithy_runtime_api::client::interceptors::Intercept for ListEventsTelemetryInputCaptureInterceptor {
154    fn name(&self) -> &'static str {
155        "ListEventsTelemetryInputCaptureInterceptor"
156    }
157
158    fn read_before_execution(
159        &self,
160        context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<
161            '_,
162            ::aws_smithy_runtime_api::client::interceptors::context::Input,
163            ::aws_smithy_runtime_api::client::interceptors::context::Output,
164            ::aws_smithy_runtime_api::client::interceptors::context::Error,
165        >,
166        cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
167    ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
168        // Nothing to do unless the customer opted in by naming members to record.
169        let ::std::option::Option::Some(requested) = cfg
170            .load::<::aws_smithy_types::telemetry::RequestedTelemetryAttributes>()
171            .filter(|r| !r.is_empty())
172        else {
173            return ::std::result::Result::Ok(());
174        };
175
176        let ::std::option::Option::Some(input) = context.input().downcast_ref::<ListEventsInput>() else {
177            // A mismatched input is not this interceptor's concern; skip quietly.
178            return ::std::result::Result::Ok(());
179        };
180
181        let mut captured = ::aws_smithy_types::telemetry::CapturedTelemetryAttributes::default();
182        if requested.should_capture("NextToken") {
183            if let ::std::option::Option::Some(value) = input.next_token.as_deref() {
184                captured.insert("NextToken", value);
185            }
186        }
187        if requested.should_capture("AccountId") {
188            if let ::std::option::Option::Some(value) = input.account_id.as_deref() {
189                captured.insert("AccountId", value);
190            }
191        }
192
193        cfg.interceptor_state().store_put(captured);
194        ::std::result::Result::Ok(())
195    }
196}
197#[derive(Debug)]
198struct ListEventsResponseDeserializer;
199impl ::aws_smithy_runtime_api::client::ser_de::DeserializeResponse for ListEventsResponseDeserializer {
200    fn deserialize_nonstreaming_with_config(
201        &self,
202        response: &::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
203        _cfg: &::aws_smithy_types::config_bag::ConfigBag,
204    ) -> ::aws_smithy_runtime_api::client::interceptors::context::OutputOrError {
205        let (success, status) = (response.status().is_success(), response.status().as_u16());
206        let headers = response.headers();
207        let body = response.body().bytes().expect("body loaded");
208        #[allow(unused_mut)]
209        let mut force_error = false;
210        ::tracing::debug!(request_id = ?::aws_types::request_id::RequestId::request_id(response));
211        let parse_result = if !success && status != 200 || force_error {
212            crate::protocol_serde::shape_list_events::de_list_events_http_error(status, headers, body)
213        } else {
214            crate::protocol_serde::shape_list_events::de_list_events_http_response(status, headers, body)
215        };
216        crate::protocol_serde::type_erase_result(parse_result)
217    }
218}
219#[derive(Debug)]
220struct ListEventsRequestSerializer;
221impl ::aws_smithy_runtime_api::client::ser_de::SerializeRequest for ListEventsRequestSerializer {
222    #[allow(unused_mut, clippy::let_and_return, clippy::needless_borrow, clippy::useless_conversion)]
223    fn serialize_input(
224        &self,
225        input: ::aws_smithy_runtime_api::client::interceptors::context::Input,
226        _cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
227    ) -> ::std::result::Result<::aws_smithy_runtime_api::client::orchestrator::HttpRequest, ::aws_smithy_runtime_api::box_error::BoxError> {
228        let input = input.downcast::<crate::operation::list_events::ListEventsInput>().expect("correct type");
229        let _header_serialization_settings = _cfg
230            .load::<crate::serialization_settings::HeaderSerializationSettings>()
231            .cloned()
232            .unwrap_or_default();
233        let mut request_builder = {
234            #[allow(clippy::uninlined_format_args)]
235            fn uri_base(
236                _input: &crate::operation::list_events::ListEventsInput,
237                output: &mut ::std::string::String,
238            ) -> ::std::result::Result<(), ::aws_smithy_types::error::operation::BuildError> {
239                use ::std::fmt::Write as _;
240                ::std::write!(output, "/events").expect("formatting should succeed");
241                ::std::result::Result::Ok(())
242            }
243            #[allow(clippy::unnecessary_wraps)]
244            fn update_http_builder(
245                input: &crate::operation::list_events::ListEventsInput,
246                builder: ::http_1x::request::Builder,
247            ) -> ::std::result::Result<::http_1x::request::Builder, ::aws_smithy_types::error::operation::BuildError> {
248                let mut uri = ::std::string::String::new();
249                uri_base(input, &mut uri)?;
250                ::std::result::Result::Ok(builder.method("POST").uri(uri))
251            }
252            let mut builder = update_http_builder(&input, ::http_1x::request::Builder::new())?;
253            builder = _header_serialization_settings.set_default_header(builder, ::http_1x::header::CONTENT_TYPE, "application/json");
254            builder
255        };
256        let body = ::aws_smithy_types::body::SdkBody::from(crate::protocol_serde::shape_list_events::ser_list_events_input(&input)?);
257        if let Some(content_length) = body.content_length() {
258            let content_length = content_length.to_string();
259            request_builder = _header_serialization_settings.set_default_header(request_builder, ::http_1x::header::CONTENT_LENGTH, &content_length);
260        }
261        ::std::result::Result::Ok(request_builder.body(body).expect("valid request").try_into().unwrap())
262    }
263}
264#[derive(Debug)]
265struct ListEventsEndpointParamsInterceptor;
266
267#[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
268impl ::aws_smithy_runtime_api::client::interceptors::Intercept for ListEventsEndpointParamsInterceptor {
269    fn name(&self) -> &'static str {
270        "ListEventsEndpointParamsInterceptor"
271    }
272
273    fn read_before_execution(
274        &self,
275        context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<
276            '_,
277            ::aws_smithy_runtime_api::client::interceptors::context::Input,
278            ::aws_smithy_runtime_api::client::interceptors::context::Output,
279            ::aws_smithy_runtime_api::client::interceptors::context::Error,
280        >,
281        cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
282    ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
283        let _input = context
284            .input()
285            .downcast_ref::<ListEventsInput>()
286            .ok_or("failed to downcast to ListEventsInput")?;
287
288        let params = crate::config::endpoint::Params::builder()
289            .set_region(cfg.load::<::aws_types::region::Region>().map(|r| r.as_ref().to_owned()))
290            .set_use_dual_stack(cfg.load::<::aws_types::endpoint_config::UseDualStack>().map(|ty| ty.0))
291            .set_use_fips(cfg.load::<::aws_types::endpoint_config::UseFips>().map(|ty| ty.0))
292            .set_endpoint(cfg.load::<::aws_types::endpoint_config::EndpointUrl>().map(|ty| ty.0.clone()))
293            .build()
294            .map_err(|err| {
295                ::aws_smithy_runtime_api::client::interceptors::error::ContextAttachedError::new("endpoint params could not be built", err)
296            })?;
297        cfg.interceptor_state()
298            .store_put(::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams::new(params));
299        ::std::result::Result::Ok(())
300    }
301}
302
303// The get_* functions below are generated from JMESPath expressions in the
304// operationContextParams trait. They target the operation's input shape.
305
306/// Error type for the `ListEventsError` operation.
307#[non_exhaustive]
308#[derive(::std::fmt::Debug)]
309pub enum ListEventsError {
310    /// <p>You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html">Access Management</a> in the <i>IAM User Guide</i>.</p>
311    AccessDeniedException(crate::types::error::AccessDeniedException),
312    /// <p>An internal failure in an Amazon service occurred.</p>
313    InternalServerException(crate::types::error::InternalServerException),
314    /// <p>A requested resource could not be found</p>
315    ResourceNotFoundException(crate::types::error::ResourceNotFoundException),
316    /// <p>The request was denied due to a request throttling.</p>
317    ThrottlingException(crate::types::error::ThrottlingException),
318    /// <p>Contains information about data passed in to a field during a request that is not valid.</p>
319    ValidationException(crate::types::error::ValidationException),
320    /// An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).
321    #[deprecated(note = "Matching `Unhandled` directly is not forwards compatible. Instead, match using a \
322    variable wildcard pattern and check `.code()`:
323     \
324    &nbsp;&nbsp;&nbsp;`err if err.code() == Some(\"SpecificExceptionCode\") => { /* handle the error */ }`
325     \
326    See [`ProvideErrorMetadata`](#impl-ProvideErrorMetadata-for-ListEventsError) for what information is available for the error.")]
327    Unhandled(crate::error::sealed_unhandled::Unhandled),
328}
329impl ListEventsError {
330    /// Creates the `ListEventsError::Unhandled` variant from any error type.
331    pub fn unhandled(
332        err: impl ::std::convert::Into<::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>>,
333    ) -> Self {
334        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
335            source: err.into(),
336            meta: ::std::default::Default::default(),
337        })
338    }
339
340    /// Creates the `ListEventsError::Unhandled` variant from an [`ErrorMetadata`](::aws_smithy_types::error::ErrorMetadata).
341    pub fn generic(err: ::aws_smithy_types::error::ErrorMetadata) -> Self {
342        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
343            source: err.clone().into(),
344            meta: err,
345        })
346    }
347    ///
348    /// Returns error metadata, which includes the error code, message,
349    /// request ID, and potentially additional information.
350    ///
351    pub fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
352        match self {
353            Self::AccessDeniedException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
354            Self::InternalServerException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
355            Self::ResourceNotFoundException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
356            Self::ThrottlingException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
357            Self::ValidationException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
358            Self::Unhandled(e) => &e.meta,
359        }
360    }
361    /// Returns `true` if the error kind is `ListEventsError::AccessDeniedException`.
362    pub fn is_access_denied_exception(&self) -> bool {
363        matches!(self, Self::AccessDeniedException(_))
364    }
365    /// Returns `true` if the error kind is `ListEventsError::InternalServerException`.
366    pub fn is_internal_server_exception(&self) -> bool {
367        matches!(self, Self::InternalServerException(_))
368    }
369    /// Returns `true` if the error kind is `ListEventsError::ResourceNotFoundException`.
370    pub fn is_resource_not_found_exception(&self) -> bool {
371        matches!(self, Self::ResourceNotFoundException(_))
372    }
373    /// Returns `true` if the error kind is `ListEventsError::ThrottlingException`.
374    pub fn is_throttling_exception(&self) -> bool {
375        matches!(self, Self::ThrottlingException(_))
376    }
377    /// Returns `true` if the error kind is `ListEventsError::ValidationException`.
378    pub fn is_validation_exception(&self) -> bool {
379        matches!(self, Self::ValidationException(_))
380    }
381}
382impl ::std::error::Error for ListEventsError {
383    fn source(&self) -> ::std::option::Option<&(dyn ::std::error::Error + 'static)> {
384        match self {
385            Self::AccessDeniedException(_inner) => ::std::option::Option::Some(_inner),
386            Self::InternalServerException(_inner) => ::std::option::Option::Some(_inner),
387            Self::ResourceNotFoundException(_inner) => ::std::option::Option::Some(_inner),
388            Self::ThrottlingException(_inner) => ::std::option::Option::Some(_inner),
389            Self::ValidationException(_inner) => ::std::option::Option::Some(_inner),
390            Self::Unhandled(_inner) => ::std::option::Option::Some(&*_inner.source),
391        }
392    }
393}
394impl ::std::fmt::Display for ListEventsError {
395    fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
396        match self {
397            Self::AccessDeniedException(_inner) => _inner.fmt(f),
398            Self::InternalServerException(_inner) => _inner.fmt(f),
399            Self::ResourceNotFoundException(_inner) => _inner.fmt(f),
400            Self::ThrottlingException(_inner) => _inner.fmt(f),
401            Self::ValidationException(_inner) => _inner.fmt(f),
402            Self::Unhandled(_inner) => {
403                if let ::std::option::Option::Some(code) = ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self) {
404                    write!(f, "unhandled error ({code})")
405                } else {
406                    f.write_str("unhandled error")
407                }
408            }
409        }
410    }
411}
412impl ::aws_smithy_types::retry::ProvideErrorKind for ListEventsError {
413    fn code(&self) -> ::std::option::Option<&str> {
414        ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self)
415    }
416    fn retryable_error_kind(&self) -> ::std::option::Option<::aws_smithy_types::retry::ErrorKind> {
417        ::std::option::Option::None
418    }
419}
420impl ::aws_smithy_types::error::metadata::ProvideErrorMetadata for ListEventsError {
421    fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
422        match self {
423            Self::AccessDeniedException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
424            Self::InternalServerException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
425            Self::ResourceNotFoundException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
426            Self::ThrottlingException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
427            Self::ValidationException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
428            Self::Unhandled(_inner) => &_inner.meta,
429        }
430    }
431}
432impl ::aws_smithy_runtime_api::client::result::CreateUnhandledError for ListEventsError {
433    fn create_unhandled_error(
434        source: ::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>,
435        meta: ::std::option::Option<::aws_smithy_types::error::ErrorMetadata>,
436    ) -> Self {
437        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
438            source,
439            meta: meta.unwrap_or_default(),
440        })
441    }
442}
443impl ::aws_types::request_id::RequestId for crate::operation::list_events::ListEventsError {
444    fn request_id(&self) -> Option<&str> {
445        self.meta().request_id()
446    }
447}
448
449pub use crate::operation::list_events::_list_events_input::ListEventsInput;
450
451pub use crate::operation::list_events::_list_events_output::ListEventsOutput;
452
453mod _list_events_input;
454
455mod _list_events_output;
456
457/// Builders
458pub mod builders;
459
460/// Paginator for this operation
461pub mod paginator;
aws_sdk_devopsguru/operation/list_events.rs

aws_sdk_devopsguru/operation/
list_events.rs
