feat(client-redshift-serverless): Add track support for Redshift Serverless workgroup.

Author: awstools

clients/client-redshift-serverless/README.md

@@ -31,16 +31,16 @@ using your favorite package manager:
 
 The AWS SDK is modulized by clients and commands.
 To send a request, you only need to import the `RedshiftServerlessClient` and
-the commands you need, for example `ListNamespacesCommand`:
+the commands you need, for example `ListTracksCommand`:
 
 ```js
 // ES5 example
-const { RedshiftServerlessClient, ListNamespacesCommand } = require("@aws-sdk/client-redshift-serverless");
+const { RedshiftServerlessClient, ListTracksCommand } = require("@aws-sdk/client-redshift-serverless");
 ```
 
 ```ts
 // ES6+ example
-import { RedshiftServerlessClient, ListNamespacesCommand } from "@aws-sdk/client-redshift-serverless";
+import { RedshiftServerlessClient, ListTracksCommand } from "@aws-sdk/client-redshift-serverless";
 ```
 
 ### Usage
@@ -59,7 +59,7 @@ const client = new RedshiftServerlessClient({ region: "REGION" });
 const params = {
   /** input parameters */
 };
-const command = new ListNamespacesCommand(params);
+const command = new ListTracksCommand(params);
 ```
 
 #### Async/await
@@ -138,15 +138,15 @@ const client = new AWS.RedshiftServerless({ region: "REGION" });
 
 // async/await.
 try {
-  const data = await client.listNamespaces(params);
+  const data = await client.listTracks(params);
   // process data.
 } catch (error) {
   // error handling.
 }
 
 // Promises.
 client
-  .listNamespaces(params)
+  .listTracks(params)
   .then((data) => {
     // process data.
   })
@@ -155,7 +155,7 @@ client
   });
 
 // callbacks.
-client.listNamespaces(params, (err, data) => {
+client.listTracks(params, (err, data) => {
   // process err and data.
 });
 ```
@@ -426,6 +426,14 @@ GetTableRestoreStatus
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/redshift-serverless/command/GetTableRestoreStatusCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/GetTableRestoreStatusCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/GetTableRestoreStatusCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetTrack
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/redshift-serverless/command/GetTrackCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/GetTrackCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/GetTrackCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -522,6 +530,14 @@ ListTagsForResource
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/redshift-serverless/command/ListTagsForResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/ListTagsForResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/ListTagsForResourceCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListTracks
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/redshift-serverless/command/ListTracksCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/ListTracksCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift-serverless/Interface/ListTracksCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-redshift-serverless/src/RedshiftServerless.ts

@@ -133,6 +133,7 @@ import {
   GetTableRestoreStatusCommandInput,
   GetTableRestoreStatusCommandOutput,
 } from "./commands/GetTableRestoreStatusCommand";
+import { GetTrackCommand, GetTrackCommandInput, GetTrackCommandOutput } from "./commands/GetTrackCommand";
 import {
   GetUsageLimitCommand,
   GetUsageLimitCommandInput,
@@ -193,6 +194,7 @@ import {
   ListTagsForResourceCommandInput,
   ListTagsForResourceCommandOutput,
 } from "./commands/ListTagsForResourceCommand";
+import { ListTracksCommand, ListTracksCommandInput, ListTracksCommandOutput } from "./commands/ListTracksCommand";
 import {
   ListUsageLimitsCommand,
   ListUsageLimitsCommandInput,
@@ -304,6 +306,7 @@ const commands = {
   GetScheduledActionCommand,
   GetSnapshotCommand,
   GetTableRestoreStatusCommand,
+  GetTrackCommand,
   GetUsageLimitCommand,
   GetWorkgroupCommand,
   ListCustomDomainAssociationsCommand,
@@ -316,6 +319,7 @@ const commands = {
   ListSnapshotsCommand,
   ListTableRestoreStatusCommand,
   ListTagsForResourceCommand,
+  ListTracksCommand,
   ListUsageLimitsCommand,
   ListWorkgroupsCommand,
   PutResourcePolicyCommand,
@@ -764,6 +768,17 @@ export interface RedshiftServerless {
     cb: (err: any, data?: GetTableRestoreStatusCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link GetTrackCommand}
+   */
+  getTrack(args: GetTrackCommandInput, options?: __HttpHandlerOptions): Promise<GetTrackCommandOutput>;
+  getTrack(args: GetTrackCommandInput, cb: (err: any, data?: GetTrackCommandOutput) => void): void;
+  getTrack(
+    args: GetTrackCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetTrackCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link GetUsageLimitCommand}
    */
@@ -956,6 +971,18 @@ export interface RedshiftServerless {
     cb: (err: any, data?: ListTagsForResourceCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListTracksCommand}
+   */
+  listTracks(): Promise<ListTracksCommandOutput>;
+  listTracks(args: ListTracksCommandInput, options?: __HttpHandlerOptions): Promise<ListTracksCommandOutput>;
+  listTracks(args: ListTracksCommandInput, cb: (err: any, data?: ListTracksCommandOutput) => void): void;
+  listTracks(
+    args: ListTracksCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListTracksCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListUsageLimitsCommand}
    */

clients/client-redshift-serverless/src/RedshiftServerlessClient.ts

@@ -116,6 +116,7 @@ import {
   GetTableRestoreStatusCommandInput,
   GetTableRestoreStatusCommandOutput,
 } from "./commands/GetTableRestoreStatusCommand";
+import { GetTrackCommandInput, GetTrackCommandOutput } from "./commands/GetTrackCommand";
 import { GetUsageLimitCommandInput, GetUsageLimitCommandOutput } from "./commands/GetUsageLimitCommand";
 import { GetWorkgroupCommandInput, GetWorkgroupCommandOutput } from "./commands/GetWorkgroupCommand";
 import {
@@ -146,6 +147,7 @@ import {
   ListTagsForResourceCommandInput,
   ListTagsForResourceCommandOutput,
 } from "./commands/ListTagsForResourceCommand";
+import { ListTracksCommandInput, ListTracksCommandOutput } from "./commands/ListTracksCommand";
 import { ListUsageLimitsCommandInput, ListUsageLimitsCommandOutput } from "./commands/ListUsageLimitsCommand";
 import { ListWorkgroupsCommandInput, ListWorkgroupsCommandOutput } from "./commands/ListWorkgroupsCommand";
 import { PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput } from "./commands/PutResourcePolicyCommand";
@@ -229,6 +231,7 @@ export type ServiceInputTypes =
   | GetScheduledActionCommandInput
   | GetSnapshotCommandInput
   | GetTableRestoreStatusCommandInput
+  | GetTrackCommandInput
   | GetUsageLimitCommandInput
   | GetWorkgroupCommandInput
   | ListCustomDomainAssociationsCommandInput
@@ -241,6 +244,7 @@ export type ServiceInputTypes =
   | ListSnapshotsCommandInput
   | ListTableRestoreStatusCommandInput
   | ListTagsForResourceCommandInput
+  | ListTracksCommandInput
   | ListUsageLimitsCommandInput
   | ListWorkgroupsCommandInput
   | PutResourcePolicyCommandInput
@@ -290,6 +294,7 @@ export type ServiceOutputTypes =
   | GetScheduledActionCommandOutput
   | GetSnapshotCommandOutput
   | GetTableRestoreStatusCommandOutput
+  | GetTrackCommandOutput
   | GetUsageLimitCommandOutput
   | GetWorkgroupCommandOutput
   | ListCustomDomainAssociationsCommandOutput
@@ -302,6 +307,7 @@ export type ServiceOutputTypes =
   | ListSnapshotsCommandOutput
   | ListTableRestoreStatusCommandOutput
   | ListTagsForResourceCommandOutput
+  | ListTracksCommandOutput
   | ListUsageLimitsCommandOutput
   | ListWorkgroupsCommandOutput
   | PutResourcePolicyCommandOutput

clients/client-redshift-serverless/src/commands/CreateWorkgroupCommand.ts

@@ -87,6 +87,7 @@ export interface CreateWorkgroupCommandOutput extends CreateWorkgroupResponse, _
  *     level: Number("int"),
  *   },
  *   ipAddressType: "STRING_VALUE",
+ *   trackName: "STRING_VALUE",
  * };
  * const command = new CreateWorkgroupCommand(input);
  * const response = await client.send(command);
@@ -147,6 +148,8 @@ export interface CreateWorkgroupCommandOutput extends CreateWorkgroupResponse, _
  * //       status: "STRING_VALUE",
  * //       level: Number("int"),
  * //     },
+ * //     trackName: "STRING_VALUE",
+ * //     pendingTrackName: "STRING_VALUE",
  * //   },
  * // };
  *

clients/client-redshift-serverless/src/commands/DeleteWorkgroupCommand.ts

@@ -101,6 +101,8 @@ export interface DeleteWorkgroupCommandOutput extends DeleteWorkgroupResponse, _
  * //       status: "STRING_VALUE",
  * //       level: Number("int"),
  * //     },
+ * //     trackName: "STRING_VALUE",
+ * //     pendingTrackName: "STRING_VALUE",
  * //   },
  * // };
  *

clients/client-redshift-serverless/src/commands/GetTrackCommand.ts

@@ -0,0 +1,123 @@
+// smithy-typescript generated code
+import { getEndpointPlugin } from "@smithy/middleware-endpoint";
+import { getSerdePlugin } from "@smithy/middleware-serde";
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+
+import { commonParams } from "../endpoint/EndpointParameters";
+import { GetTrackRequest, GetTrackResponse } from "../models/models_0";
+import { de_GetTrackCommand, se_GetTrackCommand } from "../protocols/Aws_json1_1";
+import {
+  RedshiftServerlessClientResolvedConfig,
+  ServiceInputTypes,
+  ServiceOutputTypes,
+} from "../RedshiftServerlessClient";
+
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetTrackCommand}.
+ */
+export interface GetTrackCommandInput extends GetTrackRequest {}
+/**
+ * @public
+ *
+ * The output of {@link GetTrackCommand}.
+ */
+export interface GetTrackCommandOutput extends GetTrackResponse, __MetadataBearer {}
+
+/**
+ * <p>Get the Redshift Serverless version for a specified track.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { RedshiftServerlessClient, GetTrackCommand } from "@aws-sdk/client-redshift-serverless"; // ES Modules import
+ * // const { RedshiftServerlessClient, GetTrackCommand } = require("@aws-sdk/client-redshift-serverless"); // CommonJS import
+ * const client = new RedshiftServerlessClient(config);
+ * const input = { // GetTrackRequest
+ *   trackName: "STRING_VALUE", // required
+ * };
+ * const command = new GetTrackCommand(input);
+ * const response = await client.send(command);
+ * // { // GetTrackResponse
+ * //   track: { // ServerlessTrack
+ * //     trackName: "STRING_VALUE",
+ * //     workgroupVersion: "STRING_VALUE",
+ * //     updateTargets: [ // UpdateTargetsList
+ * //       { // UpdateTarget
+ * //         trackName: "STRING_VALUE",
+ * //         workgroupVersion: "STRING_VALUE",
+ * //       },
+ * //     ],
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param GetTrackCommandInput - {@link GetTrackCommandInput}
+ * @returns {@link GetTrackCommandOutput}
+ * @see {@link GetTrackCommandInput} for command's `input` shape.
+ * @see {@link GetTrackCommandOutput} for command's `response` shape.
+ * @see {@link RedshiftServerlessClientResolvedConfig | config} for RedshiftServerlessClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have sufficient access to perform this action.</p>
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>The submitted action has conflicts.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>The request processing has failed because of an unknown error, exception or failure.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The resource could not be found.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was denied due to request throttling.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The input failed to satisfy the constraints specified by an AWS service.</p>
+ *
+ * @throws {@link RedshiftServerlessServiceException}
+ * <p>Base exception class for all service exceptions from RedshiftServerless service.</p>
+ *
+ * @public
+ */
+export class GetTrackCommand extends $Command
+  .classBuilder<
+    GetTrackCommandInput,
+    GetTrackCommandOutput,
+    RedshiftServerlessClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >()
+  .ep(commonParams)
+  .m(function (this: any, Command: any, cs: any, config: RedshiftServerlessClientResolvedConfig, o: any) {
+    return [
+      getSerdePlugin(config, this.serialize, this.deserialize),
+      getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+    ];
+  })
+  .s("RedshiftServerless", "GetTrack", {})
+  .n("RedshiftServerlessClient", "GetTrackCommand")
+  .f(void 0, void 0)
+  .ser(se_GetTrackCommand)
+  .de(de_GetTrackCommand)
+  .build() {
+  /** @internal type navigation helper, not in runtime. */
+  protected declare static __types: {
+    api: {
+      input: GetTrackRequest;
+      output: GetTrackResponse;
+    };
+    sdk: {
+      input: GetTrackCommandInput;
+      output: GetTrackCommandOutput;
+    };
+  };
+}

clients/client-redshift-serverless/src/commands/GetWorkgroupCommand.ts

@@ -101,6 +101,8 @@ export interface GetWorkgroupCommandOutput extends GetWorkgroupResponse, __Metad
  * //       status: "STRING_VALUE",
  * //       level: Number("int"),
  * //     },
+ * //     trackName: "STRING_VALUE",
+ * //     pendingTrackName: "STRING_VALUE",
  * //   },
  * // };
  *