aws-sdk-rds 1.172.0 → 1.174.0

data/lib/aws-sdk-rds/client.rb

@@ -2131,22 +2131,29 @@ module Aws::RDS
 
     # Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.
     #
+    # If you create an Aurora DB cluster, the request creates an empty
+    # cluster. You must explicitly create the writer instance for your DB
+    # cluster using the [CreateDBInstance][1] operation. If you create a
+    # Multi-AZ DB cluster, the request creates a writer and two reader DB
+    # instances for you, each in a different Availability Zone.
+    #
     # You can use the `ReplicationSourceIdentifier` parameter to create an
     # Amazon Aurora DB cluster as a read replica of another DB cluster or
-    # Amazon RDS MySQL or PostgreSQL DB instance. For more information about
-    # Amazon Aurora, see [What is Amazon Aurora?][1] in the *Amazon Aurora
-    # User Guide*.
+    # Amazon RDS for MySQL or PostgreSQL DB instance. For more information
+    # about Amazon Aurora, see [What is Amazon Aurora?][2] in the *Amazon
+    # Aurora User Guide*.
     #
     # You can also use the `ReplicationSourceIdentifier` parameter to create
-    # a Multi-AZ DB cluster read replica with an RDS for PostgreSQL DB
-    # instance as the source. For more information about Multi-AZ DB
-    # clusters, see [Multi-AZ DB cluster deployments][2] in the *Amazon RDS
+    # a Multi-AZ DB cluster read replica with an RDS for MySQL or PostgreSQL
+    # DB instance as the source. For more information about Multi-AZ DB
+    # clusters, see [Multi-AZ DB cluster deployments][3] in the *Amazon RDS
     # User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
-    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
+    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html
+    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
+    # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
     #
     # @option params [Array<String>] :availability_zones
     #   A list of Availability Zones (AZs) where DB instances in the DB
@@ -2240,10 +2247,7 @@ module Aws::RDS
     #
     #   Valid Values:
     #
-    #   * `aurora` (for MySQL 5.6-compatible Aurora)
-    #
-    #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
-    #     Aurora)
+    #   * `aurora-mysql`
     #
     #   * `aurora-postgresql`
     #
@@ -2256,18 +2260,16 @@ module Aws::RDS
     # @option params [String] :engine_version
     #   The version number of the database engine to use.
     #
-    #   To list all of the available engine versions for MySQL 5.6-compatible
-    #   Aurora, use the following command:
-    #
-    #   `aws rds describe-db-engine-versions --engine aurora --query
-    #   "DBEngineVersions[].EngineVersion"`
-    #
-    #   To list all of the available engine versions for MySQL 5.7-compatible
-    #   and MySQL 8.0-compatible Aurora, use the following command:
+    #   To list all of the available engine versions for Aurora MySQL version
+    #   2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
+    #   following command:
     #
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
     #
+    #   You can supply either `5.7` or `8.0` to use the default engine version
+    #   for Aurora MySQL version 2 or version 3, respectively.
+    #
     #   To list all of the available engine versions for Aurora PostgreSQL,
     #   use the following command:
     #
@@ -2288,8 +2290,8 @@ module Aws::RDS
     #
     #   **Aurora MySQL**
     #
-    #   For information, see [MySQL on Amazon RDS Versions][1] in the *Amazon
-    #   Aurora User Guide*.
+    #   For information, see [Database engine updates for Amazon Aurora
+    #   MySQL][1] in the *Amazon Aurora User Guide*.
     #
     #   **Aurora PostgreSQL**
     #
@@ -2298,13 +2300,13 @@ module Aws::RDS
     #
     #   **MySQL**
     #
-    #   For information, see [MySQL on Amazon RDS Versions][3] in the *Amazon
-    #   RDS User Guide*.
+    #   For information, see [Amazon RDS for MySQL][3] in the *Amazon RDS User
+    #   Guide*.
     #
     #   **PostgreSQL**
     #
-    #   For information, see [Amazon RDS for PostgreSQL versions and
-    #   extensions][4] in the *Amazon RDS User Guide*.
+    #   For information, see [Amazon RDS for PostgreSQL][4] in the *Amazon RDS
+    #   User Guide*.
     #
     #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
@@ -2417,8 +2419,7 @@ module Aws::RDS
     #   The Amazon Resource Name (ARN) of the source DB instance or DB cluster
     #   if this DB cluster is created as a read replica.
     #
-    #   Valid for: Aurora DB clusters and RDS for PostgreSQL Multi-AZ DB
-    #   clusters
+    #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
     # @option params [Array<Types::Tag>] :tags
     #   Tags to assign to the DB cluster.
@@ -2439,7 +2440,7 @@ module Aws::RDS
     #   different Amazon Web Services account, specify the key ARN or alias
     #   ARN.
     #
-    #   When a KMS key isn't specified in `KmsKeyId`\:
+    #   When a KMS key isn't specified in `KmsKeyId`:
     #
     #   * If `ReplicationSourceIdentifier` identifies an encrypted source,
     #     then Amazon RDS will use the KMS key used to encrypt the source.
@@ -2579,40 +2580,23 @@ module Aws::RDS
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
     #
     # @option params [String] :engine_mode
-    #   The DB engine mode of the DB cluster, either `provisioned`,
-    #   `serverless`, `parallelquery`, `global`, or `multimaster`.
-    #
-    #   The `parallelquery` engine mode isn't required for Aurora MySQL
-    #   version 1.23 and higher 1.x versions, and version 2.09 and higher 2.x
-    #   versions.
-    #
-    #   The `global` engine mode isn't required for Aurora MySQL version 1.22
-    #   and higher 1.x versions, and `global` engine mode isn't required for
-    #   any 2.x versions.
-    #
-    #   The `multimaster` engine mode only applies for DB clusters created
-    #   with Aurora MySQL version 5.6.10a.
+    #   The DB engine mode of the DB cluster, either `provisioned` or
+    #   `serverless`.
     #
     #   The `serverless` engine mode only applies for Aurora Serverless v1 DB
     #   clusters.
     #
-    #   For Aurora PostgreSQL, the `global` engine mode isn't required, and
-    #   both the `parallelquery` and the `multimaster` engine modes currently
-    #   aren't supported.
-    #
     #   Limitations and requirements apply to some DB engine modes. For more
     #   information, see the following sections in the *Amazon Aurora User
-    #   Guide*\:
+    #   Guide*:
     #
     #   * [Limitations of Aurora Serverless v1][1]
     #
     #   * [Requirements for Aurora Serverless v2][2]
     #
-    #   * [Limitations of Parallel Query][3]
+    #   * [Limitations of parallel query][3]
     #
-    #   * [Limitations of Aurora Global Databases][4]
-    #
-    #   * [Limitations of Multi-Master Clusters][5]
+    #   * [Limitations of Aurora global databases][4]
     #
     #   Valid for: Aurora DB clusters only
     #
@@ -2622,7 +2606,6 @@ module Aws::RDS
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
     #   [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
     #   [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
-    #   [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
     #
     # @option params [Types::ScalingConfiguration] :scaling_configuration
     #   For DB clusters in `serverless` DB engine mode, the scaling properties
@@ -2749,8 +2732,8 @@ module Aws::RDS
     #   be initially allocated for each DB instance in the Multi-AZ DB
     #   cluster.
     #
-    #   For information about valid IOPS values, see [Amazon RDS Provisioned
-    #   IOPS storage][1] in the *Amazon RDS User Guide*.
+    #   For information about valid IOPS values, see [Provisioned IOPS
+    #   storage][1] in the *Amazon RDS User Guide*.
     #
     #   This setting is required to create a Multi-AZ DB cluster.
     #
@@ -4993,6 +4976,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance AWS API Documentation
     #
@@ -5004,53 +4988,53 @@ module Aws::RDS
     end
 
     # Creates a new DB instance that acts as a read replica for an existing
-    # source DB instance. You can create a read replica for a DB instance
-    # running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. For more
-    # information, see [Working with Read Replicas][1] in the *Amazon RDS
-    # User Guide*.
+    # source DB instance or Multi-AZ DB cluster. You can create a read
+    # replica for a DB instance running MySQL, MariaDB, Oracle, PostgreSQL,
+    # or SQL Server. You can create a read replica for a Multi-AZ DB cluster
+    # running MySQL or PostgreSQL. For more information, see [Working with
+    # read replicas][1] and [Migrating from a Multi-AZ DB cluster to a DB
+    # instance using a read replica][2] in the *Amazon RDS User Guide*.
     #
     # Amazon Aurora doesn't support this operation. Call the
     # `CreateDBInstance` operation to create a DB instance for an Aurora DB
     # cluster.
     #
     # All read replica DB instances are created with backups disabled. All
-    # other DB instance attributes (including DB security groups and DB
-    # parameter groups) are inherited from the source DB instance, except as
-    # specified.
+    # other attributes (including DB security groups and DB parameter
+    # groups) are inherited from the source DB instance or cluster, except
+    # as specified.
     #
-    # Your source DB instance must have backup retention enabled.
+    # Your source DB instance or cluster must have backup retention enabled.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html
+    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html#multi-az-db-clusters-migrating-to-instance-with-read-replica
     #
     # @option params [required, String] :db_instance_identifier
     #   The DB instance identifier of the read replica. This identifier is the
     #   unique key that identifies a DB instance. This parameter is stored as
     #   a lowercase string.
     #
-    # @option params [required, String] :source_db_instance_identifier
+    # @option params [String] :source_db_instance_identifier
     #   The identifier of the DB instance that will act as the source for the
-    #   read replica. Each DB instance can have up to five read replicas.
+    #   read replica. Each DB instance can have up to 15 read replicas, with
+    #   the exception of Oracle and SQL Server, which can have up to five.
     #
     #   Constraints:
     #
     #   * Must be the identifier of an existing MySQL, MariaDB, Oracle,
     #     PostgreSQL, or SQL Server DB instance.
     #
-    #   * Can specify a DB instance that is a MySQL read replica only if the
-    #     source is running MySQL 5.6 or later.
-    #
-    #   * For the limitations of Oracle read replicas, see [Read Replica
-    #     Limitations with Oracle][1] in the *Amazon RDS User Guide*.
+    #   * Can't be specified if the `SourceDBClusterIdentifier` parameter is
+    #     also specified.
     #
-    #   * For the limitations of SQL Server read replicas, see [Read Replica
-    #     Limitations with Microsoft SQL Server][2] in the *Amazon RDS User
-    #     Guide*.
+    #   * For the limitations of Oracle read replicas, see [Version and
+    #     licensing considerations for RDS for Oracle replicas][1] in the
+    #     *Amazon RDS User Guide*.
     #
-    #   * Can specify a PostgreSQL DB instance only if the source is running
-    #     PostgreSQL 9.3.5 or later (9.4.7 and higher for cross-Region
-    #     replication).
+    #   * For the limitations of SQL Server read replicas, see [Read replica
+    #     limitations with SQL Server][2] in the *Amazon RDS User Guide*.
     #
     #   * The specified DB instance must have automatic backups enabled, that
     #     is, its backup retention period must be greater than 0.
@@ -5066,8 +5050,8 @@ module Aws::RDS
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.Limitations.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.limitations.html#oracle-read-replicas.limitations.versions-and-licenses
+    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.html#SQLServer.ReadReplicas.Limitations
     #   [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing
     #
     # @option params [String] :db_instance_class
@@ -5105,8 +5089,8 @@ module Aws::RDS
     #   You can create a read replica as a Multi-AZ DB instance. RDS creates a
     #   standby of your replica in another Availability Zone for failover
     #   support for the replica. Creating your read replica as a Multi-AZ DB
-    #   instance is independent of whether the source database is a Multi-AZ
-    #   DB instance.
+    #   instance is independent of whether the source is a Multi-AZ DB
+    #   instance or a Multi-AZ DB cluster.
     #
     #   This setting doesn't apply to RDS Custom.
     #
@@ -5124,10 +5108,10 @@ module Aws::RDS
     #
     # @option params [String] :option_group_name
     #   The option group the DB instance is associated with. If omitted, the
-    #   option group associated with the source instance is used.
+    #   option group associated with the source instance or cluster is used.
     #
     #   <note markdown="1"> For SQL Server, you must use the option group associated with the
-    #   source instance.
+    #   source.
     #
     #    </note>
     #
@@ -5262,10 +5246,10 @@ module Aws::RDS
     #   alias ARN, or alias name for the KMS key.
     #
     #   If you create an encrypted read replica in the same Amazon Web
-    #   Services Region as the source DB instance, then do not specify a value
-    #   for this parameter. A read replica in the same Amazon Web Services
-    #   Region is always encrypted with the same KMS key as the source DB
-    #   instance.
+    #   Services Region as the source DB instance or Multi-AZ DB cluster,
+    #   don't specify a value for this parameter. A read replica in the same
+    #   Amazon Web Services Region is always encrypted with the same KMS key
+    #   as the source DB instance or cluster.
     #
     #   If you create an encrypted read replica in a different Amazon Web
     #   Services Region, then you must specify a KMS key identifier for the
@@ -5275,7 +5259,7 @@ module Aws::RDS
     #   Services Region.
     #
     #   You can't create an encrypted read replica from an unencrypted DB
-    #   instance.
+    #   instance or Multi-AZ DB cluster.
     #
     #   This setting doesn't apply to RDS Custom, which uses the same KMS key
     #   as the primary replica.
@@ -5292,6 +5276,10 @@ module Aws::RDS
     #   and China Amazon Web Services Regions. It's ignored in other Amazon
     #   Web Services Regions.
     #
+    #   This setting applies only when replicating from a source DB
+    #   *instance*. Source DB clusters aren't supported in Amazon Web
+    #   Services GovCloud (US) Regions and China Amazon Web Services Regions.
+    #
     #   You must specify this parameter when you create an encrypted read
     #   replica from another Amazon Web Services Region by using the Amazon
     #   RDS API. Don't specify `PreSignedUrl` when you are creating an
@@ -5471,8 +5459,8 @@ module Aws::RDS
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     #
     # @option params [String] :domain_iam_role_name
-    #   Specify the name of the IAM role to be used when making API calls to
-    #   the Directory Service.
+    #   The name of the IAM role to be used when making API calls to the
+    #   Directory Service.
     #
     #   This setting doesn't apply to RDS Custom.
     #
@@ -5594,6 +5582,23 @@ module Aws::RDS
     #
     #    </note>
     #
+    # @option params [String] :source_db_cluster_identifier
+    #   The identifier of the Multi-AZ DB cluster that will act as the source
+    #   for the read replica. Each DB cluster can have up to 15 read replicas.
+    #
+    #   Constraints:
+    #
+    #   * Must be the identifier of an existing Multi-AZ DB cluster.
+    #
+    #   * Can't be specified if the `SourceDBInstanceIdentifier` parameter is
+    #     also specified.
+    #
+    #   * The specified DB cluster must have automatic backups enabled, that
+    #     is, its backup retention period must be greater than 0.
+    #
+    #   * The source DB cluster must be in the same Amazon Web Services Region
+    #     as the read replica. Cross-Region replication isn't supported.
+    #
     # @option params [String] :source_region
     #   The source region of the snapshot. This is only needed when the
     #   shapshot is encrypted and in a different region.
@@ -5633,7 +5638,7 @@ module Aws::RDS
     #
     #   resp = client.create_db_instance_read_replica({
     #     db_instance_identifier: "String", # required
-    #     source_db_instance_identifier: "String", # required
+    #     source_db_instance_identifier: "String",
     #     db_instance_class: "String",
     #     availability_zone: "String",
     #     port: 1,
@@ -5679,6 +5684,7 @@ module Aws::RDS
     #     storage_throughput: 1,
     #     enable_customer_owned_ip: false,
     #     allocated_storage: 1,
+    #     source_db_cluster_identifier: "String",
     #     source_region: "String",
     #   })
     #
@@ -5832,6 +5838,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica AWS API Documentation
     #
@@ -7136,6 +7143,10 @@ module Aws::RDS
     # DB cluster are deleted and can't be recovered. Manual DB cluster
     # snapshots of the specified DB cluster are not deleted.
     #
+    # If you're deleting a Multi-AZ DB cluster with read replicas, all
+    # cluster members are terminated and read replicas are promoted to
+    # standalone instances.
+    #
     # For more information on Amazon Aurora, see [ What is Amazon
     # Aurora?][1] in the *Amazon Aurora User Guide*.
     #
@@ -7801,6 +7812,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance AWS API Documentation
     #
@@ -9568,8 +9580,6 @@ module Aws::RDS
     #
     #   Valid Values:
     #
-    #   * `aurora` (for MySQL 5.6-compatible Aurora)
-    #
     #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
     #     Aurora)
     #
@@ -10187,6 +10197,7 @@ module Aws::RDS
     #   resp.db_instances[0].master_user_secret.kms_key_id #=> String
     #   resp.db_instances[0].certificate_details.ca_identifier #=> String
     #   resp.db_instances[0].certificate_details.valid_till #=> Time
+    #   resp.db_instances[0].read_replica_source_db_cluster_identifier #=> String
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -12370,8 +12381,6 @@ module Aws::RDS
     #
     #   Valid Values:
     #
-    #   * `aurora` (for MySQL 5.6-compatible Aurora)
-    #
     #   * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
     #     Aurora)
     #
@@ -14199,16 +14208,21 @@ module Aws::RDS
     #   applied during the next maintenance window unless `ApplyImmediately`
     #   is enabled.
     #
-    #   To list all of the available engine versions for MySQL 5.6-compatible
-    #   Aurora, use the following command:
+    #   If the cluster that you're modifying has one or more read replicas,
+    #   all replicas must be running an engine version that's the same or
+    #   later than the version you specify.
     #
-    #   `aws rds describe-db-engine-versions --engine aurora --query
+    #   To list all of the available engine versions for Aurora MySQL version
+    #   2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
+    #   following command:
+    #
+    #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
     #
-    #   To list all of the available engine versions for MySQL 5.7-compatible
-    #   and MySQL 8.0-compatible Aurora, use the following command:
+    #   To list all of the available engine versions for MySQL 5.6-compatible
+    #   Aurora, use the following command:
     #
-    #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
+    #   `aws rds describe-db-engine-versions --engine aurora --query
     #   "DBEngineVersions[].EngineVersion"`
     #
     #   To list all of the available engine versions for Aurora PostgreSQL,
@@ -15411,6 +15425,10 @@ module Aws::RDS
     #   lower. For information about valid engine versions, see
     #   `CreateDBInstance`, or call `DescribeDBEngineVersions`.
     #
+    #   If the instance that you're modifying is acting as a read replica,
+    #   the engine version that you specify must be the same or later than the
+    #   version that the source DB instance or cluster is running.
+    #
     #   In RDS Custom for Oracle, this parameter is supported for read
     #   replicas only if they are in the `PATCH_DB_FAILURE` lifecycle.
     #
@@ -16283,6 +16301,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance AWS API Documentation
     #
@@ -17528,6 +17547,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica AWS API Documentation
     #
@@ -18148,6 +18168,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance AWS API Documentation
     #
@@ -18749,30 +18770,22 @@ module Aws::RDS
     # @option params [required, String] :engine
     #   The name of the database engine to be used for this DB cluster.
     #
-    #   Valid Values: `aurora` (for MySQL 5.6-compatible Aurora) and
-    #   `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
-    #   Aurora)
+    #   Valid Values: `aurora-mysql` (for MySQL 5.7-compatible and MySQL
+    #   8.0-compatible Aurora)
     #
     # @option params [String] :engine_version
     #   The version number of the database engine to use.
     #
-    #   To list all of the available engine versions for `aurora` (for MySQL
-    #   5.6-compatible Aurora), use the following command:
-    #
-    #   `aws rds describe-db-engine-versions --engine aurora --query
-    #   "DBEngineVersions[].EngineVersion"`
-    #
-    #   To list all of the available engine versions for `aurora-mysql` (for
-    #   MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use the
-    #   following command:
+    #   To list all of the available engine versions for `aurora-mysql` (MySQL
+    #   5.7-compatible and MySQL 8.0-compatible Aurora), use the following
+    #   command:
     #
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
     #
     #   **Aurora MySQL**
     #
-    #   Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`,
-    #   `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
+    #   Examples: `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
     #
     # @option params [Integer] :port
     #   The port number on which the instances in the restored DB cluster
@@ -18945,10 +18958,6 @@ module Aws::RDS
     #
     #   Possible values are `audit`, `error`, `general`, and `slowquery`.
     #
-    #   **Aurora PostgreSQL**
-    #
-    #   Possible value is `postgresql`.
-    #
     #   For more information about exporting CloudWatch Logs for Amazon
     #   Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][1] in
     #   the *Amazon Aurora User Guide*.
@@ -19307,13 +19316,9 @@ module Aws::RDS
     #   Valid for: Aurora DB clusters and Multi-AZ DB clusters
     #
     # @option params [String] :engine_version
-    #   The version of the database engine to use for the new DB cluster.
-    #
-    #   To list all of the available engine versions for MySQL 5.6-compatible
-    #   Aurora, use the following command:
-    #
-    #   `aws rds describe-db-engine-versions --engine aurora --query
-    #   "DBEngineVersions[].EngineVersion"`
+    #   The version of the database engine to use for the new DB cluster. If
+    #   you don't specify an engine version, the default version for the
+    #   database engine in the Amazon Web Services Region is used.
     #
     #   To list all of the available engine versions for MySQL 5.7-compatible
     #   and MySQL 8.0-compatible Aurora, use the following command:
@@ -19341,8 +19346,8 @@ module Aws::RDS
     #
     #   **Aurora MySQL**
     #
-    #   See [MySQL on Amazon RDS Versions][1] in the *Amazon Aurora User
-    #   Guide*.
+    #   See [Database engine updates for Amazon Aurora MySQL][1] in the
+    #   *Amazon Aurora User Guide*.
     #
     #   **Aurora PostgreSQL**
     #
@@ -19351,7 +19356,7 @@ module Aws::RDS
     #
     #   **MySQL**
     #
-    #   See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
+    #   See [Amazon RDS for MySQL][3] in the *Amazon RDS User Guide.*
     #
     #   **PostgreSQL**
     #
@@ -21251,6 +21256,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshot AWS API Documentation
     #
@@ -21977,6 +21983,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3 AWS API Documentation
     #
@@ -22741,6 +22748,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTime AWS API Documentation
     #
@@ -23259,6 +23267,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstance AWS API Documentation
     #
@@ -23405,8 +23414,8 @@ module Aws::RDS
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html
-    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/aurora-export-snapshot.html
-    # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/export-cluster-data.html
+    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-export-snapshot.html
+    # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/export-cluster-data.html
     #
     # @option params [required, String] :export_task_identifier
     #   A unique identifier for the export task. This ID isn't an identifier
@@ -23424,6 +23433,28 @@ module Aws::RDS
     #   The name of the IAM role to use for writing to the Amazon S3 bucket
     #   when exporting a snapshot or cluster.
     #
+    #   In the IAM policy attached to your IAM role, include the following
+    #   required actions to allow the transfer of files from Amazon RDS or
+    #   Amazon Aurora to an S3 bucket:
+    #
+    #   * s3:PutObject*
+    #
+    #   * s3:GetObject*
+    #
+    #   * s3:ListBucket
+    #
+    #   * s3:DeleteObject*
+    #
+    #   * s3:GetBucketLocation
+    #
+    #   In the policy, include the resources to identify the S3 bucket and
+    #   objects in the bucket. The following list of resources shows the
+    #   Amazon Resource Name (ARN) format for accessing S3:
+    #
+    #   * `arn:aws:s3:::your-s3-bucket `
+    #
+    #   * `arn:aws:s3:::your-s3-bucket/*`
+    #
     # @option params [required, String] :kms_key_id
     #   The ID of the Amazon Web Services KMS key to use to encrypt the data
     #   exported to Amazon S3. The Amazon Web Services KMS key identifier is
@@ -23923,6 +23954,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstance AWS API Documentation
     #
@@ -23947,7 +23979,7 @@ module Aws::RDS
     #
     # @option params [required, String] :source_db_instance_arn
     #   The Amazon Resource Name (ARN) of the source DB instance for which to
-    #   stop replicating automated backups, for example,
+    #   stop replicating automate backups, for example,
     #   `arn:aws:rds:us-west-2:123456789012:db:mydatabase`.
     #
     # @return [Types::StopDBInstanceAutomatedBackupsReplicationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -24250,6 +24282,7 @@ module Aws::RDS
     #   resp.db_instance.master_user_secret.kms_key_id #=> String
     #   resp.db_instance.certificate_details.ca_identifier #=> String
     #   resp.db_instance.certificate_details.valid_till #=> Time
+    #   resp.db_instance.read_replica_source_db_cluster_identifier #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/SwitchoverReadReplica AWS API Documentation
     #
@@ -24273,7 +24306,7 @@ module Aws::RDS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.172.0'
+      context[:gem_version] = '1.174.0'
       Seahorse::Client::Request.new(handlers, context)
     end