1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`ModifyCustomDBEngineVersion`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`engine(impl Into<String>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::engine) / [`set_engine(Option<String>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::set_engine): <p>The DB engine. The only supported value is <code>custom-oracle-ee</code>.</p>
    ///   - [`engine_version(impl Into<String>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::engine_version) / [`set_engine_version(Option<String>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::set_engine_version): <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>
    ///   - [`description(impl Into<String>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::set_description): <p>An optional description of your CEV.</p>
    ///   - [`status(CustomEngineVersionStatus)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::status) / [`set_status(Option<CustomEngineVersionStatus>)`](crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::set_status): <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>
    /// - On success, responds with [`ModifyCustomDbEngineVersionOutput`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput) with field(s):
    ///   - [`engine(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::engine): <p>The name of the database engine.</p>
    ///   - [`engine_version(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::engine_version): <p>The version number of the database engine.</p>
    ///   - [`db_parameter_group_family(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::db_parameter_group_family): <p>The name of the DB parameter group family for the database engine.</p>
    ///   - [`db_engine_description(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::db_engine_description): <p>The description of the database engine.</p>
    ///   - [`db_engine_version_description(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::db_engine_version_description): <p>The description of the database engine version.</p>
    ///   - [`default_character_set(Option<CharacterSet>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::default_character_set): <p>The default character set for new instances of this engine version, if the <code>CharacterSetName</code> parameter of the CreateDBInstance API isn't specified.</p>
    ///   - [`image(Option<CustomDbEngineVersionAmi>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::image): <p>The EC2 image</p>
    ///   - [`db_engine_media_type(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::db_engine_media_type): <p>A value that indicates the source media provider of the AMI based on the usage operation. Applicable for RDS Custom for SQL Server.</p>
    ///   - [`supported_character_sets(Option<Vec<CharacterSet>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supported_character_sets): <p>A list of the character sets supported by this engine for the <code>CharacterSetName</code> parameter of the <code>CreateDBInstance</code> operation.</p>
    ///   - [`supported_nchar_character_sets(Option<Vec<CharacterSet>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supported_nchar_character_sets): <p>A list of the character sets supported by the Oracle DB engine for the <code>NcharCharacterSetName</code> parameter of the <code>CreateDBInstance</code> operation.</p>
    ///   - [`valid_upgrade_target(Option<Vec<UpgradeTarget>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::valid_upgrade_target): <p>A list of engine versions that this database engine version can be upgraded to.</p>
    ///   - [`supported_timezones(Option<Vec<Timezone>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supported_timezones): <p>A list of the time zones supported by this engine for the <code>Timezone</code> parameter of the <code>CreateDBInstance</code> action.</p>
    ///   - [`exportable_log_types(Option<Vec<String>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::exportable_log_types): <p>The types of logs that the database engine has available for export to CloudWatch Logs.</p>
    ///   - [`supports_log_exports_to_cloudwatch_logs(bool)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supports_log_exports_to_cloudwatch_logs): <p>A value that indicates whether the engine version supports exporting the log types specified by ExportableLogTypes to CloudWatch Logs.</p>
    ///   - [`supports_read_replica(bool)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supports_read_replica): <p>Indicates whether the database engine version supports read replicas.</p>
    ///   - [`supported_engine_modes(Option<Vec<String>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supported_engine_modes): <p>A list of the supported DB engine modes.</p>
    ///   - [`supported_feature_names(Option<Vec<String>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supported_feature_names): <p>A list of features supported by the DB engine.</p>  <p>The supported features vary by DB engine and DB engine version.</p>  <p>To determine the supported features for a specific DB engine and DB engine version using the CLI, use the following command:</p>  <p> <code>aws rds describe-db-engine-versions --engine    <engine_name>     --engine-version     <engine_version></engine_version>   </engine_name></code> </p>  <p>For example, to determine the supported features for RDS for PostgreSQL version 13.3 using the CLI, use the following command:</p>  <p> <code>aws rds describe-db-engine-versions --engine postgres --engine-version 13.3</code> </p>  <p>The supported features are listed under <code>SupportedFeatureNames</code> in the output.</p>
    ///   - [`status(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::status): <p>The status of the DB engine version, either <code>available</code> or <code>deprecated</code>.</p>
    ///   - [`supports_parallel_query(bool)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supports_parallel_query): <p>A value that indicates whether you can use Aurora parallel query with a specific DB engine version.</p>
    ///   - [`supports_global_databases(bool)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supports_global_databases): <p>A value that indicates whether you can use Aurora global databases with a specific DB engine version.</p>
    ///   - [`major_engine_version(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::major_engine_version): <p>The major engine version of the CEV.</p>
    ///   - [`database_installation_files_s3_bucket_name(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::database_installation_files_s3_bucket_name): <p>The name of the Amazon S3 bucket that contains your database installation files.</p>
    ///   - [`database_installation_files_s3_prefix(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::database_installation_files_s3_prefix): <p>The Amazon S3 directory that contains the database installation files. If not specified, then no prefix is assumed.</p>
    ///   - [`db_engine_version_arn(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::db_engine_version_arn): <p>The ARN of the custom engine version.</p>
    ///   - [`kms_key_id(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::kms_key_id): <p>The Amazon Web Services KMS key identifier for an encrypted CEV. This parameter is required for RDS Custom, but optional for Amazon RDS.</p>
    ///   - [`create_time(Option<DateTime>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::create_time): <p>The creation time of the DB engine version.</p>
    ///   - [`tag_list(Option<Vec<Tag>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::tag_list): <p>A list of tags. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html">Tagging Amazon RDS Resources</a> in the <i>Amazon RDS User Guide.</i> </p>
    ///   - [`supports_babelfish(bool)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supports_babelfish): <p>A value that indicates whether the engine version supports Babelfish for Aurora PostgreSQL.</p>
    ///   - [`custom_db_engine_version_manifest(Option<String>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::custom_db_engine_version_manifest): <p>JSON string that lists the installation files and parameters that RDS Custom uses to create a custom engine version (CEV). RDS Custom applies the patches in the order in which they're listed in the manifest. You can set the Oracle home, Oracle base, and UNIX/Linux user and group using the installation parameters. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.preparing.html#custom-cev.preparing.manifest.fields">JSON fields in the CEV manifest</a> in the <i>Amazon RDS User Guide</i>. </p>
    ///   - [`supports_certificate_rotation_without_restart(Option<bool>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supports_certificate_rotation_without_restart): <p>A value that indicates whether the engine version supports rotating the server certificate without rebooting the DB instance.</p>
    ///   - [`supported_ca_certificate_identifiers(Option<Vec<String>>)`](crate::operation::modify_custom_db_engine_version::ModifyCustomDbEngineVersionOutput::supported_ca_certificate_identifiers): <p>A list of the supported CA certificate identifiers.</p>  <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html">Using SSL/TLS to encrypt a connection to a DB instance</a> in the <i>Amazon RDS User Guide</i> and <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html"> Using SSL/TLS to encrypt a connection to a DB cluster</a> in the <i>Amazon Aurora User Guide</i>.</p>
    /// - On failure, responds with [`SdkError<ModifyCustomDBEngineVersionError>`](crate::operation::modify_custom_db_engine_version::ModifyCustomDBEngineVersionError)
    pub fn modify_custom_db_engine_version(&self) -> crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder{
        crate::operation::modify_custom_db_engine_version::builders::ModifyCustomDBEngineVersionFluentBuilder::new(self.handle.clone())
    }
}