From b0b5547d8a96992206784fe87a8732f2f6a6586a Mon Sep 17 00:00:00 2001
From: awstools <awstools@amazon.com>
Date: Fri, 27 Dec 2024 19:14:28 +0000
Subject: [PATCH] docs(client-rds): Updates Amazon RDS documentation to correct
 various descriptions.

---
 clients/client-rds/src/models/models_0.ts |  43 +++++----
 clients/client-rds/src/models/models_1.ts | 104 +++++++++++++++++++---
 codegen/sdk-codegen/aws-models/rds.json   |  66 +++++++-------
 3 files changed, 152 insertions(+), 61 deletions(-)

diff --git a/clients/client-rds/src/models/models_0.ts b/clients/client-rds/src/models/models_0.ts
index 94b8aae1622e..0c863b7bb966 100644
--- a/clients/client-rds/src/models/models_0.ts
+++ b/clients/client-rds/src/models/models_0.ts
@@ -5227,7 +5227,7 @@ export interface CreateDBClusterMessage {
   /**
    * <p>Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window.
    *             By default, minor engine upgrades are applied automatically.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster</p>
    * @public
    */
   AutoMinorVersionUpgrade?: boolean | undefined;
@@ -5237,7 +5237,7 @@ export interface CreateDBClusterMessage {
    *             collecting Enhanced Monitoring metrics, specify <code>0</code>.</p>
    *          <p>If <code>MonitoringRoleArn</code> is specified, also set <code>MonitoringInterval</code>
    *             to a value other than <code>0</code>.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    *          <p>Valid Values: <code>0 | 1 | 5 | 10 | 15 | 30 | 60</code>
    *          </p>
    *          <p>Default: <code>0</code>
@@ -5252,13 +5252,16 @@ export interface CreateDBClusterMessage {
    *             see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling">Setting
    *                 up and enabling Enhanced Monitoring</a> in the <i>Amazon RDS User Guide</i>.</p>
    *          <p>If <code>MonitoringInterval</code> is set to a value other than <code>0</code>, supply a <code>MonitoringRoleArn</code> value.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    * @public
    */
   MonitoringRoleArn?: string | undefined;
 
   /**
-   * <p>Specifies the mode of Database Insights to enable for the cluster.</p>
+   * <p>The mode of Database Insights to enable for the DB cluster.</p>
+   *          <p>If you set this value to <code>advanced</code>, you must also set the <code>PerformanceInsightsEnabled</code>
+   *             parameter to <code>true</code> and the <code>PerformanceInsightsRetentionPeriod</code> parameter to 465.</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters only</p>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
@@ -5267,7 +5270,7 @@ export interface CreateDBClusterMessage {
    * <p>Specifies whether to turn on Performance Insights for the DB cluster.</p>
    *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html">
    *             Using Amazon Performance Insights</a> in the <i>Amazon RDS User Guide</i>.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    * @public
    */
   EnablePerformanceInsights?: boolean | undefined;
@@ -5278,14 +5281,14 @@ export interface CreateDBClusterMessage {
    *          <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS
    *             uses your default KMS key. There is a default KMS key for your Amazon Web Services account.
    *             Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    * @public
    */
   PerformanceInsightsKMSKeyId?: string | undefined;
 
   /**
    * <p>The number of days to retain Performance Insights data.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    *          <p>Valid Values:</p>
    *          <ul>
    *             <li>
@@ -6412,34 +6415,34 @@ export interface DBCluster {
 
   /**
    * <p>Indicates whether minor version patches are applied automatically.</p>
-   *          <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
+   *          <p>This setting is for Aurora DB clusters and Multi-AZ DB clusters.</p>
    * @public
    */
   AutoMinorVersionUpgrade?: boolean | undefined;
 
   /**
    * <p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster.</p>
-   *          <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
+   *          <p>This setting is only for -Aurora DB clusters and Multi-AZ DB clusters.</p>
    * @public
    */
   MonitoringInterval?: number | undefined;
 
   /**
    * <p>The ARN for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.</p>
-   *          <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
+   *          <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>
    * @public
    */
   MonitoringRoleArn?: string | undefined;
 
   /**
-   * <p>The mode of Database Insights that is enabled for the cluster.</p>
+   * <p>The mode of Database Insights that is enabled for the DB cluster.</p>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
 
   /**
    * <p>Indicates whether Performance Insights is enabled for the DB cluster.</p>
-   *          <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
+   *          <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>
    * @public
    */
   PerformanceInsightsEnabled?: boolean | undefined;
@@ -6447,14 +6450,14 @@ export interface DBCluster {
   /**
    * <p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</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>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
+   *          <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>
    * @public
    */
   PerformanceInsightsKMSKeyId?: string | undefined;
 
   /**
    * <p>The number of days to retain Performance Insights data.</p>
-   *          <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
+   *          <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>
    *          <p>Valid Values:</p>
    *          <ul>
    *             <li>
@@ -8413,7 +8416,11 @@ export interface CreateDBInstanceMessage {
   EnableIAMDatabaseAuthentication?: boolean | undefined;
 
   /**
-   * <p>Specifies the mode of Database Insights to enable for the instance.</p>
+   * <p>The mode of Database Insights to enable for the DB instance.</p>
+   *          <p>This setting only applies to Amazon Aurora DB instances.</p>
+   *          <note>
+   *             <p>Currently, this value is inherited from the DB cluster and can't be changed.</p>
+   *          </note>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
@@ -10406,7 +10413,10 @@ export interface CreateDBInstanceReadReplicaMessage {
   EnableIAMDatabaseAuthentication?: boolean | undefined;
 
   /**
-   * <p>Specifies the mode of Database Insights.</p>
+   * <p>The mode of Database Insights to enable for the read replica.</p>
+   *          <note>
+   *             <p>Currently, this setting is not supported.</p>
+   *          </note>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
@@ -10665,6 +10675,7 @@ export interface CreateDBInstanceReadReplicaMessage {
   /**
    * <p>The amount of storage (in gibibytes) to allocate initially for the read replica.
    *             Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>
+   *          <p>This setting isn't valid for RDS for SQL Server.</p>
    *          <note>
    *             <p>Be sure to allocate enough storage for your read replica so that the create operation can succeed.
    *                 You can also allocate additional storage for future growth.</p>
diff --git a/clients/client-rds/src/models/models_1.ts b/clients/client-rds/src/models/models_1.ts
index b71de923f23d..7708bac774cf 100644
--- a/clients/client-rds/src/models/models_1.ts
+++ b/clients/client-rds/src/models/models_1.ts
@@ -976,17 +976,17 @@ export interface DescribeDBClusterParametersMessage {
    *          <ul>
    *             <li>
    *                <p>
-   *                   <code>customer</code>
+   *                   <code>engine-default</code>
    *                </p>
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>engine</code>
+   *                   <code>system</code>
    *                </p>
    *             </li>
    *             <li>
    *                <p>
-   *                   <code>service</code>
+   *                   <code>user</code>
    *                </p>
    *             </li>
    *          </ul>
@@ -995,7 +995,8 @@ export interface DescribeDBClusterParametersMessage {
   Source?: string | undefined;
 
   /**
-   * <p>This parameter isn't currently supported.</p>
+   * <p>A filter that specifies one or more DB cluster parameters to describe.</p>
+   *          <p>The only supported filter is <code>parameter-name</code>. The results list only includes information about the DB cluster parameters with these names.</p>
    * @public
    */
   Filters?: Filter[] | undefined;
@@ -2076,7 +2077,8 @@ export interface DescribeDBParametersMessage {
   Source?: string | undefined;
 
   /**
-   * <p>This parameter isn't currently supported.</p>
+   * <p>A filter that specifies one or more DB parameters to describe.</p>
+   *          <p>The only supported filter is <code>parameter-name</code>. The results list only includes information about the DB parameters with these names.</p>
    * @public
    */
   Filters?: Filter[] | undefined;
@@ -4398,7 +4400,8 @@ export interface DescribeEngineDefaultParametersMessage {
   DBParameterGroupFamily: string | undefined;
 
   /**
-   * <p>This parameter isn't currently supported.</p>
+   * <p>A filter that specifies one or more parameters to describe.</p>
+   *          <p>The only supported filter is <code>parameter-name</code>. The results list only includes information about the parameters with these names.</p>
    * @public
    */
   Filters?: Filter[] | undefined;
@@ -7413,12 +7416,50 @@ export interface ModifyCustomDBEngineVersionMessage {
 export interface CloudwatchLogsExportConfiguration {
   /**
    * <p>The list of log types to enable.</p>
+   *          <p>The following values are valid for each DB engine:</p>
+   *          <ul>
+   *             <li>
+   *                <p>Aurora MySQL - <code>audit | error | general | slowquery</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>Aurora PostgreSQL - <code>postgresql</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>RDS for MySQL - <code>error | general | slowquery</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>RDS for PostgreSQL - <code>postgresql | upgrade</code>
+   *                </p>
+   *             </li>
+   *          </ul>
    * @public
    */
   EnableLogTypes?: string[] | undefined;
 
   /**
    * <p>The list of log types to disable.</p>
+   *          <p>The following values are valid for each DB engine:</p>
+   *          <ul>
+   *             <li>
+   *                <p>Aurora MySQL - <code>audit | error | general | slowquery</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>Aurora PostgreSQL - <code>postgresql</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>RDS for MySQL - <code>error | general | slowquery</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>RDS for PostgreSQL - <code>postgresql | upgrade</code>
+   *                </p>
+   *             </li>
+   *          </ul>
    * @public
    */
   DisableLogTypes?: string[] | undefined;
@@ -7863,7 +7904,7 @@ export interface ModifyDBClusterMessage {
   /**
    * <p>Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window.
    *             By default, minor engine upgrades are applied automatically.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    * @public
    */
   AutoMinorVersionUpgrade?: boolean | undefined;
@@ -7895,7 +7936,13 @@ export interface ModifyDBClusterMessage {
   MonitoringRoleArn?: string | undefined;
 
   /**
-   * <p>Specifies the mode of Database Insights to enable for the cluster.</p>
+   * <p>Specifies the mode of Database Insights to enable for the DB cluster.</p>
+   *          <p>If you change the value from <code>standard</code> to <code>advanced</code>, you must set the
+   *             <code>PerformanceInsightsEnabled</code> parameter to <code>true</code> and the
+   *             <code>PerformanceInsightsRetentionPeriod</code> parameter to 465.</p>
+   *          <p>If you change the value from <code>advanced</code> to <code>standard</code>, you must
+   *             set the <code>PerformanceInsightsEnabled</code> parameter to <code>false</code>.</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters only</p>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
@@ -7915,14 +7962,14 @@ export interface ModifyDBClusterMessage {
    *          <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS
    *             uses your default KMS key. There is a default KMS key for your Amazon Web Services account.
    *             Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    * @public
    */
   PerformanceInsightsKMSKeyId?: string | undefined;
 
   /**
    * <p>The number of days to retain Performance Insights data.</p>
-   *          <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>
+   *          <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>
    *          <p>Valid Values:</p>
    *          <ul>
    *             <li>
@@ -9079,7 +9126,11 @@ export interface ModifyDBInstanceMessage {
   EnableIAMDatabaseAuthentication?: boolean | undefined;
 
   /**
-   * <p>Specifies the mode of Database Insights to enable for the instance.</p>
+   * <p>Specifies the mode of Database Insights to enable for the DB instance.</p>
+   *          <p>This setting only applies to Amazon Aurora DB instances.</p>
+   *          <note>
+   *             <p>Currently, this value is inherited from the DB cluster and can't be changed.</p>
+   *          </note>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
@@ -9137,6 +9188,28 @@ export interface ModifyDBInstanceMessage {
    *          <p>A change to the <code>CloudwatchLogsExportConfiguration</code> parameter is always applied to the DB instance
    *             immediately. Therefore, the <code>ApplyImmediately</code> parameter has no effect.</p>
    *          <p>This setting doesn't apply to RDS Custom DB instances.</p>
+   *          <p>The following values are valid for each DB engine:</p>
+   *          <ul>
+   *             <li>
+   *                <p>Aurora MySQL - <code>audit | error | general | slowquery</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>Aurora PostgreSQL - <code>postgresql</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>RDS for MySQL - <code>error | general | slowquery</code>
+   *                </p>
+   *             </li>
+   *             <li>
+   *                <p>RDS for PostgreSQL - <code>postgresql | upgrade</code>
+   *                </p>
+   *             </li>
+   *          </ul>
+   *          <p>For more information about exporting CloudWatch Logs for Amazon RDS, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch">
+   *             Publishing Database Logs to Amazon CloudWatch Logs</a> in the <i>Amazon RDS User Guide</i>.</p>
+   *          <p>For more information about exporting CloudWatch Logs for Amazon Aurora, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch">Publishing Database Logs to Amazon CloudWatch Logs</a> in the <i>Amazon Aurora User Guide</i>.</p>
    * @public
    */
   CloudwatchLogsExportConfiguration?: CloudwatchLogsExportConfiguration | undefined;
@@ -13198,6 +13271,7 @@ export interface RestoreDBInstanceFromDBSnapshotMessage {
   /**
    * <p>The amount of storage (in gibibytes) to allocate initially for the DB instance. Follow the allocation rules specified in
    *             CreateDBInstance.</p>
+   *          <p>This setting isn't valid for RDS for SQL Server.</p>
    *          <note>
    *             <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed. You can also
    *                 allocate additional storage for future growth.</p>
@@ -13293,6 +13367,7 @@ export interface RestoreDBInstanceFromS3Message {
   /**
    * <p>The amount of storage (in gibibytes) to allocate initially for the DB instance.
    *             Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>
+   *          <p>This setting isn't valid for RDS for SQL Server.</p>
    *          <note>
    *             <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed.
    *                 You can also allocate additional storage for future growth.</p>
@@ -13678,7 +13753,11 @@ export interface RestoreDBInstanceFromS3Message {
   S3IngestionRoleArn: string | undefined;
 
   /**
-   * <p>Specifies the mode of Database Insights to enable for the instance.</p>
+   * <p>Specifies the mode of Database Insights to enable for the DB instance.</p>
+   *          <p>This setting only applies to Amazon Aurora DB instances.</p>
+   *          <note>
+   *             <p>Currently, this value is inherited from the DB cluster and can't be changed.</p>
+   *          </note>
    * @public
    */
   DatabaseInsightsMode?: DatabaseInsightsMode | undefined;
@@ -14561,6 +14640,7 @@ export interface RestoreDBInstanceToPointInTimeMessage {
   /**
    * <p>The amount of storage (in gibibytes) to allocate initially for the DB instance.
    *             Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>
+   *          <p>This setting isn't valid for RDS for SQL Server.</p>
    *          <note>
    *             <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed.
    *                 You can also allocate additional storage for future growth.</p>
diff --git a/codegen/sdk-codegen/aws-models/rds.json b/codegen/sdk-codegen/aws-models/rds.json
index 7a6ac4c2330f..15b0441fb7ba 100644
--- a/codegen/sdk-codegen/aws-models/rds.json
+++ b/codegen/sdk-codegen/aws-models/rds.json
@@ -2900,13 +2900,13 @@
         "EnableLogTypes": {
           "target": "com.amazonaws.rds#LogTypeList",
           "traits": {
-            "smithy.api#documentation": "<p>The list of log types to enable.</p>"
+            "smithy.api#documentation": "<p>The list of log types to enable.</p>\n         <p>The following values are valid for each DB engine:</p>\n         <ul>\n            <li>\n               <p>Aurora MySQL - <code>audit | error | general | slowquery</code>\n               </p>\n            </li>\n            <li>\n               <p>Aurora PostgreSQL - <code>postgresql</code>\n               </p>\n            </li>\n            <li>\n               <p>RDS for MySQL - <code>error | general | slowquery</code>\n               </p>\n            </li>\n            <li>\n               <p>RDS for PostgreSQL - <code>postgresql | upgrade</code>\n               </p>\n            </li>\n         </ul>"
           }
         },
         "DisableLogTypes": {
           "target": "com.amazonaws.rds#LogTypeList",
           "traits": {
-            "smithy.api#documentation": "<p>The list of log types to disable.</p>"
+            "smithy.api#documentation": "<p>The list of log types to disable.</p>\n         <p>The following values are valid for each DB engine:</p>\n         <ul>\n            <li>\n               <p>Aurora MySQL - <code>audit | error | general | slowquery</code>\n               </p>\n            </li>\n            <li>\n               <p>Aurora PostgreSQL - <code>postgresql</code>\n               </p>\n            </li>\n            <li>\n               <p>RDS for MySQL - <code>error | general | slowquery</code>\n               </p>\n            </li>\n            <li>\n               <p>RDS for PostgreSQL - <code>postgresql | upgrade</code>\n               </p>\n            </li>\n         </ul>"
           }
         }
       },
@@ -4434,43 +4434,43 @@
         "AutoMinorVersionUpgrade": {
           "target": "com.amazonaws.rds#BooleanOptional",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. \n            By default, minor engine upgrades are applied automatically.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>"
+            "smithy.api#documentation": "<p>Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. \n            By default, minor engine upgrades are applied automatically.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB cluster</p>"
           }
         },
         "MonitoringInterval": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off \n            collecting Enhanced Monitoring metrics, specify <code>0</code>.</p>\n         <p>If <code>MonitoringRoleArn</code> is specified, also set <code>MonitoringInterval</code>\n            to a value other than <code>0</code>.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>\n         <p>Valid Values: <code>0 | 1 | 5 | 10 | 15 | 30 | 60</code>\n         </p>\n         <p>Default: <code>0</code>\n         </p>"
+            "smithy.api#documentation": "<p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off \n            collecting Enhanced Monitoring metrics, specify <code>0</code>.</p>\n         <p>If <code>MonitoringRoleArn</code> is specified, also set <code>MonitoringInterval</code>\n            to a value other than <code>0</code>.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>\n         <p>Valid Values: <code>0 | 1 | 5 | 10 | 15 | 30 | 60</code>\n         </p>\n         <p>Default: <code>0</code>\n         </p>"
           }
         },
         "MonitoringRoleArn": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. \n            An example is <code>arn:aws:iam:123456789012:role/emaccess</code>. For information on creating a monitoring role,\n            see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling\">Setting \n                up and enabling Enhanced Monitoring</a> in the <i>Amazon RDS User Guide</i>.</p>\n         <p>If <code>MonitoringInterval</code> is set to a value other than <code>0</code>, supply a <code>MonitoringRoleArn</code> value.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>"
+            "smithy.api#documentation": "<p>The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. \n            An example is <code>arn:aws:iam:123456789012:role/emaccess</code>. For information on creating a monitoring role,\n            see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling\">Setting \n                up and enabling Enhanced Monitoring</a> in the <i>Amazon RDS User Guide</i>.</p>\n         <p>If <code>MonitoringInterval</code> is set to a value other than <code>0</code>, supply a <code>MonitoringRoleArn</code> value.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>"
           }
         },
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the cluster.</p>"
+            "smithy.api#documentation": "<p>The mode of Database Insights to enable for the DB cluster.</p>\n         <p>If you set this value to <code>advanced</code>, you must also set the <code>PerformanceInsightsEnabled</code>\n            parameter to <code>true</code> and the <code>PerformanceInsightsRetentionPeriod</code> parameter to 465.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters only</p>"
           }
         },
         "EnablePerformanceInsights": {
           "target": "com.amazonaws.rds#BooleanOptional",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether to turn on Performance Insights for the DB cluster.</p>\n         <p>For more information, see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html\">\n            Using Amazon Performance Insights</a> in the <i>Amazon RDS User Guide</i>.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>"
+            "smithy.api#documentation": "<p>Specifies whether to turn on Performance Insights for the DB cluster.</p>\n         <p>For more information, see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html\">\n            Using Amazon Performance Insights</a> in the <i>Amazon RDS User Guide</i>.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>"
           }
         },
         "PerformanceInsightsKMSKeyId": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "smithy.api#documentation": "<p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>\n         <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>\n         <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS \n            uses your default KMS key. There is a default KMS key for your Amazon Web Services account. \n            Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>"
+            "smithy.api#documentation": "<p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>\n         <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>\n         <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS \n            uses your default KMS key. There is a default KMS key for your Amazon Web Services account. \n            Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>"
           }
         },
         "PerformanceInsightsRetentionPeriod": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The number of days to retain Performance Insights data.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>7</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <i>month</i> * 31, where <i>month</i> is a number of months from 1-23. \n                Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>\n            </li>\n            <li>\n               <p>\n                  <code>731</code>\n               </p>\n            </li>\n         </ul>\n         <p>Default: <code>7</code> days</p>\n         <p>If you specify a retention period that isn't valid, such as <code>94</code>,  Amazon RDS issues an error.</p>"
+            "smithy.api#documentation": "<p>The number of days to retain Performance Insights data.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>7</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <i>month</i> * 31, where <i>month</i> is a number of months from 1-23. \n                Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>\n            </li>\n            <li>\n               <p>\n                  <code>731</code>\n               </p>\n            </li>\n         </ul>\n         <p>Default: <code>7</code> days</p>\n         <p>If you specify a retention period that isn't valid, such as <code>94</code>,  Amazon RDS issues an error.</p>"
           }
         },
         "EnableLimitlessDatabase": {
@@ -5200,7 +5200,7 @@
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the instance.</p>"
+            "smithy.api#documentation": "<p>The mode of Database Insights to enable for the DB instance.</p>\n         <p>This setting only applies to Amazon Aurora DB instances.</p>\n         <note>\n            <p>Currently, this value is inherited from the DB cluster and can't be changed.</p>\n         </note>"
           }
         },
         "EnablePerformanceInsights": {
@@ -5559,7 +5559,7 @@
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the mode of Database Insights.</p>"
+            "smithy.api#documentation": "<p>The mode of Database Insights to enable for the read replica.</p>\n         <note>\n            <p>Currently, this setting is not supported.</p>\n         </note>"
           }
         },
         "EnablePerformanceInsights": {
@@ -5679,7 +5679,7 @@
         "AllocatedStorage": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the read replica.\n            Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your read replica so that the create operation can succeed.\n                You can also allocate additional storage for future growth.</p>\n         </note>"
+            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the read replica.\n            Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>\n         <p>This setting isn't valid for RDS for SQL Server.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your read replica so that the create operation can succeed.\n                You can also allocate additional storage for future growth.</p>\n         </note>"
           }
         },
         "SourceDBClusterIdentifier": {
@@ -7486,43 +7486,43 @@
         "AutoMinorVersionUpgrade": {
           "target": "com.amazonaws.rds#Boolean",
           "traits": {
-            "smithy.api#documentation": "<p>Indicates whether minor version patches are applied automatically.</p>\n         <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>"
+            "smithy.api#documentation": "<p>Indicates whether minor version patches are applied automatically.</p>\n         <p>This setting is for Aurora DB clusters and Multi-AZ DB clusters.</p>"
           }
         },
         "MonitoringInterval": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster.</p>\n         <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>"
+            "smithy.api#documentation": "<p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster.</p>\n         <p>This setting is only for -Aurora DB clusters and Multi-AZ DB clusters.</p>"
           }
         },
         "MonitoringRoleArn": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "smithy.api#documentation": "<p>The ARN for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.</p>\n         <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>"
+            "smithy.api#documentation": "<p>The ARN for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.</p>\n         <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>"
           }
         },
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>The mode of Database Insights that is enabled for the cluster.</p>"
+            "smithy.api#documentation": "<p>The mode of Database Insights that is enabled for the DB cluster.</p>"
           }
         },
         "PerformanceInsightsEnabled": {
           "target": "com.amazonaws.rds#BooleanOptional",
           "traits": {
-            "smithy.api#documentation": "<p>Indicates whether Performance Insights is enabled for the DB cluster.</p>\n         <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>"
+            "smithy.api#documentation": "<p>Indicates whether Performance Insights is enabled for the DB cluster.</p>\n         <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>"
           }
         },
         "PerformanceInsightsKMSKeyId": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "smithy.api#documentation": "<p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>\n         <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>\n         <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>"
+            "smithy.api#documentation": "<p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>\n         <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>\n         <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>"
           }
         },
         "PerformanceInsightsRetentionPeriod": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The number of days to retain Performance Insights data.</p>\n         <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>7</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <i>month</i> * 31, where <i>month</i> is a number of months from 1-23. \n                Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>\n            </li>\n            <li>\n               <p>\n                  <code>731</code>\n               </p>\n            </li>\n         </ul>\n         <p>Default: <code>7</code> days</p>"
+            "smithy.api#documentation": "<p>The number of days to retain Performance Insights data.</p>\n         <p>This setting is only for Aurora DB clusters and Multi-AZ DB clusters.</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>7</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <i>month</i> * 31, where <i>month</i> is a number of months from 1-23. \n                Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>\n            </li>\n            <li>\n               <p>\n                  <code>731</code>\n               </p>\n            </li>\n         </ul>\n         <p>Default: <code>7</code> days</p>"
           }
         },
         "ServerlessV2ScalingConfiguration": {
@@ -14008,13 +14008,13 @@
         "Source": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "smithy.api#documentation": "<p>A specific source to return parameters for.</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>customer</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>engine</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>service</code>\n               </p>\n            </li>\n         </ul>"
+            "smithy.api#documentation": "<p>A specific source to return parameters for.</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>engine-default</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>system</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <code>user</code>\n               </p>\n            </li>\n         </ul>"
           }
         },
         "Filters": {
           "target": "com.amazonaws.rds#FilterList",
           "traits": {
-            "smithy.api#documentation": "<p>This parameter isn't currently supported.</p>"
+            "smithy.api#documentation": "<p>A filter that specifies one or more DB cluster parameters to describe.</p>\n         <p>The only supported filter is <code>parameter-name</code>. The results list only includes information about the DB cluster parameters with these names.</p>"
           }
         },
         "MaxRecords": {
@@ -15458,7 +15458,7 @@
         "Filters": {
           "target": "com.amazonaws.rds#FilterList",
           "traits": {
-            "smithy.api#documentation": "<p>This parameter isn't currently supported.</p>"
+            "smithy.api#documentation": "<p>A filter that specifies one or more DB parameters to describe.</p>\n         <p>The only supported filter is <code>parameter-name</code>. The results list only includes information about the DB parameters with these names.</p>"
           }
         },
         "MaxRecords": {
@@ -16649,7 +16649,7 @@
         "Filters": {
           "target": "com.amazonaws.rds#FilterList",
           "traits": {
-            "smithy.api#documentation": "<p>This parameter isn't currently supported.</p>"
+            "smithy.api#documentation": "<p>A filter that specifies one or more parameters to describe.</p>\n         <p>The only supported filter is <code>parameter-name</code>. The results list only includes information about the parameters with these names.</p>"
           }
         },
         "MaxRecords": {
@@ -21750,7 +21750,7 @@
         "AutoMinorVersionUpgrade": {
           "target": "com.amazonaws.rds#BooleanOptional",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. \n            By default, minor engine upgrades are applied automatically.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>"
+            "smithy.api#documentation": "<p>Specifies whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. \n            By default, minor engine upgrades are applied automatically.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>"
           }
         },
         "MonitoringInterval": {
@@ -21768,7 +21768,7 @@
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the cluster.</p>"
+            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the DB cluster.</p>\n         <p>If you change the value from <code>standard</code> to <code>advanced</code>, you must set the \n            <code>PerformanceInsightsEnabled</code> parameter to <code>true</code> and the \n            <code>PerformanceInsightsRetentionPeriod</code> parameter to 465.</p>\n         <p>If you change the value from <code>advanced</code> to <code>standard</code>, you must \n            set the <code>PerformanceInsightsEnabled</code> parameter to <code>false</code>.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters only</p>"
           }
         },
         "EnablePerformanceInsights": {
@@ -21780,13 +21780,13 @@
         "PerformanceInsightsKMSKeyId": {
           "target": "com.amazonaws.rds#String",
           "traits": {
-            "smithy.api#documentation": "<p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>\n         <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>\n         <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS \n            uses your default KMS key. There is a default KMS key for your Amazon Web Services account. \n            Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>"
+            "smithy.api#documentation": "<p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>\n         <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>\n         <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS \n            uses your default KMS key. There is a default KMS key for your Amazon Web Services account. \n            Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>"
           }
         },
         "PerformanceInsightsRetentionPeriod": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The number of days to retain Performance Insights data.</p>\n         <p>Valid for Cluster Type: Multi-AZ DB clusters only</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>7</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <i>month</i> * 31, where <i>month</i> is a number of months from 1-23. \n                Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>\n            </li>\n            <li>\n               <p>\n                  <code>731</code>\n               </p>\n            </li>\n         </ul>\n         <p>Default: <code>7</code> days</p>\n         <p>If you specify a retention period that isn't valid, such as <code>94</code>,  Amazon RDS issues an error.</p>"
+            "smithy.api#documentation": "<p>The number of days to retain Performance Insights data.</p>\n         <p>Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters</p>\n         <p>Valid Values:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>7</code>\n               </p>\n            </li>\n            <li>\n               <p>\n                  <i>month</i> * 31, where <i>month</i> is a number of months from 1-23. \n                Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>\n            </li>\n            <li>\n               <p>\n                  <code>731</code>\n               </p>\n            </li>\n         </ul>\n         <p>Default: <code>7</code> days</p>\n         <p>If you specify a retention period that isn't valid, such as <code>94</code>,  Amazon RDS issues an error.</p>"
           }
         },
         "ServerlessV2ScalingConfiguration": {
@@ -22389,7 +22389,7 @@
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the instance.</p>"
+            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the DB instance.</p>\n         <p>This setting only applies to Amazon Aurora DB instances.</p>\n         <note>\n            <p>Currently, this value is inherited from the DB cluster and can't be changed.</p>\n         </note>"
           }
         },
         "EnablePerformanceInsights": {
@@ -22413,7 +22413,7 @@
         "CloudwatchLogsExportConfiguration": {
           "target": "com.amazonaws.rds#CloudwatchLogsExportConfiguration",
           "traits": {
-            "smithy.api#documentation": "<p>The log types to be enabled for export to CloudWatch Logs for a \n            specific DB instance.</p>\n         <p>A change to the <code>CloudwatchLogsExportConfiguration</code> parameter is always applied to the DB instance \n            immediately. Therefore, the <code>ApplyImmediately</code> parameter has no effect.</p>\n         <p>This setting doesn't apply to RDS Custom DB instances.</p>"
+            "smithy.api#documentation": "<p>The log types to be enabled for export to CloudWatch Logs for a \n            specific DB instance.</p>\n         <p>A change to the <code>CloudwatchLogsExportConfiguration</code> parameter is always applied to the DB instance \n            immediately. Therefore, the <code>ApplyImmediately</code> parameter has no effect.</p>\n         <p>This setting doesn't apply to RDS Custom DB instances.</p>\n         <p>The following values are valid for each DB engine:</p>\n         <ul>\n            <li>\n               <p>Aurora MySQL - <code>audit | error | general | slowquery</code>\n               </p>\n            </li>\n            <li>\n               <p>Aurora PostgreSQL - <code>postgresql</code>\n               </p>\n            </li>\n            <li>\n               <p>RDS for MySQL - <code>error | general | slowquery</code>\n               </p>\n            </li>\n            <li>\n               <p>RDS for PostgreSQL - <code>postgresql | upgrade</code>\n               </p>\n            </li>\n         </ul>\n         <p>For more information about exporting CloudWatch Logs for Amazon RDS, see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch\">\n            Publishing Database Logs to Amazon CloudWatch Logs</a> in the <i>Amazon RDS User Guide</i>.</p>\n         <p>For more information about exporting CloudWatch Logs for Amazon Aurora, see <a href=\"https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch\">Publishing Database Logs to Amazon CloudWatch Logs</a> in the <i>Amazon Aurora User Guide</i>.</p>"
           }
         },
         "ProcessorFeatures": {
@@ -28127,7 +28127,7 @@
         "AllocatedStorage": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the DB instance. Follow the allocation rules specified in\n            CreateDBInstance.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed. You can also\n                allocate additional storage for future growth.</p>\n         </note>"
+            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the DB instance. Follow the allocation rules specified in\n            CreateDBInstance.</p>\n         <p>This setting isn't valid for RDS for SQL Server.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed. You can also\n                allocate additional storage for future growth.</p>\n         </note>"
           }
         },
         "DedicatedLogVolume": {
@@ -28256,7 +28256,7 @@
         "AllocatedStorage": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the DB instance.\n            Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed.\n                You can also allocate additional storage for future growth.</p>\n         </note>"
+            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the DB instance.\n            Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>\n         <p>This setting isn't valid for RDS for SQL Server.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed.\n                You can also allocate additional storage for future growth.</p>\n         </note>"
           }
         },
         "DBInstanceClass": {
@@ -28472,7 +28472,7 @@
         "DatabaseInsightsMode": {
           "target": "com.amazonaws.rds#DatabaseInsightsMode",
           "traits": {
-            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the instance.</p>"
+            "smithy.api#documentation": "<p>Specifies the mode of Database Insights to enable for the DB instance.</p>\n         <p>This setting only applies to Amazon Aurora DB instances.</p>\n         <note>\n            <p>Currently, this value is inherited from the DB cluster and can't be changed.</p>\n         </note>"
           }
         },
         "EnablePerformanceInsights": {
@@ -29017,7 +29017,7 @@
         "AllocatedStorage": {
           "target": "com.amazonaws.rds#IntegerOptional",
           "traits": {
-            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the DB instance.\n            Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed.\n                You can also allocate additional storage for future growth.</p>\n         </note>"
+            "smithy.api#documentation": "<p>The amount of storage (in gibibytes) to allocate initially for the DB instance.\n            Follow the allocation rules specified in <code>CreateDBInstance</code>.</p>\n         <p>This setting isn't valid for RDS for SQL Server.</p>\n         <note>\n            <p>Be sure to allocate enough storage for your new DB instance so that the restore operation can succeed.\n                You can also allocate additional storage for future growth.</p>\n         </note>"
           }
         },
         "DedicatedLogVolume": {