feat(client-workspaces): The release introduces CreateStandbyWorkspaces, an API that allows you to create standby WorkSpaces associated with a primary WorkSpace in another Region. DescribeWorkspaces now includes related WorkSpaces properties. DescribeWorkspaceBundles and CreateWorkspaceBundle now return more bundle details.

Author: awstools

clients/client-workspaces/src/WorkSpaces.ts

@@ -36,6 +36,11 @@ import {
   CreateIpGroupCommandInput,
   CreateIpGroupCommandOutput,
 } from "./commands/CreateIpGroupCommand";
+import {
+  CreateStandbyWorkspacesCommand,
+  CreateStandbyWorkspacesCommandInput,
+  CreateStandbyWorkspacesCommandOutput,
+} from "./commands/CreateStandbyWorkspacesCommand";
 import { CreateTagsCommand, CreateTagsCommandInput, CreateTagsCommandOutput } from "./commands/CreateTagsCommand";
 import {
   CreateUpdatedWorkspaceImageCommand,
@@ -589,6 +594,38 @@ export class WorkSpaces extends WorkSpacesClient {
     }
   }
 
+  /**
+   * <p>Creates a Standby WorkSpace in a secondary region.</p>
+   */
+  public createStandbyWorkspaces(
+    args: CreateStandbyWorkspacesCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<CreateStandbyWorkspacesCommandOutput>;
+  public createStandbyWorkspaces(
+    args: CreateStandbyWorkspacesCommandInput,
+    cb: (err: any, data?: CreateStandbyWorkspacesCommandOutput) => void
+  ): void;
+  public createStandbyWorkspaces(
+    args: CreateStandbyWorkspacesCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: CreateStandbyWorkspacesCommandOutput) => void
+  ): void;
+  public createStandbyWorkspaces(
+    args: CreateStandbyWorkspacesCommandInput,
+    optionsOrCb?: __HttpHandlerOptions | ((err: any, data?: CreateStandbyWorkspacesCommandOutput) => void),
+    cb?: (err: any, data?: CreateStandbyWorkspacesCommandOutput) => void
+  ): Promise<CreateStandbyWorkspacesCommandOutput> | void {
+    const command = new CreateStandbyWorkspacesCommand(args);
+    if (typeof optionsOrCb === "function") {
+      this.send(command, optionsOrCb);
+    } else if (typeof cb === "function") {
+      if (typeof optionsOrCb !== "object") throw new Error(`Expect http options but get ${typeof optionsOrCb}`);
+      this.send(command, optionsOrCb || {}, cb);
+    } else {
+      return this.send(command, optionsOrCb);
+    }
+  }
+
   /**
    * <p>Creates the specified tags for the specified WorkSpaces resource.</p>
    */

clients/client-workspaces/src/WorkSpacesClient.ts

@@ -63,6 +63,10 @@ import {
   CreateConnectionAliasCommandOutput,
 } from "./commands/CreateConnectionAliasCommand";
 import { CreateIpGroupCommandInput, CreateIpGroupCommandOutput } from "./commands/CreateIpGroupCommand";
+import {
+  CreateStandbyWorkspacesCommandInput,
+  CreateStandbyWorkspacesCommandOutput,
+} from "./commands/CreateStandbyWorkspacesCommand";
 import { CreateTagsCommandInput, CreateTagsCommandOutput } from "./commands/CreateTagsCommand";
 import {
   CreateUpdatedWorkspaceImageCommandInput,
@@ -259,6 +263,7 @@ export type ServiceInputTypes =
   | CreateConnectClientAddInCommandInput
   | CreateConnectionAliasCommandInput
   | CreateIpGroupCommandInput
+  | CreateStandbyWorkspacesCommandInput
   | CreateTagsCommandInput
   | CreateUpdatedWorkspaceImageCommandInput
   | CreateWorkspaceBundleCommandInput
@@ -325,6 +330,7 @@ export type ServiceOutputTypes =
   | CreateConnectClientAddInCommandOutput
   | CreateConnectionAliasCommandOutput
   | CreateIpGroupCommandOutput
+  | CreateStandbyWorkspacesCommandOutput
   | CreateTagsCommandOutput
   | CreateUpdatedWorkspaceImageCommandOutput
   | CreateWorkspaceBundleCommandOutput

clients/client-workspaces/src/commands/CreateStandbyWorkspacesCommand.ts

@@ -0,0 +1,114 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import {
+  CreateStandbyWorkspacesRequest,
+  CreateStandbyWorkspacesRequestFilterSensitiveLog,
+  CreateStandbyWorkspacesResult,
+  CreateStandbyWorkspacesResultFilterSensitiveLog,
+} from "../models/models_0";
+import {
+  deserializeAws_json1_1CreateStandbyWorkspacesCommand,
+  serializeAws_json1_1CreateStandbyWorkspacesCommand,
+} from "../protocols/Aws_json1_1";
+import { ServiceInputTypes, ServiceOutputTypes, WorkSpacesClientResolvedConfig } from "../WorkSpacesClient";
+
+export interface CreateStandbyWorkspacesCommandInput extends CreateStandbyWorkspacesRequest {}
+export interface CreateStandbyWorkspacesCommandOutput extends CreateStandbyWorkspacesResult, __MetadataBearer {}
+
+/**
+ * <p>Creates a Standby WorkSpace in a secondary region.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { WorkSpacesClient, CreateStandbyWorkspacesCommand } from "@aws-sdk/client-workspaces"; // ES Modules import
+ * // const { WorkSpacesClient, CreateStandbyWorkspacesCommand } = require("@aws-sdk/client-workspaces"); // CommonJS import
+ * const client = new WorkSpacesClient(config);
+ * const command = new CreateStandbyWorkspacesCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link CreateStandbyWorkspacesCommandInput} for command's `input` shape.
+ * @see {@link CreateStandbyWorkspacesCommandOutput} for command's `response` shape.
+ * @see {@link WorkSpacesClientResolvedConfig | config} for WorkSpacesClient's `config` shape.
+ *
+ */
+export class CreateStandbyWorkspacesCommand extends $Command<
+  CreateStandbyWorkspacesCommandInput,
+  CreateStandbyWorkspacesCommandOutput,
+  WorkSpacesClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  constructor(readonly input: CreateStandbyWorkspacesCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: WorkSpacesClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<CreateStandbyWorkspacesCommandInput, CreateStandbyWorkspacesCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreateStandbyWorkspacesCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "WorkSpacesClient";
+    const commandName = "CreateStandbyWorkspacesCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: CreateStandbyWorkspacesRequestFilterSensitiveLog,
+      outputFilterSensitiveLog: CreateStandbyWorkspacesResultFilterSensitiveLog,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  private serialize(input: CreateStandbyWorkspacesCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return serializeAws_json1_1CreateStandbyWorkspacesCommand(input, context);
+  }
+
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<CreateStandbyWorkspacesCommandOutput> {
+    return deserializeAws_json1_1CreateStandbyWorkspacesCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}

clients/client-workspaces/src/commands/index.ts

@@ -6,6 +6,7 @@ export * from "./CopyWorkspaceImageCommand";
 export * from "./CreateConnectClientAddInCommand";
 export * from "./CreateConnectionAliasCommand";
 export * from "./CreateIpGroupCommand";
+export * from "./CreateStandbyWorkspacesCommand";
 export * from "./CreateTagsCommand";
 export * from "./CreateUpdatedWorkspaceImageCommand";
 export * from "./CreateWorkspaceBundleCommand";