@aws-sdk/client-rds 3.826.0 → 3.828.0

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

@@ -29,12 +29,16 @@ declare const CreateDBInstanceReadReplicaCommand_base: {
 /**
  * <p>Creates a new DB instance that acts as a read replica for an existing source DB
  *             instance or Multi-AZ DB cluster. You can create a read replica for a DB instance running
- *             Db2, MariaDB, MySQL, Oracle, PostgreSQL, or SQL Server. You can create a read replica for a
+ *             MariaDB, MySQL, 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>
+ *                 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 RDS for Db2 supports this operation for standby replicas. To create a standby
+ *             replica for a DB instance running Db2, you must set <code>ReplicaMode</code> to
+ *                 <code>mounted</code>.</p>
  *          <p>Amazon Aurora doesn't support this operation. To create a DB instance for an Aurora DB cluster, use the <code>CreateDBInstance</code>
  *             operation.</p>
- *          <p>All read replica DB instances are created with backups disabled. All other attributes
+ *          <p>RDS creates read replicas 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>

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

@@ -8233,11 +8233,13 @@ export interface DBInstance {
      */
     ReadReplicaDBClusterIdentifiers?: string[] | undefined;
     /**
-     * <p>The open mode of an Oracle read replica. The default is <code>open-read-only</code>.
-     *             For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Working with Oracle Read Replicas for Amazon RDS</a>
-     *             in the <i>Amazon RDS User Guide</i>.</p>
+     * <p>The open mode of a Db2 or an Oracle read replica. The default is
+     *                 <code>open-read-only</code>. For more information, see  <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html">Working with read replicas for
+     *                 Amazon RDS for Db2</a>  and <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Working with read replicas
+     *                 for Amazon RDS for Oracle</a> in the <i>Amazon RDS User Guide</i>. </p>
      *          <note>
-     *             <p>This attribute is only supported in RDS for Oracle.</p>
+     *             <p>This attribute is only supported in RDS for Db2, RDS for Oracle, and RDS Custom
+     *                 for Oracle.</p>
      *          </note>
      * @public
      */
@@ -8745,8 +8747,19 @@ 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 15 read replicas, with the exception of Oracle and SQL
-     *             Server, which can have up to five.</p>
+     *             Each DB instance can have up to 15 read replicas, except for the following
+     *             engines:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Db2 - Can have up to three replicas.</p>
+     *             </li>
+     *             <li>
+     *                <p>Oracle - Can have up to five read replicas.</p>
+     *             </li>
+     *             <li>
+     *                <p>SQL Server - Can have up to five read replicas.</p>
+     *             </li>
+     *          </ul>
      *          <p>Constraints:</p>
      *          <ul>
      *             <li>
@@ -8844,6 +8857,14 @@ export interface CreateDBInstanceReadReplicaMessage {
     /**
      * <p>The name of the DB parameter group to associate with this read replica DB
      *             instance.</p>
+     *          <p>For the Db2 DB engine, if your source DB instance uses the Bring Your Own License
+     *             model, then a custom parameter group must be associated with the replica. For a same
+     *             Amazon Web Services Region replica, if you don't specify a custom parameter group, Amazon RDS
+     *             associates the custom parameter group associated with the source DB instance. For a
+     *             cross-Region replica, you must specify a custom parameter group. This custom parameter
+     *             group must include your IBM Site ID and IBM Customer ID. For more information, see
+     *                 <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-licensing.html#db2-prereqs-ibm-info"> IBM IDs
+     *                 for Bring Your Own License for Db2</a>. </p>
      *          <p>For Single-AZ or Multi-AZ DB instance read replica instances, if you don't specify a
      *             value for <code>DBParameterGroupName</code>, then Amazon RDS uses the
      *                 <code>DBParameterGroup</code> of the source DB instance for a same Region read
@@ -8854,8 +8875,8 @@ export interface CreateDBInstanceReadReplicaMessage {
      *                 <code>DBParameterGroup</code>.</p>
      *          <p>Specifying a parameter group for this operation is only supported for MySQL DB
      *             instances for cross-Region read replicas, for Multi-AZ DB cluster read replica
-     *             instances, and for Oracle DB instances. It isn't supported for MySQL DB instances for
-     *             same Region read replicas or for RDS Custom.</p>
+     *             instances, for Db2 DB instances, and for Oracle DB instances. It isn't supported for
+     *             MySQL DB instances for same Region read replicas or for RDS Custom.</p>
      *          <p>Constraints:</p>
      *          <ul>
      *             <li>
@@ -9214,19 +9235,39 @@ export interface CreateDBInstanceReadReplicaMessage {
      */
     DomainDnsIps?: string[] | undefined;
     /**
-     * <p>The open mode of the replica database: mounted or read-only.</p>
+     * <p>The open mode of the replica database.</p>
      *          <note>
-     *             <p>This parameter is only supported for Oracle DB instances.</p>
+     *             <p>This parameter is only supported for Db2 DB instances and Oracle DB
+     *                 instances.</p>
      *          </note>
-     *          <p>Mounted DB replicas are included in Oracle Database Enterprise Edition. The main use case for
-     *             mounted replicas is cross-Region disaster recovery. The primary database doesn't use Active
-     *             Data Guard to transmit information to the mounted replica. Because it doesn't accept
-     *             user connections, a mounted replica can't serve a read-only workload.</p>
-     *          <p>You can create a combination of mounted and read-only DB replicas for the same primary DB instance.
-     *             For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Working with Oracle Read Replicas for Amazon RDS</a>
-     *             in the <i>Amazon RDS User Guide</i>.</p>
-     *          <p>For RDS Custom, you must specify this parameter and set it to <code>mounted</code>. The value won't be set by default.
-     *             After replica creation, you can manage the open mode manually.</p>
+     *          <dl>
+     *             <dt>Db2</dt>
+     *             <dd>
+     *                <p>Standby DB replicas are included in Db2 Advanced Edition (AE) and Db2
+     *                         Standard Edition (SE). The main use case for standby replicas is
+     *                         cross-Region disaster recovery. Because it doesn't accept user
+     *                         connections, a standby replica can't serve a read-only workload.</p>
+     *                <p>You can create a combination of standby and read-only DB replicas for the
+     *                         same primary DB instance. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html">Working with read
+     *                             replicas for Amazon RDS for Db2</a> in the <i>Amazon RDS User
+     *                             Guide</i>.</p>
+     *                <p>To create standby DB replicas for RDS for Db2, set this parameter to
+     *                             <code>mounted</code>.</p>
+     *             </dd>
+     *             <dt>Oracle</dt>
+     *             <dd>
+     *                <p>Mounted DB replicas are included in Oracle Database Enterprise Edition. The main use case for
+     *                     mounted replicas is cross-Region disaster recovery. The primary database doesn't use Active
+     *                     Data Guard to transmit information to the mounted replica. Because it doesn't accept
+     *                     user connections, a mounted replica can't serve a read-only workload.</p>
+     *                <p>You can create a combination of mounted and read-only DB replicas for the same primary DB instance.
+     *                     For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Working with read replicas for Amazon RDS for Oracle</a>
+     *                     in the <i>Amazon RDS User Guide</i>.</p>
+     *                <p>For RDS Custom, you must specify this parameter and set it to
+     *                         <code>mounted</code>. The value won't be set by default. After replica
+     *                         creation, you can manage the open mode manually.</p>
+     *             </dd>
+     *          </dl>
      * @public
      */
     ReplicaMode?: ReplicaMode | undefined;

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

@@ -2279,6 +2279,11 @@ export interface ConnectionPoolConfigurationInfo {
      *         This is an optional field.</p>
      *          <p>For example: <code>SET variable1=value1, variable2=value2</code>
      *          </p>
+     *          <important>
+     *             <p>Since you can access initialization query as part of target group configuration, it is not protected by authentication or cryptographic methods.
+     *                 Anyone with access to view or manage your proxy target group configuration can view the initialization query.
+     *                 You should not add sensitive data, such as passwords or long-lived encryption keys, to this option.</p>
+     *          </important>
      * @public
      */
     InitQuery?: string | undefined;
@@ -8629,17 +8634,40 @@ export interface ModifyDBInstanceMessage {
      */
     CertificateRotationRestart?: boolean | undefined;
     /**
-     * <p>A value that sets the open mode of a replica database to either mounted or read-only.</p>
+     * <p>The open mode of a replica database.</p>
      *          <note>
-     *             <p>Currently, this parameter is only supported for Oracle DB instances.</p>
+     *             <p>This parameter is only supported for Db2 DB instances and Oracle DB
+     *                 instances.</p>
      *          </note>
-     *          <p>Mounted DB replicas are included in Oracle Enterprise Edition. The main use case for
-     *             mounted replicas is cross-Region disaster recovery. The primary database doesn't use
-     *             Active Data Guard to transmit information to the mounted replica. Because it doesn't
-     *             accept user connections, a mounted replica can't serve a read-only workload.
-     *             For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Working with Oracle Read Replicas for Amazon RDS</a>
-     *             in the <i>Amazon RDS User Guide</i>.</p>
-     *          <p>This setting doesn't apply to RDS Custom DB instances.</p>
+     *          <dl>
+     *             <dt>Db2</dt>
+     *             <dd>
+     *                <p>Standby DB replicas are included in Db2 Advanced Edition (AE) and Db2
+     *                         Standard Edition (SE). The main use case for standby replicas is
+     *                         cross-Region disaster recovery. Because it doesn't accept user
+     *                         connections, a standby replica can't serve a read-only workload.</p>
+     *                <p>You can create a combination of standby and read-only DB replicas for the
+     *                         same primary DB instance. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/db2-replication.html">Working with read
+     *                             replicas for Amazon RDS for Db2</a> in the <i>Amazon RDS User
+     *                                 Guide</i>.</p>
+     *                <p>To create standby DB replicas for RDS for Db2, set this parameter to
+     *                         <code>mounted</code>.</p>
+     *             </dd>
+     *             <dt>Oracle</dt>
+     *             <dd>
+     *                <p>Mounted DB replicas are included in Oracle Database Enterprise Edition. The main use case for
+     *                         mounted replicas is cross-Region disaster recovery. The primary database doesn't use Active
+     *                         Data Guard to transmit information to the mounted replica. Because it doesn't accept
+     *                         user connections, a mounted replica can't serve a read-only workload.</p>
+     *                <p>You can create a combination of mounted and read-only DB replicas for the
+     *                         same primary DB instance. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html">Working with
+     *                             read replicas for Amazon RDS for Oracle</a> in the <i>Amazon
+     *                             RDS User Guide</i>.</p>
+     *                <p>For RDS Custom, you must specify this parameter and set it to
+     *                             <code>mounted</code>. The value won't be set by default. After replica
+     *                         creation, you can manage the open mode manually.</p>
+     *             </dd>
+     *          </dl>
      * @public
      */
     ReplicaMode?: ReplicaMode | undefined;
@@ -9066,6 +9094,11 @@ export interface ConnectionPoolConfiguration {
      *          <p>For example: <code>SET variable1=value1, variable2=value2</code>
      *          </p>
      *          <p>Default: no initialization query</p>
+     *          <important>
+     *             <p>Since you can access initialization query as part of target group configuration, it is not protected by authentication or cryptographic methods.
+     *                 Anyone with access to view or manage your proxy target group configuration can view the initialization query.
+     *                 You should not add sensitive data, such as passwords or long-lived encryption keys, to this option.</p>
+     *          </important>
      * @public
      */
     InitQuery?: string | undefined;

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.826.0",
+  "version": "3.828.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-rds",
@@ -21,17 +21,17 @@
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
     "@aws-sdk/core": "3.826.0",
-    "@aws-sdk/credential-provider-node": "3.826.0",
+    "@aws-sdk/credential-provider-node": "3.828.0",
     "@aws-sdk/middleware-host-header": "3.821.0",
     "@aws-sdk/middleware-logger": "3.821.0",
     "@aws-sdk/middleware-recursion-detection": "3.821.0",
     "@aws-sdk/middleware-sdk-rds": "3.826.0",
-    "@aws-sdk/middleware-user-agent": "3.826.0",
+    "@aws-sdk/middleware-user-agent": "3.828.0",
     "@aws-sdk/region-config-resolver": "3.821.0",
     "@aws-sdk/types": "3.821.0",
-    "@aws-sdk/util-endpoints": "3.821.0",
+    "@aws-sdk/util-endpoints": "3.828.0",
     "@aws-sdk/util-user-agent-browser": "3.821.0",
-    "@aws-sdk/util-user-agent-node": "3.826.0",
+    "@aws-sdk/util-user-agent-node": "3.828.0",
     "@smithy/config-resolver": "^4.1.4",
     "@smithy/core": "^3.5.3",
     "@smithy/fetch-http-handler": "^5.0.4",