Skip to main content

aws_sdk_rds/operation/
modify_db_cluster.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2/// Orchestration and serialization glue logic for `ModifyDBCluster`.
3#[derive(::std::clone::Clone, ::std::default::Default, ::std::fmt::Debug)]
4#[non_exhaustive]
5pub struct ModifyDBCluster;
6impl ModifyDBCluster {
7    /// Creates a new `ModifyDBCluster`
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::modify_db_cluster::ModifyDbClusterInput,
14    ) -> ::std::result::Result<
15        crate::operation::modify_db_cluster::ModifyDbClusterOutput,
16        ::aws_smithy_runtime_api::client::result::SdkError<
17            crate::operation::modify_db_cluster::ModifyDBClusterError,
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::modify_db_cluster::ModifyDBClusterError>()
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::modify_db_cluster::ModifyDbClusterOutput>()
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::modify_db_cluster::ModifyDbClusterInput,
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("RDS", "ModifyDBCluster", 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                "RDS.ModifyDBCluster",
59                "rpc.service" = "RDS",
60                "rpc.method" = "ModifyDBCluster",
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 ModifyDBCluster {
88    fn config(&self) -> ::std::option::Option<::aws_smithy_types::config_bag::FrozenLayer> {
89        let mut cfg = ::aws_smithy_types::config_bag::Layer::new("ModifyDBCluster");
90
91        cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedRequestSerializer::new(
92            ModifyDBClusterRequestSerializer,
93        ));
94        cfg.store_put(::aws_smithy_runtime_api::client::ser_de::SharedResponseDeserializer::new(
95            ModifyDBClusterResponseDeserializer,
96        ));
97
98        cfg.store_put(::aws_smithy_runtime_api::client::auth::AuthSchemeOptionResolverParams::new(
99            crate::config::auth::Params::builder()
100                .operation_name("ModifyDBCluster")
101                .build()
102                .expect("required fields set"),
103        ));
104
105        cfg.store_put(::aws_smithy_runtime_api::client::orchestrator::SensitiveOutput);
106        cfg.store_put(::aws_smithy_runtime_api::client::orchestrator::Metadata::new("ModifyDBCluster", "RDS"));
107        let mut signing_options = ::aws_runtime::auth::SigningOptions::default();
108        signing_options.double_uri_encode = true;
109        signing_options.content_sha256_header = false;
110        signing_options.normalize_uri_path = true;
111        signing_options.payload_override = None;
112
113        cfg.store_put(::aws_runtime::auth::SigV4OperationSigningConfig {
114            signing_options,
115            ..::std::default::Default::default()
116        });
117
118        ::std::option::Option::Some(cfg.freeze())
119    }
120
121    fn runtime_components(
122        &self,
123        _: &::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder,
124    ) -> ::std::borrow::Cow<'_, ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder> {
125        #[allow(unused_mut)]
126        let mut rcb = ::aws_smithy_runtime_api::client::runtime_components::RuntimeComponentsBuilder::new("ModifyDBCluster")
127            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(
128                ModifyDBClusterTelemetryInputCaptureInterceptor,
129            ))
130            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(
131                ::aws_smithy_runtime::client::stalled_stream_protection::StalledStreamProtectionInterceptor::default(),
132            ))
133            .with_interceptor(::aws_smithy_runtime_api::client::interceptors::SharedInterceptor::permanent(
134                ModifyDBClusterEndpointParamsInterceptor,
135            ))
136            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::TransientErrorClassifier::<
137                crate::operation::modify_db_cluster::ModifyDBClusterError,
138            >::new())
139            .with_retry_classifier(::aws_smithy_runtime::client::retries::classifiers::ModeledAsRetryableClassifier::<
140                crate::operation::modify_db_cluster::ModifyDBClusterError,
141            >::new())
142            .with_retry_classifier(::aws_runtime::retries::classifiers::AwsErrorCodeClassifier::<
143                crate::operation::modify_db_cluster::ModifyDBClusterError,
144            >::new())
145            .with_retry_classifier(::aws_runtime::service_clock_skew::ServiceClockSkewClassifier::<
146                crate::operation::modify_db_cluster::ModifyDBClusterError,
147            >::new());
148
149        ::std::borrow::Cow::Owned(rcb)
150    }
151}
152
153#[derive(Debug)]
154struct ModifyDBClusterTelemetryInputCaptureInterceptor;
155
156#[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
157impl ::aws_smithy_runtime_api::client::interceptors::Intercept for ModifyDBClusterTelemetryInputCaptureInterceptor {
158    fn name(&self) -> &'static str {
159        "ModifyDBClusterTelemetryInputCaptureInterceptor"
160    }
161
162    fn read_before_execution(
163        &self,
164        context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<
165            '_,
166            ::aws_smithy_runtime_api::client::interceptors::context::Input,
167            ::aws_smithy_runtime_api::client::interceptors::context::Output,
168            ::aws_smithy_runtime_api::client::interceptors::context::Error,
169        >,
170        cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
171    ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
172        // Nothing to do unless the customer opted in by naming members to record.
173        let ::std::option::Option::Some(requested) = cfg
174            .load::<::aws_smithy_types::telemetry::RequestedTelemetryAttributes>()
175            .filter(|r| !r.is_empty())
176        else {
177            return ::std::result::Result::Ok(());
178        };
179
180        let ::std::option::Option::Some(input) = context.input().downcast_ref::<ModifyDbClusterInput>() else {
181            // A mismatched input is not this interceptor's concern; skip quietly.
182            return ::std::result::Result::Ok(());
183        };
184
185        let mut captured = ::aws_smithy_types::telemetry::CapturedTelemetryAttributes::default();
186        if requested.should_capture("DBClusterIdentifier") {
187            if let ::std::option::Option::Some(value) = input.db_cluster_identifier.as_deref() {
188                captured.insert("DBClusterIdentifier", value);
189            }
190        }
191        if requested.should_capture("NewDBClusterIdentifier") {
192            if let ::std::option::Option::Some(value) = input.new_db_cluster_identifier.as_deref() {
193                captured.insert("NewDBClusterIdentifier", value);
194            }
195        }
196        if requested.should_capture("DBClusterParameterGroupName") {
197            if let ::std::option::Option::Some(value) = input.db_cluster_parameter_group_name.as_deref() {
198                captured.insert("DBClusterParameterGroupName", value);
199            }
200        }
201        if requested.should_capture("OptionGroupName") {
202            if let ::std::option::Option::Some(value) = input.option_group_name.as_deref() {
203                captured.insert("OptionGroupName", value);
204            }
205        }
206        if requested.should_capture("PreferredBackupWindow") {
207            if let ::std::option::Option::Some(value) = input.preferred_backup_window.as_deref() {
208                captured.insert("PreferredBackupWindow", value);
209            }
210        }
211        if requested.should_capture("PreferredMaintenanceWindow") {
212            if let ::std::option::Option::Some(value) = input.preferred_maintenance_window.as_deref() {
213                captured.insert("PreferredMaintenanceWindow", value);
214            }
215        }
216        if requested.should_capture("EngineVersion") {
217            if let ::std::option::Option::Some(value) = input.engine_version.as_deref() {
218                captured.insert("EngineVersion", value);
219            }
220        }
221        if requested.should_capture("DBInstanceParameterGroupName") {
222            if let ::std::option::Option::Some(value) = input.db_instance_parameter_group_name.as_deref() {
223                captured.insert("DBInstanceParameterGroupName", value);
224            }
225        }
226        if requested.should_capture("Domain") {
227            if let ::std::option::Option::Some(value) = input.domain.as_deref() {
228                captured.insert("Domain", value);
229            }
230        }
231        if requested.should_capture("DomainIAMRoleName") {
232            if let ::std::option::Option::Some(value) = input.domain_iam_role_name.as_deref() {
233                captured.insert("DomainIAMRoleName", value);
234            }
235        }
236        if requested.should_capture("DBClusterInstanceClass") {
237            if let ::std::option::Option::Some(value) = input.db_cluster_instance_class.as_deref() {
238                captured.insert("DBClusterInstanceClass", value);
239            }
240        }
241        if requested.should_capture("StorageType") {
242            if let ::std::option::Option::Some(value) = input.storage_type.as_deref() {
243                captured.insert("StorageType", value);
244            }
245        }
246        if requested.should_capture("NetworkType") {
247            if let ::std::option::Option::Some(value) = input.network_type.as_deref() {
248                captured.insert("NetworkType", value);
249            }
250        }
251        if requested.should_capture("MonitoringRoleArn") {
252            if let ::std::option::Option::Some(value) = input.monitoring_role_arn.as_deref() {
253                captured.insert("MonitoringRoleArn", value);
254            }
255        }
256        if requested.should_capture("PerformanceInsightsKMSKeyId") {
257            if let ::std::option::Option::Some(value) = input.performance_insights_kms_key_id.as_deref() {
258                captured.insert("PerformanceInsightsKMSKeyId", value);
259            }
260        }
261        if requested.should_capture("MasterUserSecretKmsKeyId") {
262            if let ::std::option::Option::Some(value) = input.master_user_secret_kms_key_id.as_deref() {
263                captured.insert("MasterUserSecretKmsKeyId", value);
264            }
265        }
266        if requested.should_capture("EngineMode") {
267            if let ::std::option::Option::Some(value) = input.engine_mode.as_deref() {
268                captured.insert("EngineMode", value);
269            }
270        }
271        if requested.should_capture("AwsBackupRecoveryPointArn") {
272            if let ::std::option::Option::Some(value) = input.aws_backup_recovery_point_arn.as_deref() {
273                captured.insert("AwsBackupRecoveryPointArn", value);
274            }
275        }
276        if requested.should_capture("CACertificateIdentifier") {
277            if let ::std::option::Option::Some(value) = input.ca_certificate_identifier.as_deref() {
278                captured.insert("CACertificateIdentifier", value);
279            }
280        }
281        if requested.should_capture("EngineLifecycleSupport") {
282            if let ::std::option::Option::Some(value) = input.engine_lifecycle_support.as_deref() {
283                captured.insert("EngineLifecycleSupport", value);
284            }
285        }
286
287        cfg.interceptor_state().store_put(captured);
288        ::std::result::Result::Ok(())
289    }
290}
291#[derive(Debug)]
292struct ModifyDBClusterResponseDeserializer;
293impl ::aws_smithy_runtime_api::client::ser_de::DeserializeResponse for ModifyDBClusterResponseDeserializer {
294    fn deserialize_nonstreaming_with_config(
295        &self,
296        response: &::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
297        _cfg: &::aws_smithy_types::config_bag::ConfigBag,
298    ) -> ::aws_smithy_runtime_api::client::interceptors::context::OutputOrError {
299        let (success, status) = (response.status().is_success(), response.status().as_u16());
300        let headers = response.headers();
301        let body = response.body().bytes().expect("body loaded");
302        #[allow(unused_mut)]
303        let mut force_error = false;
304        ::tracing::debug!(request_id = ?::aws_types::request_id::RequestId::request_id(response));
305        let parse_result = if !success && status != 200 || force_error {
306            crate::protocol_serde::shape_modify_db_cluster::de_modify_db_cluster_http_error(status, headers, body)
307        } else {
308            crate::protocol_serde::shape_modify_db_cluster::de_modify_db_cluster_http_response(status, headers, body)
309        };
310        crate::protocol_serde::type_erase_result(parse_result)
311    }
312}
313#[derive(Debug)]
314struct ModifyDBClusterRequestSerializer;
315impl ::aws_smithy_runtime_api::client::ser_de::SerializeRequest for ModifyDBClusterRequestSerializer {
316    #[allow(unused_mut, clippy::let_and_return, clippy::needless_borrow, clippy::useless_conversion)]
317    fn serialize_input(
318        &self,
319        input: ::aws_smithy_runtime_api::client::interceptors::context::Input,
320        _cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
321    ) -> ::std::result::Result<::aws_smithy_runtime_api::client::orchestrator::HttpRequest, ::aws_smithy_runtime_api::box_error::BoxError> {
322        let input = input
323            .downcast::<crate::operation::modify_db_cluster::ModifyDbClusterInput>()
324            .expect("correct type");
325        let _header_serialization_settings = _cfg
326            .load::<crate::serialization_settings::HeaderSerializationSettings>()
327            .cloned()
328            .unwrap_or_default();
329        let mut request_builder = {
330            #[allow(clippy::uninlined_format_args)]
331            fn uri_base(
332                _input: &crate::operation::modify_db_cluster::ModifyDbClusterInput,
333                output: &mut ::std::string::String,
334            ) -> ::std::result::Result<(), ::aws_smithy_types::error::operation::BuildError> {
335                use ::std::fmt::Write as _;
336                ::std::write!(output, "/").expect("formatting should succeed");
337                ::std::result::Result::Ok(())
338            }
339            #[allow(clippy::unnecessary_wraps)]
340            fn update_http_builder(
341                input: &crate::operation::modify_db_cluster::ModifyDbClusterInput,
342                builder: ::http_1x::request::Builder,
343            ) -> ::std::result::Result<::http_1x::request::Builder, ::aws_smithy_types::error::operation::BuildError> {
344                let mut uri = ::std::string::String::new();
345                uri_base(input, &mut uri)?;
346                ::std::result::Result::Ok(builder.method("POST").uri(uri))
347            }
348            let mut builder = update_http_builder(&input, ::http_1x::request::Builder::new())?;
349            builder =
350                _header_serialization_settings.set_default_header(builder, ::http_1x::header::CONTENT_TYPE, "application/x-www-form-urlencoded");
351            builder
352        };
353        let body = ::aws_smithy_types::body::SdkBody::from(
354            crate::protocol_serde::shape_modify_db_cluster_input::ser_modify_db_cluster_input_input_input(&input)?,
355        );
356        if let Some(content_length) = body.content_length() {
357            let content_length = content_length.to_string();
358            request_builder = _header_serialization_settings.set_default_header(request_builder, ::http_1x::header::CONTENT_LENGTH, &content_length);
359        }
360        ::std::result::Result::Ok(request_builder.body(body).expect("valid request").try_into().unwrap())
361    }
362}
363#[derive(Debug)]
364struct ModifyDBClusterEndpointParamsInterceptor;
365
366#[::aws_smithy_runtime_api::client::interceptors::dyn_dispatch_hint]
367impl ::aws_smithy_runtime_api::client::interceptors::Intercept for ModifyDBClusterEndpointParamsInterceptor {
368    fn name(&self) -> &'static str {
369        "ModifyDBClusterEndpointParamsInterceptor"
370    }
371
372    fn read_before_execution(
373        &self,
374        context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<
375            '_,
376            ::aws_smithy_runtime_api::client::interceptors::context::Input,
377            ::aws_smithy_runtime_api::client::interceptors::context::Output,
378            ::aws_smithy_runtime_api::client::interceptors::context::Error,
379        >,
380        cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
381    ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
382        let _input = context
383            .input()
384            .downcast_ref::<ModifyDbClusterInput>()
385            .ok_or("failed to downcast to ModifyDbClusterInput")?;
386
387        let params = crate::config::endpoint::Params::builder()
388            .set_region(cfg.load::<::aws_types::region::Region>().map(|r| r.as_ref().to_owned()))
389            .set_use_dual_stack(cfg.load::<::aws_types::endpoint_config::UseDualStack>().map(|ty| ty.0))
390            .set_use_fips(cfg.load::<::aws_types::endpoint_config::UseFips>().map(|ty| ty.0))
391            .set_endpoint(cfg.load::<::aws_types::endpoint_config::EndpointUrl>().map(|ty| ty.0.clone()))
392            .build()
393            .map_err(|err| {
394                ::aws_smithy_runtime_api::client::interceptors::error::ContextAttachedError::new("endpoint params could not be built", err)
395            })?;
396        cfg.interceptor_state()
397            .store_put(::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams::new(params));
398        ::std::result::Result::Ok(())
399    }
400}
401
402// The get_* functions below are generated from JMESPath expressions in the
403// operationContextParams trait. They target the operation's input shape.
404
405/// Error type for the `ModifyDBClusterError` operation.
406#[non_exhaustive]
407#[derive(::std::fmt::Debug)]
408pub enum ModifyDBClusterError {
409    /// <p>The user already has a DB cluster with the given identifier.</p>
410    DbClusterAlreadyExistsFault(crate::types::error::DbClusterAlreadyExistsFault),
411    /// <p><code>DBClusterIdentifier</code> doesn't refer to an existing DB cluster.</p>
412    DbClusterNotFoundFault(crate::types::error::DbClusterNotFoundFault),
413    /// <p><code>DBClusterParameterGroupName</code> doesn't refer to an existing DB cluster parameter group.</p>
414    DbClusterParameterGroupNotFoundFault(crate::types::error::DbClusterParameterGroupNotFoundFault),
415    /// <p>The user already has a DB instance with the given identifier.</p>
416    DbInstanceAlreadyExistsFault(crate::types::error::DbInstanceAlreadyExistsFault),
417    /// <p><code>DBParameterGroupName</code> doesn't refer to an existing DB parameter group.</p>
418    DbParameterGroupNotFoundFault(crate::types::error::DbParameterGroupNotFoundFault),
419    /// <p><code>DBSubnetGroupName</code> doesn't refer to an existing DB subnet group.</p>
420    DbSubnetGroupNotFoundFault(crate::types::error::DbSubnetGroupNotFoundFault),
421    /// <p><code>Domain</code> doesn't refer to an existing Active Directory domain.</p>
422    DomainNotFoundFault(crate::types::error::DomainNotFoundFault),
423    /// <p>The requested operation can't be performed while the cluster is in this state.</p>
424    InvalidDbClusterStateFault(crate::types::error::InvalidDbClusterStateFault),
425    /// <p>The DB instance isn't in a valid state.</p>
426    InvalidDbInstanceStateFault(crate::types::error::InvalidDbInstanceStateFault),
427    /// <p>The state of the DB security group doesn't allow deletion.</p>
428    InvalidDbSecurityGroupStateFault(crate::types::error::InvalidDbSecurityGroupStateFault),
429    /// <p>The DB subnet group cannot be deleted because it's in use.</p>
430    InvalidDbSubnetGroupStateFault(crate::types::error::InvalidDbSubnetGroupStateFault),
431    /// <p>The global cluster is in an invalid state and can't perform the requested operation.</p>
432    InvalidGlobalClusterStateFault(crate::types::error::InvalidGlobalClusterStateFault),
433    /// <p>The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.</p>
434    InvalidSubnet(crate::types::error::InvalidSubnet),
435    /// <p>The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.</p>
436    InvalidVpcNetworkStateFault(crate::types::error::InvalidVpcNetworkStateFault),
437    /// <p>An error occurred accessing an Amazon Web Services KMS key.</p>
438    KmsKeyNotAccessibleFault(crate::types::error::KmsKeyNotAccessibleFault),
439    /// <p>The network type is invalid for the DB instance. Valid nework type values are <code>IPV4</code> and <code>DUAL</code>.</p>
440    NetworkTypeNotSupported(crate::types::error::NetworkTypeNotSupported),
441    /// <p>The specified option group could not be found.</p>
442    OptionGroupNotFoundFault(crate::types::error::OptionGroupNotFoundFault),
443    /// <p>The request would result in the user exceeding the allowed amount of storage available across all DB instances.</p>
444    StorageQuotaExceededFault(crate::types::error::StorageQuotaExceededFault),
445    /// <p>The <code>aurora-iopt1</code> storage type isn't available, because you modified the DB cluster to use this storage type less than one month ago.</p>
446    StorageTypeNotAvailableFault(crate::types::error::StorageTypeNotAvailableFault),
447    /// <p>The specified <code>StorageType</code> can't be associated with the DB instance.</p>
448    StorageTypeNotSupportedFault(crate::types::error::StorageTypeNotSupportedFault),
449    /// <p>The operation violates VPC encryption control settings. Make sure that your DB instance type supports the Nitro encryption-in-transit capability, or modify your VPC's encryption controls to not enforce encryption-in-transit.</p>
450    VpcEncryptionControlViolationException(crate::types::error::VpcEncryptionControlViolationException),
451    /// An unexpected error occurred (e.g., invalid JSON returned by the service or an unknown error code).
452    #[deprecated(note = "Matching `Unhandled` directly is not forwards compatible. Instead, match using a \
453    variable wildcard pattern and check `.code()`:
454     \
455    &nbsp;&nbsp;&nbsp;`err if err.code() == Some(\"SpecificExceptionCode\") => { /* handle the error */ }`
456     \
457    See [`ProvideErrorMetadata`](#impl-ProvideErrorMetadata-for-ModifyDBClusterError) for what information is available for the error.")]
458    Unhandled(crate::error::sealed_unhandled::Unhandled),
459}
460impl ModifyDBClusterError {
461    /// Creates the `ModifyDBClusterError::Unhandled` variant from any error type.
462    pub fn unhandled(
463        err: impl ::std::convert::Into<::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>>,
464    ) -> Self {
465        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
466            source: err.into(),
467            meta: ::std::default::Default::default(),
468        })
469    }
470
471    /// Creates the `ModifyDBClusterError::Unhandled` variant from an [`ErrorMetadata`](::aws_smithy_types::error::ErrorMetadata).
472    pub fn generic(err: ::aws_smithy_types::error::ErrorMetadata) -> Self {
473        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
474            source: err.clone().into(),
475            meta: err,
476        })
477    }
478    ///
479    /// Returns error metadata, which includes the error code, message,
480    /// request ID, and potentially additional information.
481    ///
482    pub fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
483        match self {
484            Self::DbClusterAlreadyExistsFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
485            Self::DbClusterNotFoundFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
486            Self::DbClusterParameterGroupNotFoundFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
487            Self::DbInstanceAlreadyExistsFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
488            Self::DbParameterGroupNotFoundFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
489            Self::DbSubnetGroupNotFoundFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
490            Self::DomainNotFoundFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
491            Self::InvalidDbClusterStateFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
492            Self::InvalidDbInstanceStateFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
493            Self::InvalidDbSecurityGroupStateFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
494            Self::InvalidDbSubnetGroupStateFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
495            Self::InvalidGlobalClusterStateFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
496            Self::InvalidSubnet(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
497            Self::InvalidVpcNetworkStateFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
498            Self::KmsKeyNotAccessibleFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
499            Self::NetworkTypeNotSupported(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
500            Self::OptionGroupNotFoundFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
501            Self::StorageQuotaExceededFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
502            Self::StorageTypeNotAvailableFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
503            Self::StorageTypeNotSupportedFault(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
504            Self::VpcEncryptionControlViolationException(e) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(e),
505            Self::Unhandled(e) => &e.meta,
506        }
507    }
508    /// Returns `true` if the error kind is `ModifyDBClusterError::DbClusterAlreadyExistsFault`.
509    pub fn is_db_cluster_already_exists_fault(&self) -> bool {
510        matches!(self, Self::DbClusterAlreadyExistsFault(_))
511    }
512    /// Returns `true` if the error kind is `ModifyDBClusterError::DbClusterNotFoundFault`.
513    pub fn is_db_cluster_not_found_fault(&self) -> bool {
514        matches!(self, Self::DbClusterNotFoundFault(_))
515    }
516    /// Returns `true` if the error kind is `ModifyDBClusterError::DbClusterParameterGroupNotFoundFault`.
517    pub fn is_db_cluster_parameter_group_not_found_fault(&self) -> bool {
518        matches!(self, Self::DbClusterParameterGroupNotFoundFault(_))
519    }
520    /// Returns `true` if the error kind is `ModifyDBClusterError::DbInstanceAlreadyExistsFault`.
521    pub fn is_db_instance_already_exists_fault(&self) -> bool {
522        matches!(self, Self::DbInstanceAlreadyExistsFault(_))
523    }
524    /// Returns `true` if the error kind is `ModifyDBClusterError::DbParameterGroupNotFoundFault`.
525    pub fn is_db_parameter_group_not_found_fault(&self) -> bool {
526        matches!(self, Self::DbParameterGroupNotFoundFault(_))
527    }
528    /// Returns `true` if the error kind is `ModifyDBClusterError::DbSubnetGroupNotFoundFault`.
529    pub fn is_db_subnet_group_not_found_fault(&self) -> bool {
530        matches!(self, Self::DbSubnetGroupNotFoundFault(_))
531    }
532    /// Returns `true` if the error kind is `ModifyDBClusterError::DomainNotFoundFault`.
533    pub fn is_domain_not_found_fault(&self) -> bool {
534        matches!(self, Self::DomainNotFoundFault(_))
535    }
536    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidDbClusterStateFault`.
537    pub fn is_invalid_db_cluster_state_fault(&self) -> bool {
538        matches!(self, Self::InvalidDbClusterStateFault(_))
539    }
540    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidDbInstanceStateFault`.
541    pub fn is_invalid_db_instance_state_fault(&self) -> bool {
542        matches!(self, Self::InvalidDbInstanceStateFault(_))
543    }
544    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidDbSecurityGroupStateFault`.
545    pub fn is_invalid_db_security_group_state_fault(&self) -> bool {
546        matches!(self, Self::InvalidDbSecurityGroupStateFault(_))
547    }
548    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidDbSubnetGroupStateFault`.
549    pub fn is_invalid_db_subnet_group_state_fault(&self) -> bool {
550        matches!(self, Self::InvalidDbSubnetGroupStateFault(_))
551    }
552    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidGlobalClusterStateFault`.
553    pub fn is_invalid_global_cluster_state_fault(&self) -> bool {
554        matches!(self, Self::InvalidGlobalClusterStateFault(_))
555    }
556    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidSubnet`.
557    pub fn is_invalid_subnet(&self) -> bool {
558        matches!(self, Self::InvalidSubnet(_))
559    }
560    /// Returns `true` if the error kind is `ModifyDBClusterError::InvalidVpcNetworkStateFault`.
561    pub fn is_invalid_vpc_network_state_fault(&self) -> bool {
562        matches!(self, Self::InvalidVpcNetworkStateFault(_))
563    }
564    /// Returns `true` if the error kind is `ModifyDBClusterError::KmsKeyNotAccessibleFault`.
565    pub fn is_kms_key_not_accessible_fault(&self) -> bool {
566        matches!(self, Self::KmsKeyNotAccessibleFault(_))
567    }
568    /// Returns `true` if the error kind is `ModifyDBClusterError::NetworkTypeNotSupported`.
569    pub fn is_network_type_not_supported(&self) -> bool {
570        matches!(self, Self::NetworkTypeNotSupported(_))
571    }
572    /// Returns `true` if the error kind is `ModifyDBClusterError::OptionGroupNotFoundFault`.
573    pub fn is_option_group_not_found_fault(&self) -> bool {
574        matches!(self, Self::OptionGroupNotFoundFault(_))
575    }
576    /// Returns `true` if the error kind is `ModifyDBClusterError::StorageQuotaExceededFault`.
577    pub fn is_storage_quota_exceeded_fault(&self) -> bool {
578        matches!(self, Self::StorageQuotaExceededFault(_))
579    }
580    /// Returns `true` if the error kind is `ModifyDBClusterError::StorageTypeNotAvailableFault`.
581    pub fn is_storage_type_not_available_fault(&self) -> bool {
582        matches!(self, Self::StorageTypeNotAvailableFault(_))
583    }
584    /// Returns `true` if the error kind is `ModifyDBClusterError::StorageTypeNotSupportedFault`.
585    pub fn is_storage_type_not_supported_fault(&self) -> bool {
586        matches!(self, Self::StorageTypeNotSupportedFault(_))
587    }
588    /// Returns `true` if the error kind is `ModifyDBClusterError::VpcEncryptionControlViolationException`.
589    pub fn is_vpc_encryption_control_violation_exception(&self) -> bool {
590        matches!(self, Self::VpcEncryptionControlViolationException(_))
591    }
592}
593impl ::std::error::Error for ModifyDBClusterError {
594    fn source(&self) -> ::std::option::Option<&(dyn ::std::error::Error + 'static)> {
595        match self {
596            Self::DbClusterAlreadyExistsFault(_inner) => ::std::option::Option::Some(_inner),
597            Self::DbClusterNotFoundFault(_inner) => ::std::option::Option::Some(_inner),
598            Self::DbClusterParameterGroupNotFoundFault(_inner) => ::std::option::Option::Some(_inner),
599            Self::DbInstanceAlreadyExistsFault(_inner) => ::std::option::Option::Some(_inner),
600            Self::DbParameterGroupNotFoundFault(_inner) => ::std::option::Option::Some(_inner),
601            Self::DbSubnetGroupNotFoundFault(_inner) => ::std::option::Option::Some(_inner),
602            Self::DomainNotFoundFault(_inner) => ::std::option::Option::Some(_inner),
603            Self::InvalidDbClusterStateFault(_inner) => ::std::option::Option::Some(_inner),
604            Self::InvalidDbInstanceStateFault(_inner) => ::std::option::Option::Some(_inner),
605            Self::InvalidDbSecurityGroupStateFault(_inner) => ::std::option::Option::Some(_inner),
606            Self::InvalidDbSubnetGroupStateFault(_inner) => ::std::option::Option::Some(_inner),
607            Self::InvalidGlobalClusterStateFault(_inner) => ::std::option::Option::Some(_inner),
608            Self::InvalidSubnet(_inner) => ::std::option::Option::Some(_inner),
609            Self::InvalidVpcNetworkStateFault(_inner) => ::std::option::Option::Some(_inner),
610            Self::KmsKeyNotAccessibleFault(_inner) => ::std::option::Option::Some(_inner),
611            Self::NetworkTypeNotSupported(_inner) => ::std::option::Option::Some(_inner),
612            Self::OptionGroupNotFoundFault(_inner) => ::std::option::Option::Some(_inner),
613            Self::StorageQuotaExceededFault(_inner) => ::std::option::Option::Some(_inner),
614            Self::StorageTypeNotAvailableFault(_inner) => ::std::option::Option::Some(_inner),
615            Self::StorageTypeNotSupportedFault(_inner) => ::std::option::Option::Some(_inner),
616            Self::VpcEncryptionControlViolationException(_inner) => ::std::option::Option::Some(_inner),
617            Self::Unhandled(_inner) => ::std::option::Option::Some(&*_inner.source),
618        }
619    }
620}
621impl ::std::fmt::Display for ModifyDBClusterError {
622    fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
623        match self {
624            Self::DbClusterAlreadyExistsFault(_inner) => _inner.fmt(f),
625            Self::DbClusterNotFoundFault(_inner) => _inner.fmt(f),
626            Self::DbClusterParameterGroupNotFoundFault(_inner) => _inner.fmt(f),
627            Self::DbInstanceAlreadyExistsFault(_inner) => _inner.fmt(f),
628            Self::DbParameterGroupNotFoundFault(_inner) => _inner.fmt(f),
629            Self::DbSubnetGroupNotFoundFault(_inner) => _inner.fmt(f),
630            Self::DomainNotFoundFault(_inner) => _inner.fmt(f),
631            Self::InvalidDbClusterStateFault(_inner) => _inner.fmt(f),
632            Self::InvalidDbInstanceStateFault(_inner) => _inner.fmt(f),
633            Self::InvalidDbSecurityGroupStateFault(_inner) => _inner.fmt(f),
634            Self::InvalidDbSubnetGroupStateFault(_inner) => _inner.fmt(f),
635            Self::InvalidGlobalClusterStateFault(_inner) => _inner.fmt(f),
636            Self::InvalidSubnet(_inner) => _inner.fmt(f),
637            Self::InvalidVpcNetworkStateFault(_inner) => _inner.fmt(f),
638            Self::KmsKeyNotAccessibleFault(_inner) => _inner.fmt(f),
639            Self::NetworkTypeNotSupported(_inner) => _inner.fmt(f),
640            Self::OptionGroupNotFoundFault(_inner) => _inner.fmt(f),
641            Self::StorageQuotaExceededFault(_inner) => _inner.fmt(f),
642            Self::StorageTypeNotAvailableFault(_inner) => _inner.fmt(f),
643            Self::StorageTypeNotSupportedFault(_inner) => _inner.fmt(f),
644            Self::VpcEncryptionControlViolationException(_inner) => _inner.fmt(f),
645            Self::Unhandled(_inner) => {
646                if let ::std::option::Option::Some(code) = ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self) {
647                    write!(f, "unhandled error ({code})")
648                } else {
649                    f.write_str("unhandled error")
650                }
651            }
652        }
653    }
654}
655impl ::aws_smithy_types::retry::ProvideErrorKind for ModifyDBClusterError {
656    fn code(&self) -> ::std::option::Option<&str> {
657        ::aws_smithy_types::error::metadata::ProvideErrorMetadata::code(self)
658    }
659    fn retryable_error_kind(&self) -> ::std::option::Option<::aws_smithy_types::retry::ErrorKind> {
660        ::std::option::Option::None
661    }
662}
663impl ::aws_smithy_types::error::metadata::ProvideErrorMetadata for ModifyDBClusterError {
664    fn meta(&self) -> &::aws_smithy_types::error::ErrorMetadata {
665        match self {
666            Self::DbClusterAlreadyExistsFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
667            Self::DbClusterNotFoundFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
668            Self::DbClusterParameterGroupNotFoundFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
669            Self::DbInstanceAlreadyExistsFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
670            Self::DbParameterGroupNotFoundFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
671            Self::DbSubnetGroupNotFoundFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
672            Self::DomainNotFoundFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
673            Self::InvalidDbClusterStateFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
674            Self::InvalidDbInstanceStateFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
675            Self::InvalidDbSecurityGroupStateFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
676            Self::InvalidDbSubnetGroupStateFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
677            Self::InvalidGlobalClusterStateFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
678            Self::InvalidSubnet(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
679            Self::InvalidVpcNetworkStateFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
680            Self::KmsKeyNotAccessibleFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
681            Self::NetworkTypeNotSupported(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
682            Self::OptionGroupNotFoundFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
683            Self::StorageQuotaExceededFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
684            Self::StorageTypeNotAvailableFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
685            Self::StorageTypeNotSupportedFault(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
686            Self::VpcEncryptionControlViolationException(_inner) => ::aws_smithy_types::error::metadata::ProvideErrorMetadata::meta(_inner),
687            Self::Unhandled(_inner) => &_inner.meta,
688        }
689    }
690}
691impl ::aws_smithy_runtime_api::client::result::CreateUnhandledError for ModifyDBClusterError {
692    fn create_unhandled_error(
693        source: ::std::boxed::Box<dyn ::std::error::Error + ::std::marker::Send + ::std::marker::Sync + 'static>,
694        meta: ::std::option::Option<::aws_smithy_types::error::ErrorMetadata>,
695    ) -> Self {
696        Self::Unhandled(crate::error::sealed_unhandled::Unhandled {
697            source,
698            meta: meta.unwrap_or_default(),
699        })
700    }
701}
702impl ::aws_types::request_id::RequestId for crate::operation::modify_db_cluster::ModifyDBClusterError {
703    fn request_id(&self) -> Option<&str> {
704        self.meta().request_id()
705    }
706}
707
708pub use crate::operation::modify_db_cluster::_modify_db_cluster_input::ModifyDbClusterInput;
709
710pub use crate::operation::modify_db_cluster::_modify_db_cluster_output::ModifyDbClusterOutput;
711
712mod _modify_db_cluster_input;
713
714mod _modify_db_cluster_output;
715
716/// Builders
717pub mod builders;