@aws-sdk/client-rds 3.826.0 → 3.830.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/endpoint/EndpointParameters.d.ts

@@ -3,9 +3,9 @@ import { Endpoint, EndpointParameters as __EndpointParameters, EndpointV2, Provi
  * @public
  */
 export interface ClientInputEndpointParameters {
-    region?: string | Provider<string>;
-    useDualstackEndpoint?: boolean | Provider<boolean>;
-    useFipsEndpoint?: boolean | Provider<boolean>;
+    region?: string | undefined | Provider<string | undefined>;
+    useDualstackEndpoint?: boolean | undefined | Provider<boolean | undefined>;
+    useFipsEndpoint?: boolean | undefined | Provider<boolean | undefined>;
     endpoint?: string | Provider<string> | Endpoint | Provider<Endpoint> | EndpointV2 | Provider<EndpointV2>;
 }
 export type ClientResolvedEndpointParameters = ClientInputEndpointParameters & {
@@ -31,8 +31,8 @@ export declare const commonParams: {
     };
 };
 export interface EndpointParameters extends __EndpointParameters {
-    Region?: string;
-    UseDualStack?: boolean;
-    UseFIPS?: boolean;
-    Endpoint?: string;
+    Region?: string | undefined;
+    UseDualStack?: boolean | undefined;
+    UseFIPS?: boolean | undefined;
+    Endpoint?: string | undefined;
 }

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/dist-types/runtimeConfig.browser.d.ts

@@ -15,8 +15,8 @@ export declare const getRuntimeConfig: (config: RDSClientConfig) => {
     retryMode: string | import("@smithy/types").Provider<string>;
     sha256: import("@smithy/types").HashConstructor;
     streamCollector: import("@smithy/types").StreamCollector;
-    useDualstackEndpoint: boolean | import("@smithy/types").Provider<boolean>;
-    useFipsEndpoint: boolean | import("@smithy/types").Provider<boolean>;
+    useDualstackEndpoint: (boolean | import("@smithy/types").Provider<boolean>) & (boolean | import("@smithy/types").Provider<boolean | undefined>);
+    useFipsEndpoint: (boolean | import("@smithy/types").Provider<boolean>) & (boolean | import("@smithy/types").Provider<boolean | undefined>);
     apiVersion: string;
     cacheMiddleware?: boolean | undefined;
     urlParser: import("@smithy/types").UrlParser;

package/dist-types/runtimeConfig.native.d.ts

@@ -17,8 +17,8 @@ export declare const getRuntimeConfig: (config: RDSClientConfig) => {
     utf8Encoder: (input: Uint8Array | string) => string;
     disableHostPrefix: boolean;
     serviceId: string;
-    useDualstackEndpoint: boolean | import("@smithy/types").Provider<boolean>;
-    useFipsEndpoint: boolean | import("@smithy/types").Provider<boolean>;
+    useDualstackEndpoint: (boolean | import("@smithy/types").Provider<boolean>) & (boolean | import("@smithy/types").Provider<boolean | undefined>);
+    useFipsEndpoint: (boolean | import("@smithy/types").Provider<boolean>) & (boolean | import("@smithy/types").Provider<boolean | undefined>);
     region: string | import("@smithy/types").Provider<any>;
     profile?: string;
     defaultUserAgentProvider: (config?: import("@aws-sdk/util-user-agent-browser").PreviouslyResolved) => Promise<import("@smithy/types").UserAgent>;

package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts

@@ -5,9 +5,9 @@ import {
   Provider,
 } from "@smithy/types";
 export interface ClientInputEndpointParameters {
-  region?: string | Provider<string>;
-  useDualstackEndpoint?: boolean | Provider<boolean>;
-  useFipsEndpoint?: boolean | Provider<boolean>;
+  region?: string | undefined | Provider<string | undefined>;
+  useDualstackEndpoint?: boolean | undefined | Provider<boolean | undefined>;
+  useFipsEndpoint?: boolean | undefined | Provider<boolean | undefined>;
   endpoint?:
     | string
     | Provider<string>
@@ -41,8 +41,8 @@ export declare const commonParams: {
   };
 };
 export interface EndpointParameters extends __EndpointParameters {
-  Region?: string;
-  UseDualStack?: boolean;
-  UseFIPS?: boolean;
-  Endpoint?: string;
+  Region?: string | undefined;
+  UseDualStack?: boolean | undefined;
+  UseFIPS?: boolean | undefined;
+  Endpoint?: string | undefined;
 }

package/dist-types/ts3.4/runtimeConfig.browser.d.ts

@@ -22,8 +22,10 @@ export declare const getRuntimeConfig: (config: RDSClientConfig) => {
   retryMode: string | import("@smithy/types").Provider<string>;
   sha256: import("@smithy/types").HashConstructor;
   streamCollector: import("@smithy/types").StreamCollector;
-  useDualstackEndpoint: boolean | import("@smithy/types").Provider<boolean>;
-  useFipsEndpoint: boolean | import("@smithy/types").Provider<boolean>;
+  useDualstackEndpoint: (boolean | import("@smithy/types").Provider<boolean>) &
+    (boolean | import("@smithy/types").Provider<boolean | undefined>);
+  useFipsEndpoint: (boolean | import("@smithy/types").Provider<boolean>) &
+    (boolean | import("@smithy/types").Provider<boolean | undefined>);
   apiVersion: string;
   cacheMiddleware?: boolean | undefined;
   urlParser: import("@smithy/types").UrlParser;

package/dist-types/ts3.4/runtimeConfig.native.d.ts

@@ -19,8 +19,10 @@ export declare const getRuntimeConfig: (config: RDSClientConfig) => {
   utf8Encoder: (input: Uint8Array | string) => string;
   disableHostPrefix: boolean;
   serviceId: string;
-  useDualstackEndpoint: boolean | import("@smithy/types").Provider<boolean>;
-  useFipsEndpoint: boolean | import("@smithy/types").Provider<boolean>;
+  useDualstackEndpoint: (boolean | import("@smithy/types").Provider<boolean>) &
+    (boolean | import("@smithy/types").Provider<boolean | undefined>);
+  useFipsEndpoint: (boolean | import("@smithy/types").Provider<boolean>) &
+    (boolean | import("@smithy/types").Provider<boolean | undefined>);
   region: string | import("@smithy/types").Provider<any>;
   profile?: string;
   defaultUserAgentProvider: (

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.830.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.830.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",