AWS RDS DataService Update: Documentation updates for RDS Data API

Author: AWS

.changes/next-release/feature-AWSRDSDataService-5c0d0c2.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS RDS DataService",
+    "contributor": "",
+    "description": "Documentation updates for RDS Data API"
+}

services/rdsdata/src/main/resources/codegen-resources/service-2.json

@@ -29,7 +29,7 @@
         {"shape":"ForbiddenException"},
         {"shape":"ServiceUnavailableError"}
       ],
-      "documentation":"<p>Runs a batch SQL statement over an array of data.</p> <p>You can run bulk update and insert operations for multiple records using a DML statement with different parameter sets. Bulk operations can provide a significant performance improvement over individual insert and update operations.</p> <important> <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter, changes that result from the call are committed automatically.</p> </important>"
+      "documentation":"<p>Runs a batch SQL statement over an array of data.</p> <p>You can run bulk update and insert operations for multiple records using a DML statement with different parameter sets. Bulk operations can provide a significant performance improvement over individual insert and update operations.</p> <important> <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter, changes that result from the call are committed automatically.</p> <p>There isn't a fixed upper limit on the number of parameter sets. However, the maximum size of the HTTP request submitted through the Data API is 4 MiB. If the request exceeds this limit, the Data API returns an error and doesn't process the request. This 4-MiB limit includes the size of the HTTP headers and the JSON notation in the request. Thus, the number of parameter sets that you can include depends on a combination of factors, such as the size of the SQL statement and the size of each parameter set.</p> <p>The response size limit is 1 MiB. If the call returns more than 1 MiB of response data, the call is terminated.</p> </important>"
     },
     "BeginTransaction":{
       "name":"BeginTransaction",
@@ -107,7 +107,7 @@
         {"shape":"ForbiddenException"},
         {"shape":"ServiceUnavailableError"}
       ],
-      "documentation":"<p>Runs a SQL statement against a database.</p> <important> <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter, changes that result from the call are committed automatically.</p> </important> <p>If the binary response data from the database is more than 1 MB, the call is terminated.</p>"
+      "documentation":"<p>Runs a SQL statement against a database.</p> <important> <p>If a call isn't part of a transaction because it doesn't include the <code>transactionID</code> parameter, changes that result from the call are committed automatically.</p> <p>If the binary response data from the database is more than 1 MB, the call is terminated.</p> </important>"
     },
     "RollbackTransaction":{
       "name":"RollbackTransaction",
@@ -225,11 +225,11 @@
         },
         "secretArn":{
           "shape":"Arn",
-          "documentation":"<p>The name or ARN of the secret that enables access to the DB cluster.</p>"
+          "documentation":"<p>The ARN of the secret that enables access to the DB cluster. Enter the database user name and password for the credentials in the secret.</p> <p>For information about creating the secret, see <a href=\"https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html\">Create a database secret</a>.</p>"
         },
         "sql":{
           "shape":"SqlStatement",
-          "documentation":"<p>The SQL statement to run.</p>"
+          "documentation":"<p>The SQL statement to run. Don't include a semicolon (;) at the end of the SQL statement.</p>"
         },
         "transactionId":{
           "shape":"Id",
@@ -434,7 +434,7 @@
       "members":{
         "awsSecretStoreArn":{
           "shape":"Arn",
-          "documentation":"<p>The Amazon Resource Name (ARN) of the secret that enables access to the DB cluster.</p>"
+          "documentation":"<p>The Amazon Resource Name (ARN) of the secret that enables access to the DB cluster. Enter the database user name and password for the credentials in the secret.</p> <p>For information about creating the secret, see <a href=\"https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html\">Create a database secret</a>.</p>"
         },
         "database":{
           "shape":"DbName",
@@ -507,7 +507,7 @@
         },
         "secretArn":{
           "shape":"Arn",
-          "documentation":"<p>The name or ARN of the secret that enables access to the DB cluster.</p>"
+          "documentation":"<p>The ARN of the secret that enables access to the DB cluster. Enter the database user name and password for the credentials in the secret.</p> <p>For information about creating the secret, see <a href=\"https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html\">Create a database secret</a>.</p>"
         },
         "sql":{
           "shape":"SqlStatement",