diff --git a/tools/code-generation/smithy/api-descriptions/rds.json b/tools/code-generation/smithy/api-descriptions/rds.json
index 7906ba4e51e..d41295db5b1 100644
--- a/tools/code-generation/smithy/api-descriptions/rds.json
+++ b/tools/code-generation/smithy/api-descriptions/rds.json
@@ -2906,13 +2906,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>"
                     }
                 }
             },
@@ -4462,43 +4462,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": {
@@ -5232,7 +5232,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": {
@@ -5591,7 +5591,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": {
@@ -5711,7 +5711,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": {
@@ -7528,43 +7528,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": {
@@ -14071,13 +14071,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": {
@@ -15537,7 +15537,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": {
@@ -16735,7 +16735,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": {
@@ -21871,7 +21871,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": {
@@ -21889,7 +21889,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": {
@@ -21901,13 +21901,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": {
@@ -22514,7 +22514,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": {
@@ -22538,7 +22538,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": {
@@ -28289,7 +28289,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": {
@@ -28418,7 +28418,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": {
@@ -28634,7 +28634,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": {
@@ -29179,7 +29179,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": {