aws_sdk_rds/operation/modify_custom_db_engine_version/

builders.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::modify_custom_db_engine_version::_modify_custom_db_engine_version_output::ModifyCustomDbEngineVersionOutputBuilder;

pub use crate::operation::modify_custom_db_engine_version::_modify_custom_db_engine_version_input::ModifyCustomDbEngineVersionInputBuilder;

impl crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDbEngineVersionInputBuilder {
    /// Sends a request with this input using the given client.
    pub async fn send_with(
        self,
        client: &crate::Client,
    ) -> ::std::result::Result<
        crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersionError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let mut fluent_builder = client.modify_custom_db_engine_version();
        fluent_builder.inner = self;
        fluent_builder.send().await
    }
}
/// Fluent builder constructing a request to `ModifyCustomDBEngineVersion`.
///
/// <p>Modifies the status of a custom engine version (CEV). You can find CEVs to modify by calling <code>DescribeDBEngineVersions</code>.</p><note>
/// <p>The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the <code>ModifyCustomDbEngineVersion</code> event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for the <code>ModifyCustomDbEngineVersion</code> event.</p>
/// </note>
/// <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.modify">Modifying CEV status</a> in the <i>Amazon RDS User Guide</i>.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct ModifyCustomDBEngineVersionFluentBuilder {
    handle: ::std::sync::Arc<crate::client::Handle>,
    inner: crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDbEngineVersionInputBuilder,
    config_override: ::std::option::Option<crate::config::Builder>,
}
impl
    crate::client::customize::internal::CustomizableSend<
        crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput,
        crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersionError,
    > for ModifyCustomDBEngineVersionFluentBuilder
{
    fn send(
        self,
        config_override: crate::config::Builder,
    ) -> crate::client::customize::internal::BoxFuture<
        crate::client::customize::internal::SendResult<
            crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput,
            crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersionError,
        >,
    > {
        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
    }
}
impl ModifyCustomDBEngineVersionFluentBuilder {
    /// Creates a new `ModifyCustomDBEngineVersionFluentBuilder`.
    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
        Self {
            handle,
            inner: ::std::default::Default::default(),
            config_override: ::std::option::Option::None,
        }
    }
    /// Access the ModifyCustomDBEngineVersion as a reference.
    pub fn as_input(&self) -> &crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDbEngineVersionInputBuilder {
        &self.inner
    }
    /// Sends the request and returns the response.
    ///
    /// If an error occurs, an `SdkError` will be returned with additional details that
    /// can be matched against.
    ///
    /// By default, any retryable failures will be retried twice. Retry behavior
    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
    /// set when configuring the client.
    pub async fn send(
        self,
    ) -> ::std::result::Result<
        crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersionError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let input = self
            .inner
            .build()
            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
        let runtime_plugins = crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersion::operation_runtime_plugins(
            self.handle.runtime_plugins.clone(),
            &self.handle.conf,
            self.config_override,
        );
        crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersion::orchestrate(&runtime_plugins, input).await
    }

    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
    pub fn customize(
        self,
    ) -> crate::client::customize::CustomizableOperation<
        crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput,
        crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersionError,
        Self,
    > {
        crate::client::customize::CustomizableOperation::new(self)
    }
    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
        self.set_config_override(::std::option::Option::Some(config_override.into()));
        self
    }

    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
        self.config_override = config_override;
        self
    }
    /// <p>The database engine. RDS Custom for Oracle supports the following values:</p>
    /// <ul>
    /// <li>
    /// <p><code>custom-oracle-ee</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-ee-cdb</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-se2</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-se2-cdb</code></p></li>
    /// </ul>
    pub fn engine(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.engine(input.into());
        self
    }
    /// <p>The database engine. RDS Custom for Oracle supports the following values:</p>
    /// <ul>
    /// <li>
    /// <p><code>custom-oracle-ee</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-ee-cdb</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-se2</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-se2-cdb</code></p></li>
    /// </ul>
    pub fn set_engine(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_engine(input);
        self
    }
    /// <p>The database engine. RDS Custom for Oracle supports the following values:</p>
    /// <ul>
    /// <li>
    /// <p><code>custom-oracle-ee</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-ee-cdb</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-se2</code></p></li>
    /// <li>
    /// <p><code>custom-oracle-se2-cdb</code></p></li>
    /// </ul>
    pub fn get_engine(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_engine()
    }
    /// <p>The custom engine version (CEV) that you want to modify. This option is required for RDS Custom for Oracle, but optional for Amazon RDS. The combination of <code>Engine</code> and <code>EngineVersion</code> is unique per customer per Amazon Web Services Region.</p>
    pub fn engine_version(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.engine_version(input.into());
        self
    }
    /// <p>The custom engine version (CEV) that you want to modify. This option is required for RDS Custom for Oracle, but optional for Amazon RDS. The combination of <code>Engine</code> and <code>EngineVersion</code> is unique per customer per Amazon Web Services Region.</p>
    pub fn set_engine_version(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_engine_version(input);
        self
    }
    /// <p>The custom engine version (CEV) that you want to modify. This option is required for RDS Custom for Oracle, but optional for Amazon RDS. The combination of <code>Engine</code> and <code>EngineVersion</code> is unique per customer per Amazon Web Services Region.</p>
    pub fn get_engine_version(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_engine_version()
    }
    /// <p>An optional description of your CEV.</p>
    pub fn description(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.description(input.into());
        self
    }
    /// <p>An optional description of your CEV.</p>
    pub fn set_description(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_description(input);
        self
    }
    /// <p>An optional description of your CEV.</p>
    pub fn get_description(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_description()
    }
    /// <p>The availability status to be assigned to the CEV. Valid values are as follows:</p>
    /// <dl>
    /// <dt>
    /// available
    /// </dt>
    /// <dd>
    /// <p>You can use this CEV to create a new RDS Custom DB instance.</p>
    /// </dd>
    /// <dt>
    /// inactive
    /// </dt>
    /// <dd>
    /// <p>You can create a new RDS Custom instance by restoring a DB snapshot with this CEV. You can't patch or create new instances with this CEV.</p>
    /// </dd>
    /// </dl>
    /// <p>You can change any status to any status. A typical reason to change status is to prevent the accidental use of a CEV, or to make a deprecated CEV eligible for use again. For example, you might change the status of your CEV from <code>available</code> to <code>inactive</code>, and from <code>inactive</code> back to <code>available</code>. To change the availability status of the CEV, it must not currently be in use by an RDS Custom instance, snapshot, or automated backup.</p>
    pub fn status(mut self, input: crate::types::CustomEngineVersionStatus) -> Self {
        self.inner = self.inner.status(input);
        self
    }
    /// <p>The availability status to be assigned to the CEV. Valid values are as follows:</p>
    /// <dl>
    /// <dt>
    /// available
    /// </dt>
    /// <dd>
    /// <p>You can use this CEV to create a new RDS Custom DB instance.</p>
    /// </dd>
    /// <dt>
    /// inactive
    /// </dt>
    /// <dd>
    /// <p>You can create a new RDS Custom instance by restoring a DB snapshot with this CEV. You can't patch or create new instances with this CEV.</p>
    /// </dd>
    /// </dl>
    /// <p>You can change any status to any status. A typical reason to change status is to prevent the accidental use of a CEV, or to make a deprecated CEV eligible for use again. For example, you might change the status of your CEV from <code>available</code> to <code>inactive</code>, and from <code>inactive</code> back to <code>available</code>. To change the availability status of the CEV, it must not currently be in use by an RDS Custom instance, snapshot, or automated backup.</p>
    pub fn set_status(mut self, input: ::std::option::Option<crate::types::CustomEngineVersionStatus>) -> Self {
        self.inner = self.inner.set_status(input);
        self
    }
    /// <p>The availability status to be assigned to the CEV. Valid values are as follows:</p>
    /// <dl>
    /// <dt>
    /// available
    /// </dt>
    /// <dd>
    /// <p>You can use this CEV to create a new RDS Custom DB instance.</p>
    /// </dd>
    /// <dt>
    /// inactive
    /// </dt>
    /// <dd>
    /// <p>You can create a new RDS Custom instance by restoring a DB snapshot with this CEV. You can't patch or create new instances with this CEV.</p>
    /// </dd>
    /// </dl>
    /// <p>You can change any status to any status. A typical reason to change status is to prevent the accidental use of a CEV, or to make a deprecated CEV eligible for use again. For example, you might change the status of your CEV from <code>available</code> to <code>inactive</code>, and from <code>inactive</code> back to <code>available</code>. To change the availability status of the CEV, it must not currently be in use by an RDS Custom instance, snapshot, or automated backup.</p>
    pub fn get_status(&self) -> &::std::option::Option<crate::types::CustomEngineVersionStatus> {
        self.inner.get_status()
    }
}