aws_sdk_rds/operation/modify_certificates/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::modify_certificates::_modify_certificates_output::ModifyCertificatesOutputBuilder;
3
4pub use crate::operation::modify_certificates::_modify_certificates_input::ModifyCertificatesInputBuilder;
5
6impl crate::operation::modify_certificates::builders::ModifyCertificatesInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::modify_certificates::ModifyCertificatesOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::modify_certificates::ModifyCertificatesError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.modify_certificates();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `ModifyCertificates`.
24///
25/// <p>Override the system-default Secure Sockets Layer/Transport Layer Security (SSL/TLS) certificate for Amazon RDS for new DB instances, or remove the override.</p>
26/// <p>By using this operation, you can specify an RDS-approved SSL/TLS certificate for new DB instances that is different from the default certificate provided by RDS. You can also use this operation to remove the override, so that new DB instances use the default certificate provided by RDS.</p>
27/// <p>You might need to override the default certificate in the following situations:</p>
28/// <ul>
29/// <li>
30/// <p>You already migrated your applications to support the latest certificate authority (CA) certificate, but the new CA certificate is not yet the RDS default CA certificate for the specified Amazon Web Services Region.</p></li>
31/// <li>
32/// <p>RDS has already moved to a new default CA certificate for the specified Amazon Web Services Region, but you are still in the process of supporting the new CA certificate. In this case, you temporarily need additional time to finish your application changes.</p></li>
33/// </ul>
34/// <p>For more information about rotating your SSL/TLS certificate for RDS DB engines, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html"> Rotating Your SSL/TLS Certificate</a> in the <i>Amazon RDS User Guide</i>.</p>
35/// <p>For more information about rotating your SSL/TLS certificate for Aurora DB engines, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html"> Rotating Your SSL/TLS Certificate</a> in the <i>Amazon Aurora User Guide</i>.</p>
36#[derive(::std::clone::Clone, ::std::fmt::Debug)]
37pub struct ModifyCertificatesFluentBuilder {
38    handle: ::std::sync::Arc<crate::client::Handle>,
39    inner: crate::operation::modify_certificates::builders::ModifyCertificatesInputBuilder,
40    config_override: ::std::option::Option<crate::config::Builder>,
41}
42impl
43    crate::client::customize::internal::CustomizableSend<
44        crate::operation::modify_certificates::ModifyCertificatesOutput,
45        crate::operation::modify_certificates::ModifyCertificatesError,
46    > for ModifyCertificatesFluentBuilder
47{
48    fn send(
49        self,
50        config_override: crate::config::Builder,
51    ) -> crate::client::customize::internal::BoxFuture<
52        crate::client::customize::internal::SendResult<
53            crate::operation::modify_certificates::ModifyCertificatesOutput,
54            crate::operation::modify_certificates::ModifyCertificatesError,
55        >,
56    > {
57        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
58    }
59}
60impl ModifyCertificatesFluentBuilder {
61    /// Creates a new `ModifyCertificatesFluentBuilder`.
62    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
63        Self {
64            handle,
65            inner: ::std::default::Default::default(),
66            config_override: ::std::option::Option::None,
67        }
68    }
69    /// Access the ModifyCertificates as a reference.
70    pub fn as_input(&self) -> &crate::operation::modify_certificates::builders::ModifyCertificatesInputBuilder {
71        &self.inner
72    }
73    /// Sends the request and returns the response.
74    ///
75    /// If an error occurs, an `SdkError` will be returned with additional details that
76    /// can be matched against.
77    ///
78    /// By default, any retryable failures will be retried twice. Retry behavior
79    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
80    /// set when configuring the client.
81    pub async fn send(
82        self,
83    ) -> ::std::result::Result<
84        crate::operation::modify_certificates::ModifyCertificatesOutput,
85        ::aws_smithy_runtime_api::client::result::SdkError<
86            crate::operation::modify_certificates::ModifyCertificatesError,
87            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
88        >,
89    > {
90        let input = self
91            .inner
92            .build()
93            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
94        let runtime_plugins = crate::operation::modify_certificates::ModifyCertificates::operation_runtime_plugins(
95            self.handle.runtime_plugins.clone(),
96            &self.handle.conf,
97            self.config_override,
98        );
99        crate::operation::modify_certificates::ModifyCertificates::orchestrate(&runtime_plugins, input).await
100    }
101
102    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
103    pub fn customize(
104        self,
105    ) -> crate::client::customize::CustomizableOperation<
106        crate::operation::modify_certificates::ModifyCertificatesOutput,
107        crate::operation::modify_certificates::ModifyCertificatesError,
108        Self,
109    > {
110        crate::client::customize::CustomizableOperation::new(self)
111    }
112    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
113        self.set_config_override(::std::option::Option::Some(config_override.into()));
114        self
115    }
116
117    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
118        self.config_override = config_override;
119        self
120    }
121    /// <p>The new default certificate identifier to override the current one with.</p>
122    /// <p>To determine the valid values, use the <code>describe-certificates</code> CLI command or the <code>DescribeCertificates</code> API operation.</p>
123    pub fn certificate_identifier(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
124        self.inner = self.inner.certificate_identifier(input.into());
125        self
126    }
127    /// <p>The new default certificate identifier to override the current one with.</p>
128    /// <p>To determine the valid values, use the <code>describe-certificates</code> CLI command or the <code>DescribeCertificates</code> API operation.</p>
129    pub fn set_certificate_identifier(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
130        self.inner = self.inner.set_certificate_identifier(input);
131        self
132    }
133    /// <p>The new default certificate identifier to override the current one with.</p>
134    /// <p>To determine the valid values, use the <code>describe-certificates</code> CLI command or the <code>DescribeCertificates</code> API operation.</p>
135    pub fn get_certificate_identifier(&self) -> &::std::option::Option<::std::string::String> {
136        self.inner.get_certificate_identifier()
137    }
138    /// <p>Specifies whether to remove the override for the default certificate. If the override is removed, the default certificate is the system default.</p>
139    pub fn remove_customer_override(mut self, input: bool) -> Self {
140        self.inner = self.inner.remove_customer_override(input);
141        self
142    }
143    /// <p>Specifies whether to remove the override for the default certificate. If the override is removed, the default certificate is the system default.</p>
144    pub fn set_remove_customer_override(mut self, input: ::std::option::Option<bool>) -> Self {
145        self.inner = self.inner.set_remove_customer_override(input);
146        self
147    }
148    /// <p>Specifies whether to remove the override for the default certificate. If the override is removed, the default certificate is the system default.</p>
149    pub fn get_remove_customer_override(&self) -> &::std::option::Option<bool> {
150        self.inner.get_remove_customer_override()
151    }
152}