@aws-sdk/client-rds 3.301.0 → 3.302.0

package/dist-cjs/protocols/Aws_query.js

@@ -2825,6 +2825,9 @@ const deserializeAws_queryCreateDBInstanceReadReplicaCommandError = async (outpu
     };
     const errorCode = loadQueryErrorCode(output, parsedOutput.body);
     switch (errorCode) {
+        case "DBClusterNotFoundFault":
+        case "com.amazonaws.rds#DBClusterNotFoundFault":
+            throw await deserializeAws_queryDBClusterNotFoundFaultResponse(parsedOutput, context);
         case "DBInstanceAlreadyExists":
         case "com.amazonaws.rds#DBInstanceAlreadyExistsFault":
             throw await deserializeAws_queryDBInstanceAlreadyExistsFaultResponse(parsedOutput, context);
@@ -2855,6 +2858,9 @@ const deserializeAws_queryCreateDBInstanceReadReplicaCommandError = async (outpu
         case "InsufficientDBInstanceCapacity":
         case "com.amazonaws.rds#InsufficientDBInstanceCapacityFault":
             throw await deserializeAws_queryInsufficientDBInstanceCapacityFaultResponse(parsedOutput, context);
+        case "InvalidDBClusterStateFault":
+        case "com.amazonaws.rds#InvalidDBClusterStateFault":
+            throw await deserializeAws_queryInvalidDBClusterStateFaultResponse(parsedOutput, context);
         case "InvalidDBInstanceState":
         case "com.amazonaws.rds#InvalidDBInstanceStateFault":
             throw await deserializeAws_queryInvalidDBInstanceStateFaultResponse(parsedOutput, context);
@@ -9985,6 +9991,9 @@ const serializeAws_queryCreateDBInstanceReadReplicaMessage = (input, context) =>
     if (input.AllocatedStorage != null) {
         entries["AllocatedStorage"] = input.AllocatedStorage;
     }
+    if (input.SourceDBClusterIdentifier != null) {
+        entries["SourceDBClusterIdentifier"] = input.SourceDBClusterIdentifier;
+    }
     return entries;
 };
 const serializeAws_queryCreateDBParameterGroupMessage = (input, context) => {
@@ -15545,6 +15554,9 @@ const deserializeAws_queryDBInstance = (output, context) => {
     if (output["CertificateDetails"] !== undefined) {
         contents.CertificateDetails = deserializeAws_queryCertificateDetails(output["CertificateDetails"], context);
     }
+    if (output["ReadReplicaSourceDBClusterIdentifier"] !== undefined) {
+        contents.ReadReplicaSourceDBClusterIdentifier = (0, smithy_client_1.expectString)(output["ReadReplicaSourceDBClusterIdentifier"]);
+    }
     return contents;
 };
 const deserializeAws_queryDBInstanceAlreadyExistsFault = (output, context) => {

package/dist-es/protocols/Aws_query.js

@@ -2655,6 +2655,9 @@ const deserializeAws_queryCreateDBInstanceReadReplicaCommandError = async (outpu
     };
     const errorCode = loadQueryErrorCode(output, parsedOutput.body);
     switch (errorCode) {
+        case "DBClusterNotFoundFault":
+        case "com.amazonaws.rds#DBClusterNotFoundFault":
+            throw await deserializeAws_queryDBClusterNotFoundFaultResponse(parsedOutput, context);
         case "DBInstanceAlreadyExists":
         case "com.amazonaws.rds#DBInstanceAlreadyExistsFault":
             throw await deserializeAws_queryDBInstanceAlreadyExistsFaultResponse(parsedOutput, context);
@@ -2685,6 +2688,9 @@ const deserializeAws_queryCreateDBInstanceReadReplicaCommandError = async (outpu
         case "InsufficientDBInstanceCapacity":
         case "com.amazonaws.rds#InsufficientDBInstanceCapacityFault":
             throw await deserializeAws_queryInsufficientDBInstanceCapacityFaultResponse(parsedOutput, context);
+        case "InvalidDBClusterStateFault":
+        case "com.amazonaws.rds#InvalidDBClusterStateFault":
+            throw await deserializeAws_queryInvalidDBClusterStateFaultResponse(parsedOutput, context);
         case "InvalidDBInstanceState":
         case "com.amazonaws.rds#InvalidDBInstanceStateFault":
             throw await deserializeAws_queryInvalidDBInstanceStateFaultResponse(parsedOutput, context);
@@ -9695,6 +9701,9 @@ const serializeAws_queryCreateDBInstanceReadReplicaMessage = (input, context) =>
     if (input.AllocatedStorage != null) {
         entries["AllocatedStorage"] = input.AllocatedStorage;
     }
+    if (input.SourceDBClusterIdentifier != null) {
+        entries["SourceDBClusterIdentifier"] = input.SourceDBClusterIdentifier;
+    }
     return entries;
 };
 const serializeAws_queryCreateDBParameterGroupMessage = (input, context) => {
@@ -15255,6 +15264,9 @@ const deserializeAws_queryDBInstance = (output, context) => {
     if (output["CertificateDetails"] !== undefined) {
         contents.CertificateDetails = deserializeAws_queryCertificateDetails(output["CertificateDetails"], context);
     }
+    if (output["ReadReplicaSourceDBClusterIdentifier"] !== undefined) {
+        contents.ReadReplicaSourceDBClusterIdentifier = __expectString(output["ReadReplicaSourceDBClusterIdentifier"]);
+    }
     return contents;
 };
 const deserializeAws_queryDBInstanceAlreadyExistsFault = (output, context) => {

package/dist-types/RDS.d.ts

@@ -396,13 +396,14 @@ export declare class RDS extends RDSClient {
      *             request creates a writer and two reader DB instances for you, each in a different
      *             Availability Zone.</p>
      *          <p>You can use the <code>ReplicationSourceIdentifier</code> parameter to create an Amazon
-     *             Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL or
+     *             Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for MySQL or
      *             PostgreSQL DB instance. For more information about Amazon Aurora, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">What is Amazon Aurora?</a> in the <i>Amazon Aurora User
-     *                     Guide</i>.</p>
+     *             Guide</i>.</p>
      *          <p>You can also use the <code>ReplicationSourceIdentifier</code> 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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html">Multi-AZ DB cluster deployments</a> in the <i>Amazon
-     *                     RDS User Guide</i>.</p>
+     *             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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html">Multi-AZ DB
+     *                 cluster deployments</a> in the <i>Amazon RDS User
+     *             Guide</i>.</p>
      */
     createDBCluster(args: CreateDBClusterCommandInput, options?: __HttpHandlerOptions): Promise<CreateDBClusterCommandOutput>;
     createDBCluster(args: CreateDBClusterCommandInput, cb: (err: any, data?: CreateDBClusterCommandOutput) => void): void;
@@ -483,16 +484,17 @@ export declare class RDS extends RDSClient {
     /**
      * @public
      * <p>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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html">Working with Read
-     *                 Replicas</a> in the <i>Amazon RDS User Guide</i>.</p>
+     *             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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html">Working
+     *                 with read replicas</a> and <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html#multi-az-db-clusters-migrating-to-instance-with-read-replica">Migrating from a Multi-AZ DB cluster to a DB instance using a read replica</a> in the <i>Amazon RDS User Guide</i>.</p>
      *          <p>Amazon Aurora doesn't support this operation. Call the <code>CreateDBInstance</code>
      *             operation to create a DB instance for an Aurora DB cluster.</p>
-     *          <p>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.</p>
+     *          <p>All read replica DB instances are created with backups disabled. All other attributes
+     *             (including DB security groups and DB parameter groups) are inherited from the source DB
+     *             instance or cluster, except as specified.</p>
      *          <important>
-     *             <p>Your source DB instance must have backup retention enabled.</p>
+     *             <p>Your source DB instance or cluster must have backup retention enabled.</p>
      *          </important>
      */
     createDBInstanceReadReplica(args: CreateDBInstanceReadReplicaCommandInput, options?: __HttpHandlerOptions): Promise<CreateDBInstanceReadReplicaCommandOutput>;
@@ -671,6 +673,8 @@ export declare class RDS extends RDSClient {
      * <p>The DeleteDBCluster action deletes a previously provisioned DB cluster.
      *           When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered.
      *           Manual DB cluster snapshots of the specified DB cluster are not deleted.</p>
+     *          <p>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.</p>
      *          <p>For more information on Amazon Aurora, see
      *           <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
      *               What is Amazon Aurora?</a> in the <i>Amazon Aurora User Guide</i>.</p>

package/dist-types/commands/CreateDBClusterCommand.d.ts

@@ -25,13 +25,14 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M
  *             request creates a writer and two reader DB instances for you, each in a different
  *             Availability Zone.</p>
  *          <p>You can use the <code>ReplicationSourceIdentifier</code> parameter to create an Amazon
- *             Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL or
+ *             Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for MySQL or
  *             PostgreSQL DB instance. For more information about Amazon Aurora, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">What is Amazon Aurora?</a> in the <i>Amazon Aurora User
- *                     Guide</i>.</p>
+ *             Guide</i>.</p>
  *          <p>You can also use the <code>ReplicationSourceIdentifier</code> 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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html">Multi-AZ DB cluster deployments</a> in the <i>Amazon
- *                     RDS User Guide</i>.</p>
+ *             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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html">Multi-AZ DB
+ *                 cluster deployments</a> in the <i>Amazon RDS User
+ *             Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateDBInstanceReadReplicaCommand.d.ts

@@ -20,16 +20,17 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
 /**
  * @public
  * <p>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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html">Working with Read
- *                 Replicas</a> in the <i>Amazon RDS User Guide</i>.</p>
+ *             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 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html">Working
+ *                 with read replicas</a> and <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html#multi-az-db-clusters-migrating-to-instance-with-read-replica">Migrating from a Multi-AZ DB cluster to a DB instance using a read replica</a> in the <i>Amazon RDS User Guide</i>.</p>
  *          <p>Amazon Aurora doesn't support this operation. Call the <code>CreateDBInstance</code>
  *             operation to create a DB instance for an Aurora DB cluster.</p>
- *          <p>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.</p>
+ *          <p>All read replica DB instances are created with backups disabled. All other attributes
+ *             (including DB security groups and DB parameter groups) are inherited from the source DB
+ *             instance or cluster, except as specified.</p>
  *          <important>
- *             <p>Your source DB instance must have backup retention enabled.</p>
+ *             <p>Your source DB instance or cluster must have backup retention enabled.</p>
  *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -39,7 +40,7 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
  * const client = new RDSClient(config);
  * const input = { // CreateDBInstanceReadReplicaMessage
  *   DBInstanceIdentifier: "STRING_VALUE", // required
- *   SourceDBInstanceIdentifier: "STRING_VALUE", // required
+ *   SourceDBInstanceIdentifier: "STRING_VALUE",
  *   DBInstanceClass: "STRING_VALUE",
  *   AvailabilityZone: "STRING_VALUE",
  *   Port: Number("int"),
@@ -89,6 +90,7 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
  *   StorageThroughput: Number("int"),
  *   EnableCustomerOwnedIp: true || false,
  *   AllocatedStorage: Number("int"),
+ *   SourceDBClusterIdentifier: "STRING_VALUE",
  * };
  * const command = new CreateDBInstanceReadReplicaCommand(input);
  * const response = await client.send(command);
@@ -100,6 +102,10 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
  * @see {@link CreateDBInstanceReadReplicaCommandOutput} for command's `response` shape.
  * @see {@link RDSClientResolvedConfig | config} for RDSClient's `config` shape.
  *
+ * @throws {@link DBClusterNotFoundFault} (client fault)
+ *  <p>
+ *             <code>DBClusterIdentifier</code> doesn't refer to an existing DB cluster.</p>
+ *
  * @throws {@link DBInstanceAlreadyExistsFault} (client fault)
  *  <p>The user already has a DB instance with the given identifier.</p>
  *
@@ -139,6 +145,9 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
  *  <p>The specified DB instance class isn't available in the specified Availability
  *             Zone.</p>
  *
+ * @throws {@link InvalidDBClusterStateFault} (client fault)
+ *  <p>The requested operation can't be performed while the cluster is in this state.</p>
+ *
  * @throws {@link InvalidDBInstanceStateFault} (client fault)
  *  <p>The DB instance isn't in a valid state.</p>
  *

package/dist-types/commands/DeleteDBClusterCommand.d.ts

@@ -22,6 +22,8 @@ export interface DeleteDBClusterCommandOutput extends DeleteDBClusterResult, __M
  * <p>The DeleteDBCluster action deletes a previously provisioned DB cluster.
  *           When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered.
  *           Manual DB cluster snapshots of the specified DB cluster are not deleted.</p>
+ *          <p>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.</p>
  *          <p>For more information on Amazon Aurora, see
  *           <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
  *               What is Amazon Aurora?</a> in the <i>Amazon Aurora User Guide</i>.</p>

package/dist-types/models/models_0.d.ts

@@ -3364,7 +3364,7 @@ export interface CreateDBClusterMessage {
     /**
      * <p>The Amazon Resource Name (ARN) of the source DB instance or DB cluster if this DB
      *             cluster is created as a read replica.</p>
-     *          <p>Valid for: Aurora DB clusters and RDS for PostgreSQL Multi-AZ DB clusters</p>
+     *          <p>Valid for: Aurora DB clusters and Multi-AZ DB clusters</p>
      */
     ReplicationSourceIdentifier?: string;
     /**
@@ -7031,6 +7031,11 @@ export interface DBInstance {
      * <p>The details of the DB instance's server certificate.</p>
      */
     CertificateDetails?: CertificateDetails;
+    /**
+     * <p>Contains the identifier of the source DB cluster if this DB instance is a read
+     *             replica.</p>
+     */
+    ReadReplicaSourceDBClusterIdentifier?: string;
 }
 /**
  * @public
@@ -7119,7 +7124,8 @@ export interface CreateDBInstanceReadReplicaMessage {
     DBInstanceIdentifier: string | undefined;
     /**
      * <p>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.</p>
+     *             Each DB instance can have up to 15 read replicas, with the exception of Oracle and SQL
+     *             Server, which can have up to five.</p>
      *          <p>Constraints:</p>
      *          <ul>
      *             <li>
@@ -7127,20 +7133,15 @@ export interface CreateDBInstanceReadReplicaMessage {
      *                     instance.</p>
      *             </li>
      *             <li>
-     *                <p>Can specify a DB instance that is a MySQL read replica only if the source is running MySQL
-     *                     5.6 or later.</p>
+     *                <p>Can't be specified if the <code>SourceDBClusterIdentifier</code> parameter is
+     *                     also specified.</p>
      *             </li>
      *             <li>
-     *                <p>For the limitations of Oracle read replicas, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Read Replica Limitations with Oracle</a> in the
+     *                <p>For the limitations of Oracle read replicas, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.limitations.html#oracle-read-replicas.limitations.versions-and-licenses">Version and licensing considerations for RDS for Oracle replicas</a> in the
      *                   <i>Amazon RDS User Guide</i>.</p>
      *             </li>
      *             <li>
-     *                <p>For the limitations of SQL Server read replicas, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.Limitations.html">Read Replica
-     *                         Limitations with Microsoft SQL Server</a> in the <i>Amazon RDS User Guide</i>.</p>
-     *             </li>
-     *             <li>
-     *                <p>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).</p>
+     *                <p>For the limitations of SQL Server read replicas, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/SQLServer.ReadReplicas.html#SQLServer.ReadReplicas.Limitations">Read replica limitations with SQL Server</a> in the <i>Amazon RDS User Guide</i>.</p>
      *             </li>
      *             <li>
      *                <p>The specified DB instance must have automatic backups enabled, that is, its backup
@@ -7151,14 +7152,14 @@ export interface CreateDBInstanceReadReplicaMessage {
      *                     instance identifier.</p>
      *             </li>
      *             <li>
-     *                <p>If the source DB instance is in a different Amazon Web Services Region from the read replica, specify a valid DB instance ARN.
-     *              For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing">Constructing an ARN for Amazon RDS</a>
-     *              in the <i>Amazon RDS User Guide</i>. This doesn't apply to SQL Server or RDS Custom, which don't support
-     *              cross-Region replicas.</p>
+     *                <p>If the source DB instance is in a different Amazon Web Services Region from the read
+     *                     replica, specify a valid DB instance ARN. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing">Constructing an ARN for Amazon RDS</a> in the <i>Amazon RDS User
+     *                         Guide</i>. This doesn't apply to SQL Server or RDS Custom, which
+     *                     don't support cross-Region replicas.</p>
      *             </li>
      *          </ul>
      */
-    SourceDBInstanceIdentifier: string | undefined;
+    SourceDBInstanceIdentifier?: string;
     /**
      * <p>The compute and memory capacity of the read replica, for example
      *                 db.m4.large. Not all DB instance classes are available in all Amazon Web Services
@@ -7184,10 +7185,10 @@ export interface CreateDBInstanceReadReplicaMessage {
     Port?: number;
     /**
      * <p>A value that indicates whether the read replica is in a Multi-AZ deployment.</p>
-     *          <p>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.</p>
+     *          <p>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 is a
+     *             Multi-AZ DB instance or a Multi-AZ DB cluster.</p>
      *          <p>This setting doesn't apply to RDS Custom.</p>
      */
     MultiAZ?: boolean;
@@ -7203,10 +7204,10 @@ export interface CreateDBInstanceReadReplicaMessage {
      */
     Iops?: number;
     /**
-     * <p>The option group the DB instance is associated with. If omitted, the option group associated with the source instance is used.</p>
+     * <p>The option group the DB instance is associated with. If omitted, the option group
+     *             associated with the source instance or cluster is used.</p>
      *          <note>
-     *             <p>For SQL Server, you must use the option group associated with the source
-     *                 instance.</p>
+     *             <p>For SQL Server, you must use the option group associated with the source.</p>
      *          </note>
      *          <p>This setting doesn't apply to RDS Custom.</p>
      */
@@ -7330,13 +7331,15 @@ export interface CreateDBInstanceReadReplicaMessage {
      * <p>The Amazon Web Services KMS key identifier for an encrypted read replica.</p>
      *          <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>
      *          <p>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.</p>
+     *             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.</p>
      *          <p>If you create an encrypted read replica in a different Amazon Web Services Region, then you must
      *             specify a KMS key identifier for the destination Amazon Web Services Region. KMS keys are specific to
      *             the Amazon Web Services Region that they are created in, and you can't use KMS keys from one
      *             Amazon Web Services Region in another Amazon Web Services Region.</p>
-     *          <p>You can't create an encrypted read replica from an unencrypted DB instance.</p>
+     *          <p>You can't create an encrypted read replica from an unencrypted DB instance or
+     *             Multi-AZ DB cluster.</p>
      *          <p>This setting doesn't apply to RDS Custom, which uses the same KMS key as the primary
      *             replica.</p>
      */
@@ -7348,6 +7351,8 @@ export interface CreateDBInstanceReadReplicaMessage {
      *             source Amazon Web Services Region that contains the source DB instance.</p>
      *          <p>This setting applies only to Amazon Web Services GovCloud (US) Regions and
      *             China Amazon Web Services Regions. It's ignored in other Amazon Web Services Regions.</p>
+     *          <p>This setting applies only when replicating from a source DB
+     *                 <i>instance</i>. Source DB clusters aren't supported in Amazon Web Services GovCloud (US) Regions and China Amazon Web Services Regions.</p>
      *          <p>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
      *                 <code>PreSignedUrl</code> when you are creating an encrypted read replica in the
@@ -7381,11 +7386,11 @@ export interface CreateDBInstanceReadReplicaMessage {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>SourceDBInstanceIdentifier</code> - The DB instance identifier for
-     *                     the encrypted DB instance to be replicated. This identifier must be in the
-     *                     Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example, if you
-     *                     are creating an encrypted read replica from a DB instance in the us-west-2 Amazon Web Services
-     *                     Region, then your <code>SourceDBInstanceIdentifier</code> looks like the
+     *                   <code>SourceDBInstanceIdentifier</code> - The DB instance identifier for the
+     *                     encrypted DB instance to be replicated. This identifier must be in the Amazon
+     *                     Resource Name (ARN) format for the source Amazon Web Services Region. For example, if you are
+     *                     creating an encrypted read replica from a DB instance in the us-west-2
+     *                     Amazon Web Services Region, then your <code>SourceDBInstanceIdentifier</code> looks like the
      *                     following example:
      *                         <code>arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115</code>.</p>
      *             </li>
@@ -7500,7 +7505,8 @@ export interface CreateDBInstanceReadReplicaMessage {
      */
     Domain?: string;
     /**
-     * <p>Specify the name of the IAM role to be used when making API calls to the Directory Service.</p>
+     * <p>The name of the IAM role to be used when making API calls to the Directory
+     *             Service.</p>
      *          <p>This setting doesn't apply to RDS Custom.</p>
      */
     DomainIAMRoleName?: string;
@@ -7599,6 +7605,29 @@ export interface CreateDBInstanceReadReplicaMessage {
      *          </note>
      */
     AllocatedStorage?: number;
+    /**
+     * <p>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.</p>
+     *          <p>Constraints:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Must be the identifier of an existing Multi-AZ DB cluster.</p>
+     *             </li>
+     *             <li>
+     *                <p>Can't be specified if the <code>SourceDBInstanceIdentifier</code> parameter is
+     *                     also specified.</p>
+     *             </li>
+     *             <li>
+     *                <p>The specified DB cluster must have automatic backups enabled, that is, its
+     *                     backup retention period must be greater than 0.</p>
+     *             </li>
+     *             <li>
+     *                <p>The source DB cluster must be in the same Amazon Web Services Region as the read replica.
+     *                     Cross-Region replication isn't supported.</p>
+     *             </li>
+     *          </ul>
+     */
+    SourceDBClusterIdentifier?: string;
 }
 /**
  * @public

package/dist-types/models/models_1.d.ts

@@ -3361,13 +3361,21 @@ export interface ModifyDBClusterMessage {
      */
     CloudwatchLogsExportConfiguration?: CloudwatchLogsExportConfiguration;
     /**
-     * <p>The version number of the database engine to which you want to upgrade.
-     *             Changing this parameter results in an outage. The change is applied during
-     *             the next maintenance window unless <code>ApplyImmediately</code> is enabled.</p>
+     * <p>The version number of the database engine to which you want to upgrade. Changing this
+     *             parameter results in an outage. The change is applied during the next maintenance window
+     *             unless <code>ApplyImmediately</code> is enabled. </p>
+     *          <p>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.</p>
      *          <p>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:</p>
      *          <p>
-     *             <code>aws rds describe-db-engine-versions --engine aurora-mysql --query "DBEngineVersions[].EngineVersion"</code>
+     *             <code>aws rds describe-db-engine-versions --engine aurora-mysql --query
+     *                 "DBEngineVersions[].EngineVersion"</code>
+     *          </p>
+     *          <p>To list all of the available engine versions for MySQL 5.6-compatible Aurora, use the following command:</p>
+     *          <p>
+     *             <code>aws rds describe-db-engine-versions --engine aurora --query "DBEngineVersions[].EngineVersion"</code>
      *          </p>
      *          <p>To list all of the available engine versions for Aurora PostgreSQL, use the following command:</p>
      *          <p>
@@ -4091,6 +4099,9 @@ export interface ModifyDBInstanceMessage {
      *           default minor version if the current minor version is lower.
      *           For information about valid engine versions, see <code>CreateDBInstance</code>,
      *           or call <code>DescribeDBEngineVersions</code>.</p>
+     *          <p>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.</p>
      *          <p>In RDS Custom for Oracle, this parameter is supported for read replicas only if they are in the
      *           <code>PATCH_DB_FAILURE</code> lifecycle.</p>
      */
@@ -8688,8 +8699,9 @@ export interface StopDBInstanceResult {
  */
 export interface StopDBInstanceAutomatedBackupsReplicationMessage {
     /**
-     * <p>The Amazon Resource Name (ARN) of the source DB instance for which to stop replicating automated backups, for example,
-     *             <code>arn:aws:rds:us-west-2:123456789012:db:mydatabase</code>.</p>
+     * <p>The Amazon Resource Name (ARN) of the source DB instance for which to stop replicating
+     *             automate backups, for example,
+     *                 <code>arn:aws:rds:us-west-2:123456789012:db:mydatabase</code>.</p>
      */
     SourceDBInstanceArn: string | undefined;
 }

package/dist-types/ts3.4/models/models_0.d.ts

@@ -1373,6 +1373,7 @@ export interface DBInstance {
   DBSystemId?: string;
   MasterUserSecret?: MasterUserSecret;
   CertificateDetails?: CertificateDetails;
+  ReadReplicaSourceDBClusterIdentifier?: string;
 }
 export interface CreateDBInstanceResult {
   DBInstance?: DBInstance;
@@ -1420,7 +1421,7 @@ export declare class StorageTypeNotSupportedFault extends __BaseException {
 }
 export interface CreateDBInstanceReadReplicaMessage {
   DBInstanceIdentifier: string | undefined;
-  SourceDBInstanceIdentifier: string | undefined;
+  SourceDBInstanceIdentifier?: string;
   DBInstanceClass?: string;
   AvailabilityZone?: string;
   Port?: number;
@@ -1456,6 +1457,7 @@ export interface CreateDBInstanceReadReplicaMessage {
   StorageThroughput?: number;
   EnableCustomerOwnedIp?: boolean;
   AllocatedStorage?: number;
+  SourceDBClusterIdentifier?: string;
 }
 export interface CreateDBInstanceReadReplicaResult {
   DBInstance?: DBInstance;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-rds",
   "description": "AWS SDK for JavaScript Rds Client for Node.js, Browser and React Native",
-  "version": "3.301.0",
+  "version": "3.302.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",