aws-sdk-rds 1.173.0 → 1.175.0

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

@@ -1029,7 +1029,7 @@ module Aws::RDS
     CreateDBInstanceMessage.struct_class = Types::CreateDBInstanceMessage
 
     CreateDBInstanceReadReplicaMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
-    CreateDBInstanceReadReplicaMessage.add_member(:source_db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "SourceDBInstanceIdentifier"))
+    CreateDBInstanceReadReplicaMessage.add_member(:source_db_instance_identifier, Shapes::ShapeRef.new(shape: String, location_name: "SourceDBInstanceIdentifier"))
     CreateDBInstanceReadReplicaMessage.add_member(:db_instance_class, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceClass"))
     CreateDBInstanceReadReplicaMessage.add_member(:availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "AvailabilityZone"))
     CreateDBInstanceReadReplicaMessage.add_member(:port, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "Port"))
@@ -1065,6 +1065,7 @@ module Aws::RDS
     CreateDBInstanceReadReplicaMessage.add_member(:storage_throughput, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "StorageThroughput"))
     CreateDBInstanceReadReplicaMessage.add_member(:enable_customer_owned_ip, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableCustomerOwnedIp"))
     CreateDBInstanceReadReplicaMessage.add_member(:allocated_storage, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "AllocatedStorage"))
+    CreateDBInstanceReadReplicaMessage.add_member(:source_db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "SourceDBClusterIdentifier"))
     CreateDBInstanceReadReplicaMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
     CreateDBInstanceReadReplicaMessage.struct_class = Types::CreateDBInstanceReadReplicaMessage
 
@@ -1524,6 +1525,7 @@ module Aws::RDS
     DBInstance.add_member(:db_system_id, Shapes::ShapeRef.new(shape: String, location_name: "DBSystemId"))
     DBInstance.add_member(:master_user_secret, Shapes::ShapeRef.new(shape: MasterUserSecret, location_name: "MasterUserSecret"))
     DBInstance.add_member(:certificate_details, Shapes::ShapeRef.new(shape: CertificateDetails, location_name: "CertificateDetails"))
+    DBInstance.add_member(:read_replica_source_db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ReadReplicaSourceDBClusterIdentifier"))
     DBInstance.struct_class = Types::DBInstance
 
     DBInstanceAlreadyExistsFault.struct_class = Types::DBInstanceAlreadyExistsFault
@@ -3963,7 +3965,9 @@ module Aws::RDS
         o.errors << Shapes::ShapeRef.new(shape: InstanceQuotaExceededFault)
         o.errors << Shapes::ShapeRef.new(shape: StorageQuotaExceededFault)
         o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
+        o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
         o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
         o.errors << Shapes::ShapeRef.new(shape: DBSubnetGroupNotFoundFault)
         o.errors << Shapes::ShapeRef.new(shape: DBSubnetGroupDoesNotCoverEnoughAZs)
         o.errors << Shapes::ShapeRef.new(shape: InvalidSubnet)

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

@@ -1102,8 +1102,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 options [Array<Types::Tag>] :tags
     #   Tags to assign to the DB cluster.
     #
@@ -1808,14 +1807,10 @@ module Aws::RDS
     #   the DB cluster. If this parameter is disabled, changes to the DB
     #   cluster are applied during the next maintenance window.
     #
-    #   The `ApplyImmediately` parameter only affects the
-    #   `EnableIAMDatabaseAuthentication`, `MasterUserPassword`, and
-    #   `NewDBClusterIdentifier` values. If the `ApplyImmediately` parameter
-    #   is disabled, then changes to the `EnableIAMDatabaseAuthentication`,
-    #   `MasterUserPassword`, and `NewDBClusterIdentifier` values are applied
-    #   during the next maintenance window. All other changes are applied
-    #   immediately, regardless of the value of the `ApplyImmediately`
-    #   parameter.
+    #   Most modifications can be applied immediately or during the next
+    #   scheduled maintenance window. Some modifications, such as turning on
+    #   deletion protection and changing the master password, are applied
+    #   immediately—regardless of when you choose to apply them.
     #
     #   By default, this parameter is disabled.
     #
@@ -1980,6 +1975,10 @@ module Aws::RDS
     #   applied during the next maintenance window unless `ApplyImmediately`
     #   is enabled.
     #
+    #   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.
+    #
     #   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:
@@ -1987,6 +1986,12 @@ module Aws::RDS
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
     #
+    #   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 Aurora PostgreSQL,
     #   use the following command:
     #

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

@@ -771,6 +771,13 @@ module Aws::RDS
       data[:certificate_details]
     end
 
+    # Contains the identifier of the source DB cluster if this DB instance
+    # is a read replica.
+    # @return [String]
+    def read_replica_source_db_cluster_identifier
+      data[:read_replica_source_db_cluster_identifier]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -1216,13 +1223,15 @@ module Aws::RDS
     #
     #   * `aurora-postgresql`
     #
-    #   * `custom-oracle-ee (for RDS Custom for Oracle instances)`
+    #   * `custom-oracle-ee (for RDS Custom for Oracle DB instances)`
+    #
+    #   * `custom-oracle-ee-cdb (for RDS Custom for Oracle DB instances)`
     #
-    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server DB instances)`
     #
-    #   * `custom-sqlserver-se (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-se (for RDS Custom for SQL Server DB instances)`
     #
-    #   * `custom-sqlserver-web (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-web (for RDS Custom for SQL Server DB instances)`
     #
     #   * `mariadb`
     #
@@ -2131,6 +2140,7 @@ module Aws::RDS
     #     storage_throughput: 1,
     #     enable_customer_owned_ip: false,
     #     allocated_storage: 1,
+    #     source_db_cluster_identifier: "String",
     #     source_region: "String",
     #   })
     # @param [Hash] options ({})
@@ -2170,8 +2180,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.
     # @option options [Boolean] :auto_minor_version_upgrade
@@ -2186,10 +2196,10 @@ module Aws::RDS
     #   be initially allocated for the DB instance.
     # @option options [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>
     #
@@ -2242,9 +2252,6 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * Can only be specified if the source DB instance identifier specifies
-    #     a DB instance in another Amazon Web Services Region.
-    #
     #   * If supplied, must match the name of an existing DBSubnetGroup.
     #
     #   * The specified DB subnet group must be in the same Amazon Web
@@ -2314,10 +2321,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
@@ -2327,7 +2334,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.
@@ -2343,6 +2350,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
@@ -2512,8 +2523,8 @@ module Aws::RDS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [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.
     # @option options [String] :replica_mode
@@ -2627,6 +2638,22 @@ module Aws::RDS
     #   for future growth.
     #
     #    </note>
+    # @option options [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 options [String] :source_region
     #   The source region of the snapshot. This is only needed when the
     #   shapshot is encrypted and in a different region.
@@ -3091,6 +3118,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.
     # @option options [Boolean] :allow_major_version_upgrade

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

@@ -353,8 +353,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 options [Array<Types::Tag>] :tags
     #   Tags to assign to the DB cluster.
     #
@@ -1286,13 +1285,15 @@ module Aws::RDS
     #
     #   * `aurora-postgresql`
     #
-    #   * `custom-oracle-ee (for RDS Custom for Oracle instances)`
+    #   * `custom-oracle-ee (for RDS Custom for Oracle DB instances)`
+    #
+    #   * `custom-oracle-ee-cdb (for RDS Custom for Oracle DB instances)`
     #
-    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server DB instances)`
     #
-    #   * `custom-sqlserver-se (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-se (for RDS Custom for SQL Server DB instances)`
     #
-    #   * `custom-sqlserver-web (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-web (for RDS Custom for SQL Server DB instances)`
     #
     #   * `mariadb`
     #
@@ -2673,6 +2674,10 @@ module Aws::RDS
     #     Amazon Resource Names (ARNs). The results list only includes
     #     information about the DB clusters identified by these ARNs.
     #
+    #   * `db-cluster-resource-id` - Accepts DB cluster resource identifiers.
+    #     The results list will only include information about the DB clusters
+    #     identified by these DB cluster resource identifiers.
+    #
     #   * `domain` - Accepts Active Directory directory IDs. The results list
     #     only includes information about the DB clusters associated with
     #     these domains.

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

@@ -2214,8 +2214,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
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -3311,13 +3310,16 @@ module Aws::RDS
     #
     #   * `aurora-postgresql`
     #
-    #   * `custom-oracle-ee (for RDS Custom for Oracle instances)`
+    #   * `custom-oracle-ee (for RDS Custom for Oracle DB instances)`
+    #
+    #   * `custom-oracle-ee-cdb (for RDS Custom for Oracle DB instances)`
     #
-    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-ee (for RDS Custom for SQL Server DB instances)`
     #
-    #   * `custom-sqlserver-se (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-se (for RDS Custom for SQL Server DB instances)`
     #
-    #   * `custom-sqlserver-web (for RDS Custom for SQL Server instances)`
+    #   * `custom-sqlserver-web (for RDS Custom for SQL Server DB
+    #     instances)`
     #
     #   * `mariadb`
     #
@@ -4345,27 +4347,24 @@ module Aws::RDS
     #
     # @!attribute [rw] 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.
+    #   the 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.
+    #   * Can't be specified if the `SourceDBClusterIdentifier` parameter
+    #     is also specified.
     #
-    #   * For the limitations of Oracle read replicas, see [Read Replica
-    #     Limitations with Oracle][1] 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*.
     #
-    #   * For the limitations of SQL Server read replicas, see [Read Replica
-    #     Limitations with Microsoft SQL Server][2] 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.
@@ -4382,8 +4381,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
     #   @return [String]
     #
@@ -4425,8 +4424,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.
     #   @return [Boolean]
@@ -4447,10 +4446,10 @@ module Aws::RDS
     #
     # @!attribute [rw] 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>
     #
@@ -4514,9 +4513,6 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * Can only be specified if the source DB instance identifier
-    #     specifies a DB instance in another Amazon Web Services Region.
-    #
     #   * If supplied, must match the name of an existing DBSubnetGroup.
     #
     #   * The specified DB subnet group must be in the same Amazon Web
@@ -4599,10 +4595,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
@@ -4612,7 +4608,7 @@ module Aws::RDS
     #   Web 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.
@@ -4630,6 +4626,11 @@ module Aws::RDS
     #   Regions 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
@@ -4822,8 +4823,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] 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.
     #   @return [String]
@@ -4954,6 +4955,26 @@ module Aws::RDS
     #    </note>
     #   @return [Integer]
     #
+    # @!attribute [rw] 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.
+    #   @return [String]
+    #
     # @!attribute [rw] source_region
     #   The source region of the snapshot. This is only needed when the
     #   shapshot is encrypted and in a different region.
@@ -4999,6 +5020,7 @@ module Aws::RDS
       :storage_throughput,
       :enable_customer_owned_ip,
       :allocated_storage,
+      :source_db_cluster_identifier,
       :source_region)
       SENSITIVE = []
       include Aws::Structure
@@ -5585,7 +5607,8 @@ module Aws::RDS
     end
 
     # @!attribute [rw] global_cluster_identifier
-    #   The cluster identifier of the new global database cluster.
+    #   The cluster identifier of the new global database cluster. This
+    #   parameter is stored as a lowercase string.
     #   @return [String]
     #
     # @!attribute [rw] source_db_cluster_identifier
@@ -7983,6 +8006,11 @@ module Aws::RDS
     #   The details of the DB instance's server certificate.
     #   @return [Types::CertificateDetails]
     #
+    # @!attribute [rw] read_replica_source_db_cluster_identifier
+    #   Contains the identifier of the source DB cluster if this DB instance
+    #   is a read replica.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstance AWS API Documentation
     #
     class DBInstance < Struct.new(
@@ -8065,7 +8093,8 @@ module Aws::RDS
       :storage_throughput,
       :db_system_id,
       :master_user_secret,
-      :certificate_details)
+      :certificate_details,
+      :read_replica_source_db_cluster_identifier)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9592,8 +9621,8 @@ module Aws::RDS
     end
 
     # @!attribute [rw] engine
-    #   The database engine. The only supported engine is
-    #   `custom-oracle-ee`.
+    #   The database engine. The only supported engines are
+    #   `custom-oracle-ee` and `custom-oracle-ee-cdb`.
     #   @return [String]
     #
     # @!attribute [rw] engine_version
@@ -10706,6 +10735,11 @@ module Aws::RDS
     #     Amazon Resource Names (ARNs). The results list only includes
     #     information about the DB clusters identified by these ARNs.
     #
+    #   * `db-cluster-resource-id` - Accepts DB cluster resource
+    #     identifiers. The results list will only include information about
+    #     the DB clusters identified by these DB cluster resource
+    #     identifiers.
+    #
     #   * `domain` - Accepts Active Directory directory IDs. The results
     #     list only includes information about the DB clusters associated
     #     with these domains.
@@ -14254,7 +14288,8 @@ module Aws::RDS
     end
 
     # @!attribute [rw] engine
-    #   The DB engine. The only supported value is `custom-oracle-ee`.
+    #   The DB engine. The only supported values are `custom-oracle-ee` and
+    #   `custom-oracle-ee-cdb`.
     #   @return [String]
     #
     # @!attribute [rw] engine_version
@@ -14368,14 +14403,10 @@ module Aws::RDS
     #   the DB cluster. If this parameter is disabled, changes to the DB
     #   cluster are applied during the next maintenance window.
     #
-    #   The `ApplyImmediately` parameter only affects the
-    #   `EnableIAMDatabaseAuthentication`, `MasterUserPassword`, and
-    #   `NewDBClusterIdentifier` values. If the `ApplyImmediately` parameter
-    #   is disabled, then changes to the `EnableIAMDatabaseAuthentication`,
-    #   `MasterUserPassword`, and `NewDBClusterIdentifier` values are
-    #   applied during the next maintenance window. All other changes are
-    #   applied immediately, regardless of the value of the
-    #   `ApplyImmediately` parameter.
+    #   Most modifications can be applied immediately or during the next
+    #   scheduled maintenance window. Some modifications, such as turning on
+    #   deletion protection and changing the master password, are applied
+    #   immediately—regardless of when you choose to apply them.
     #
     #   By default, this parameter is disabled.
     #
@@ -14566,6 +14597,10 @@ module Aws::RDS
     #   applied during the next maintenance window unless `ApplyImmediately`
     #   is enabled.
     #
+    #   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.
+    #
     #   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:
@@ -14573,6 +14608,12 @@ module Aws::RDS
     #   `aws rds describe-db-engine-versions --engine aurora-mysql --query
     #   "DBEngineVersions[].EngineVersion"`
     #
+    #   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 Aurora PostgreSQL,
     #   use the following command:
     #
@@ -15496,6 +15537,10 @@ module Aws::RDS
     #   is 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.
     #   @return [String]
@@ -22950,7 +22995,7 @@ module Aws::RDS
 
     # @!attribute [rw] source_db_instance_arn
     #   The Amazon Resource Name (ARN) of the source DB instance for which
-    #   to stop replicating automated backups, for example,
+    #   to stop replicating automate backups, for example,
     #   `arn:aws:rds:us-west-2:123456789012:db:mydatabase`.
     #   @return [String]
     #

data/lib/aws-sdk-rds.rb

@@ -78,6 +78,6 @@ require_relative 'aws-sdk-rds/customizations'
 # @!group service
 module Aws::RDS
 
-  GEM_VERSION = '1.173.0'
+  GEM_VERSION = '1.175.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rds
 version: !ruby/object:Gem::Version
-  version: 1.173.0
+  version: 1.175.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-24 00:00:00.000000000 Z
+date: 2023-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sigv4