Updates Amazon RDS documentation for Amazon RDS for Db2 cross-Region replicas in standby mode.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/rds/rds-2014-10-31.docs.json

@@ -92,6 +92,15 @@ internal bool IsSetConnectionBorrowTimeout()
         /// <para>
         /// Default: no initialization query
         /// </para>
+        ///  <important> 
+        /// <para>
+        /// 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.
+        /// </para>
+        ///  </important>
         /// </summary>
         public string InitQuery
         {

generator/ServiceModels/rds/rds-2014-10-31.normal.json

@@ -73,6 +73,15 @@ internal bool IsSetConnectionBorrowTimeout()
         /// <para>
         /// For example: <c>SET variable1=value1, variable2=value2</c> 
         /// </para>
+        ///  <important> 
+        /// <para>
+        /// 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.
+        /// </para>
+        ///  </important>
         /// </summary>
         public string InitQuery
         {

sdk/src/Services/RDS/Generated/Model/ConnectionPoolConfiguration.cs

@@ -32,23 +32,28 @@ namespace Amazon.RDS.Model
     /// <summary>
     /// Container for the parameters to the CreateDBInstanceReadReplica operation.
     /// 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 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
+    /// or Multi-AZ DB cluster. You can create a read replica for a DB instance running 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>.
     /// 
     ///  
     /// <para>
+    /// Amazon RDS for Db2 supports this operation for standby replicas. To create a standby
+    /// replica for a DB instance running Db2, you must set <c>ReplicaMode</c> to <c>mounted</c>.
+    /// </para>
+    ///  
+    /// <para>
     /// Amazon Aurora doesn't support this operation. To create a DB instance for an Aurora
     /// DB cluster, use the <c>CreateDBInstance</c> operation.
     /// </para>
     ///  
     /// <para>
-    /// 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.
+    /// 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.
     /// </para>
     ///  <important> 
     /// <para>
@@ -114,7 +119,7 @@ public CreateDBInstanceReadReplicaRequest() { }
         /// Instantiates CreateDBInstanceReadReplicaRequest with the parameterized properties
         /// </summary>
         /// <param name="dbInstanceIdentifier">The DB instance identifier of the read replica. This identifier is the unique key that identifies a DB instance. This parameter is stored as a lowercase string.</param>
-        /// <param name="sourceDBInstanceIdentifier">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. Constraints: <ul> <li> Must be the identifier of an existing Db2, MariaDB, MySQL, Oracle, PostgreSQL, or SQL Server DB instance. </li> <li> Can't be specified if the <c>SourceDBClusterIdentifier</c> parameter is also specified. </li> <li> 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>. </li> <li> 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>. </li> <li> The specified DB instance must have automatic backups enabled, that is, its backup retention period must be greater than 0. </li> <li> If the source DB instance is in the same Amazon Web Services Region as the read replica, specify a valid DB instance identifier. </li> <li> 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. </li> </ul></param>
+        /// <param name="sourceDBInstanceIdentifier">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, except for the following engines: <ul> <li> Db2 - Can have up to three replicas. </li> <li> Oracle - Can have up to five read replicas. </li> <li> SQL Server - Can have up to five read replicas. </li> </ul> Constraints: <ul> <li> Must be the identifier of an existing Db2, MariaDB, MySQL, Oracle, PostgreSQL, or SQL Server DB instance. </li> <li> Can't be specified if the <c>SourceDBClusterIdentifier</c> parameter is also specified. </li> <li> 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>. </li> <li> 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>. </li> <li> The specified DB instance must have automatic backups enabled, that is, its backup retention period must be greater than 0. </li> <li> If the source DB instance is in the same Amazon Web Services Region as the read replica, specify a valid DB instance identifier. </li> <li> 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. </li> </ul></param>
         public CreateDBInstanceReadReplicaRequest(string dbInstanceIdentifier, string sourceDBInstanceIdentifier)
         {
             _dbInstanceIdentifier = dbInstanceIdentifier;
@@ -375,6 +380,17 @@ internal bool IsSetDBInstanceIdentifier()
         /// </para>
         ///  
         /// <para>
+        /// 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>. 
+        /// </para>
+        ///  
+        /// <para>
         /// For Single-AZ or Multi-AZ DB instance read replica instances, if you don't specify
         /// a value for <c>DBParameterGroupName</c>, then Amazon RDS uses the <c>DBParameterGroup</c>
         /// of the source DB instance for a same Region read replica, or the default <c>DBParameterGroup</c>
@@ -388,9 +404,9 @@ internal bool IsSetDBInstanceIdentifier()
         ///  
         /// <para>
         /// 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.
+        /// for cross-Region read replicas, for Multi-AZ DB cluster read replica 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.
         /// </para>
         ///  
         /// <para>
@@ -1323,13 +1339,29 @@ internal bool IsSetPubliclyAccessible()
         /// <summary>
         /// Gets and sets the property ReplicaMode. 
         /// <para>
-        /// The open mode of the replica database: mounted or read-only.
+        /// The open mode of the replica database.
         /// </para>
         ///  <note> 
         /// <para>
-        /// This parameter is only supported for Oracle DB instances.
+        /// This parameter is only supported for Db2 DB instances and Oracle DB instances.
         /// </para>
-        ///  </note> 
+        ///  </note> <dl> <dt>Db2</dt> <dd> 
+        /// <para>
+        /// 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.
+        /// </para>
+        ///  
+        /// <para>
+        /// 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>.
+        /// </para>
+        ///  
+        /// <para>
+        /// To create standby DB replicas for RDS for Db2, set this parameter to <c>mounted</c>.
+        /// </para>
+        ///  </dd> <dt>Oracle</dt> <dd> 
         /// <para>
         /// 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
@@ -1340,14 +1372,15 @@ internal bool IsSetPubliclyAccessible()
         /// <para>
         /// 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>.
+        /// with read replicas for Amazon RDS for Oracle</a> in the <i>Amazon RDS User Guide</i>.
         /// </para>
         ///  
         /// <para>
         /// For RDS Custom, you must specify this parameter and set it to <c>mounted</c>. The
         /// value won't be set by default. After replica creation, you can manage the open mode
         /// manually.
         /// </para>
+        ///  </dd> </dl>
         /// </summary>
         public ReplicaMode ReplicaMode
         {
@@ -1407,10 +1440,21 @@ internal bool IsSetSourceDBClusterIdentifier()
         /// Gets and sets the property SourceDBInstanceIdentifier. 
         /// <para>
         /// 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.
+        /// Each DB instance can have up to 15 read replicas, except for the following engines:
         /// </para>
-        ///  
+        ///  <ul> <li> 
+        /// <para>
+        /// Db2 - Can have up to three replicas.
+        /// </para>
+        ///  </li> <li> 
+        /// <para>
+        /// Oracle - Can have up to five read replicas.
+        /// </para>
+        ///  </li> <li> 
+        /// <para>
+        /// SQL Server - Can have up to five read replicas.
+        /// </para>
+        ///  </li> </ul> 
         /// <para>
         /// Constraints:
         /// </para>

sdk/src/Services/RDS/Generated/Model/ConnectionPoolConfigurationInfo.cs

@@ -1709,13 +1709,16 @@ internal bool IsSetReadReplicaSourceDBInstanceIdentifier()
         /// <summary>
         /// Gets and sets the property ReplicaMode. 
         /// <para>
-        /// The open mode of an Oracle read replica. The default is <c>open-read-only</c>. 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>.
+        /// The open mode of a Db2 or an Oracle read replica. The default is <c>open-read-only</c>.
+        /// 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>.
+        /// 
         /// </para>
         ///  <note> 
         /// <para>
-        /// This attribute is only supported in RDS for Oracle.
+        /// This attribute is only supported in RDS for Db2, RDS for Oracle, and RDS Custom for
+        /// Oracle.
         /// </para>
         ///  </note>
         /// </summary>

sdk/src/Services/RDS/Generated/Model/CreateDBInstanceReadReplicaRequest.cs

@@ -2165,25 +2165,48 @@ internal bool IsSetPubliclyAccessible()
         /// <summary>
         /// Gets and sets the property ReplicaMode. 
         /// <para>
-        /// A value that sets the open mode of a replica database to either mounted or read-only.
+        /// The open mode of a replica database.
         /// </para>
         ///  <note> 
         /// <para>
-        /// Currently, this parameter is only supported for Oracle DB instances.
+        /// This parameter is only supported for Db2 DB instances and Oracle DB instances.
         /// </para>
-        ///  </note> 
+        ///  </note> <dl> <dt>Db2</dt> <dd> 
         /// <para>
-        /// 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>.
+        /// 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.
         /// </para>
         ///  
         /// <para>
-        /// This setting doesn't apply to RDS Custom DB instances.
+        /// 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>.
+        /// </para>
+        ///  
+        /// <para>
+        /// To create standby DB replicas for RDS for Db2, set this parameter to <c>mounted</c>.
+        /// </para>
+        ///  </dd> <dt>Oracle</dt> <dd> 
+        /// <para>
+        /// 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.
+        /// </para>
+        ///  
+        /// <para>
+        /// 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>.
+        /// </para>
+        ///  
+        /// <para>
+        /// For RDS Custom, you must specify this parameter and set it to <c>mounted</c>. The
+        /// value won't be set by default. After replica creation, you can manage the open mode
+        /// manually.
         /// </para>
+        ///  </dd> </dl>
         /// </summary>
         public ReplicaMode ReplicaMode
         {