feat(client-rds-data): Add support for the automatic pause/resume feature of Aurora Serverless v2.

Author: awstools

clients/client-rds-data/src/commands/BatchExecuteStatementCommand.ts

@@ -177,6 +177,11 @@ export interface BatchExecuteStatementCommandOutput extends BatchExecuteStatemen
  * @throws {@link DatabaseNotFoundException} (client fault)
  *  <p>The DB cluster doesn't have a DB instance.</p>
  *
+ * @throws {@link DatabaseResumingException} (client fault)
+ *  <p>A request was canceled because the Aurora Serverless v2 DB instance was in a paused state.
+ *       The Data API request automatically causes the DB instance to begin resuming. Wait a few seconds and
+ *       try again.</p>
+ *
  * @throws {@link DatabaseUnavailableException} (server fault)
  *  <p>The writer instance in the DB cluster isn't available.</p>
  *

clients/client-rds-data/src/commands/BeginTransactionCommand.ts

@@ -75,6 +75,11 @@ export interface BeginTransactionCommandOutput extends BeginTransactionResponse,
  * @throws {@link DatabaseNotFoundException} (client fault)
  *  <p>The DB cluster doesn't have a DB instance.</p>
  *
+ * @throws {@link DatabaseResumingException} (client fault)
+ *  <p>A request was canceled because the Aurora Serverless v2 DB instance was in a paused state.
+ *       The Data API request automatically causes the DB instance to begin resuming. Wait a few seconds and
+ *       try again.</p>
+ *
  * @throws {@link DatabaseUnavailableException} (server fault)
  *  <p>The writer instance in the DB cluster isn't available.</p>
  *

clients/client-rds-data/src/commands/ExecuteStatementCommand.ts

@@ -204,6 +204,11 @@ export interface ExecuteStatementCommandOutput extends ExecuteStatementResponse,
  * @throws {@link DatabaseNotFoundException} (client fault)
  *  <p>The DB cluster doesn't have a DB instance.</p>
  *
+ * @throws {@link DatabaseResumingException} (client fault)
+ *  <p>A request was canceled because the Aurora Serverless v2 DB instance was in a paused state.
+ *       The Data API request automatically causes the DB instance to begin resuming. Wait a few seconds and
+ *       try again.</p>
+ *
  * @throws {@link DatabaseUnavailableException} (server fault)
  *  <p>The writer instance in the DB cluster isn't available.</p>
  *

clients/client-rds-data/src/models/models_0.ts

@@ -101,6 +101,28 @@ export class DatabaseNotFoundException extends __BaseException {
   }
 }
 
+/**
+ * <p>A request was canceled because the Aurora Serverless v2 DB instance was in a paused state.
+ *       The Data API request automatically causes the DB instance to begin resuming. Wait a few seconds and
+ *       try again.</p>
+ * @public
+ */
+export class DatabaseResumingException extends __BaseException {
+  readonly name: "DatabaseResumingException" = "DatabaseResumingException";
+  readonly $fault: "client" = "client";
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<DatabaseResumingException, __BaseException>) {
+    super({
+      name: "DatabaseResumingException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, DatabaseResumingException.prototype);
+  }
+}
+
 /**
  * <p>The writer instance in the DB cluster isn't available.</p>
  * @public

clients/client-rds-data/src/protocols/Aws_restJson1.ts

@@ -49,6 +49,7 @@ import {
   BadRequestException,
   DatabaseErrorException,
   DatabaseNotFoundException,
+  DatabaseResumingException,
   DatabaseUnavailableException,
   Field,
   ForbiddenException,
@@ -382,6 +383,9 @@ const de_CommandError = async (output: __HttpResponse, context: __SerdeContext):
     case "DatabaseNotFoundException":
     case "com.amazonaws.rdsdata#DatabaseNotFoundException":
       throw await de_DatabaseNotFoundExceptionRes(parsedOutput, context);
+    case "DatabaseResumingException":
+    case "com.amazonaws.rdsdata#DatabaseResumingException":
+      throw await de_DatabaseResumingExceptionRes(parsedOutput, context);
     case "DatabaseUnavailableException":
     case "com.amazonaws.rdsdata#DatabaseUnavailableException":
       throw await de_DatabaseUnavailableExceptionRes(parsedOutput, context);
@@ -503,6 +507,26 @@ const de_DatabaseNotFoundExceptionRes = async (
   return __decorateServiceException(exception, parsedOutput.body);
 };
 
+/**
+ * deserializeAws_restJson1DatabaseResumingExceptionRes
+ */
+const de_DatabaseResumingExceptionRes = async (
+  parsedOutput: any,
+  context: __SerdeContext
+): Promise<DatabaseResumingException> => {
+  const contents: any = map({});
+  const data: any = parsedOutput.body;
+  const doc = take(data, {
+    message: __expectString,
+  });
+  Object.assign(contents, doc);
+  const exception = new DatabaseResumingException({
+    $metadata: deserializeMetadata(parsedOutput),
+    ...contents,
+  });
+  return __decorateServiceException(exception, parsedOutput.body);
+};
+
 /**
  * deserializeAws_restJson1DatabaseUnavailableExceptionRes
  */

codegen/sdk-codegen/aws-models/rds-data.json

@@ -113,6 +113,9 @@
         {
           "target": "com.amazonaws.rdsdata#DatabaseNotFoundException"
         },
+        {
+          "target": "com.amazonaws.rdsdata#DatabaseResumingException"
+        },
         {
           "target": "com.amazonaws.rdsdata#DatabaseUnavailableException"
         },
@@ -238,6 +241,9 @@
         {
           "target": "com.amazonaws.rdsdata#DatabaseNotFoundException"
         },
+        {
+          "target": "com.amazonaws.rdsdata#DatabaseResumingException"
+        },
         {
           "target": "com.amazonaws.rdsdata#DatabaseUnavailableException"
         },
@@ -587,6 +593,19 @@
         "smithy.api#httpError": 404
       }
     },
+    "com.amazonaws.rdsdata#DatabaseResumingException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.rdsdata#ErrorMessage"
+        }
+      },
+      "traits": {
+        "smithy.api#documentation": "<p>A request was canceled because the Aurora Serverless v2 DB instance was in a paused state.\n      The Data API request automatically causes the DB instance to begin resuming. Wait a few seconds and\n      try again.</p>",
+        "smithy.api#error": "client",
+        "smithy.api#httpError": 400
+      }
+    },
     "com.amazonaws.rdsdata#DatabaseUnavailableException": {
       "type": "structure",
       "members": {},
@@ -745,6 +764,9 @@
         {
           "target": "com.amazonaws.rdsdata#DatabaseNotFoundException"
         },
+        {
+          "target": "com.amazonaws.rdsdata#DatabaseResumingException"
+        },
         {
           "target": "com.amazonaws.rdsdata#DatabaseUnavailableException"
         },