feat(client-support-app): This release adds the RegisterSlackWorkspaceForOrganization API. You can use the API to register a Slack workspace for an AWS account that is part of an organization.

Author: awstools

clients/client-support-app/README.md

@@ -53,7 +53,6 @@ documentation in the <i>Amazon Web Services Support User Guide</i>:</p>
 <p>You can also use the Amazon Web Services Management Console instead of the Amazon Web Services Support App API to manage your Slack
 configurations. For more information, see <a href="https://docs.aws.amazon.com/awssupport/latest/user/authorize-slack-workspace.html">Authorize a
 Slack workspace to enable the Amazon Web Services Support App</a>.</p>
-
 <note>
 <ul>
 <li>

clients/client-support-app/package.json

@@ -26,6 +26,7 @@
     "@aws-sdk/hash-node": "*",
     "@aws-sdk/invalid-dependency": "*",
     "@aws-sdk/middleware-content-length": "*",
+    "@aws-sdk/middleware-endpoint": "*",
     "@aws-sdk/middleware-host-header": "*",
     "@aws-sdk/middleware-logger": "*",
     "@aws-sdk/middleware-recursion-detection": "*",

clients/client-support-app/src/SupportApp.ts

@@ -41,6 +41,11 @@ import {
   PutAccountAliasCommandInput,
   PutAccountAliasCommandOutput,
 } from "./commands/PutAccountAliasCommand";
+import {
+  RegisterSlackWorkspaceForOrganizationCommand,
+  RegisterSlackWorkspaceForOrganizationCommandInput,
+  RegisterSlackWorkspaceForOrganizationCommandOutput,
+} from "./commands/RegisterSlackWorkspaceForOrganizationCommand";
 import {
   UpdateSlackChannelConfigurationCommand,
   UpdateSlackChannelConfigurationCommandInput,
@@ -92,7 +97,6 @@ import { SupportAppClient } from "./SupportAppClient";
  *          <p>You can also use the Amazon Web Services Management Console instead of the Amazon Web Services Support App API to manage your Slack
  *       configurations. For more information, see <a href="https://docs.aws.amazon.com/awssupport/latest/user/authorize-slack-workspace.html">Authorize a
  *         Slack workspace to enable the Amazon Web Services Support App</a>.</p>
- *
  *          <note>
  *             <ul>
  *                <li>
@@ -388,6 +392,69 @@ export class SupportApp extends SupportAppClient {
     }
   }
 
+  /**
+   * <p>Registers a Slack workspace for your Amazon Web Services account. To call this API, your account must be
+   *       part of an organization in Organizations.</p>
+   *          <p>If you're the <i>management account</i> and you want to register Slack
+   *       workspaces for your organization, you must complete the following tasks:</p>
+   *          <ol>
+   *             <li>
+   *                <p>Sign in to the <a href="https://console.aws.amazon.com/support/app">Amazon Web Services Support Center</a> and
+   *           authorize the Slack workspaces where you want your organization to have access to. See
+   *             <a href="https://docs.aws.amazon.com/awssupport/latest/user/authorize-slack-workspace.html">Authorize a Slack workspace</a> in the <i>Amazon Web Services Support User
+   *           Guide</i>.</p>
+   *             </li>
+   *             <li>
+   *                <p>Call the <code>RegisterSlackWorkspaceForOrganization</code> API to authorize each
+   *           Slack workspace for the organization.</p>
+   *             </li>
+   *          </ol>
+   *          <p>After the management account authorizes the Slack workspace, member accounts can call this
+   *       API to authorize the same Slack workspace for their individual accounts. Member accounts don't
+   *       need to authorize the Slack workspace manually through the <a href="https://console.aws.amazon.com/support/app">Amazon Web Services Support Center</a>.</p>
+   *          <p>To use the Amazon Web Services Support App, each account must then complete the following tasks:</p>
+   *          <ul>
+   *             <li>
+   *                <p>Create an Identity and Access Management (IAM) role with the required permission. For more information,
+   *           see <a href="https://docs.aws.amazon.com/awssupport/latest/user/support-app-permissions.html">Managing access to the Amazon Web Services Support App</a>.</p>
+   *             </li>
+   *             <li>
+   *                <p>Configure a Slack channel to use the Amazon Web Services Support App for support cases for that account. For
+   *           more information, see <a href="https://docs.aws.amazon.com/awssupport/latest/user/add-your-slack-channel.html">Configuring a Slack channel</a>.</p>
+   *             </li>
+   *          </ul>
+   */
+  public registerSlackWorkspaceForOrganization(
+    args: RegisterSlackWorkspaceForOrganizationCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<RegisterSlackWorkspaceForOrganizationCommandOutput>;
+  public registerSlackWorkspaceForOrganization(
+    args: RegisterSlackWorkspaceForOrganizationCommandInput,
+    cb: (err: any, data?: RegisterSlackWorkspaceForOrganizationCommandOutput) => void
+  ): void;
+  public registerSlackWorkspaceForOrganization(
+    args: RegisterSlackWorkspaceForOrganizationCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: RegisterSlackWorkspaceForOrganizationCommandOutput) => void
+  ): void;
+  public registerSlackWorkspaceForOrganization(
+    args: RegisterSlackWorkspaceForOrganizationCommandInput,
+    optionsOrCb?:
+      | __HttpHandlerOptions
+      | ((err: any, data?: RegisterSlackWorkspaceForOrganizationCommandOutput) => void),
+    cb?: (err: any, data?: RegisterSlackWorkspaceForOrganizationCommandOutput) => void
+  ): Promise<RegisterSlackWorkspaceForOrganizationCommandOutput> | void {
+    const command = new RegisterSlackWorkspaceForOrganizationCommand(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>Updates the configuration for a Slack channel, such as case update notifications.</p>
    */

clients/client-support-app/src/SupportAppClient.ts

@@ -1,13 +1,7 @@
 // smithy-typescript generated code
-import {
-  EndpointsInputConfig,
-  EndpointsResolvedConfig,
-  RegionInputConfig,
-  RegionResolvedConfig,
-  resolveEndpointsConfig,
-  resolveRegionConfig,
-} from "@aws-sdk/config-resolver";
+import { RegionInputConfig, RegionResolvedConfig, resolveRegionConfig } from "@aws-sdk/config-resolver";
 import { getContentLengthPlugin } from "@aws-sdk/middleware-content-length";
+import { EndpointInputConfig, EndpointResolvedConfig, resolveEndpointConfig } from "@aws-sdk/middleware-endpoint";
 import {
   getHostHeaderPlugin,
   HostHeaderInputConfig,
@@ -41,13 +35,13 @@ import {
   Credentials as __Credentials,
   Decoder as __Decoder,
   Encoder as __Encoder,
+  EndpointV2 as __EndpointV2,
   Hash as __Hash,
   HashConstructor as __HashConstructor,
   HttpHandlerOptions as __HttpHandlerOptions,
   Logger as __Logger,
   Provider as __Provider,
   Provider,
-  RegionInfoProvider,
   StreamCollector as __StreamCollector,
   UrlParser as __UrlParser,
   UserAgent as __UserAgent,
@@ -76,10 +70,20 @@ import {
   ListSlackWorkspaceConfigurationsCommandOutput,
 } from "./commands/ListSlackWorkspaceConfigurationsCommand";
 import { PutAccountAliasCommandInput, PutAccountAliasCommandOutput } from "./commands/PutAccountAliasCommand";
+import {
+  RegisterSlackWorkspaceForOrganizationCommandInput,
+  RegisterSlackWorkspaceForOrganizationCommandOutput,
+} from "./commands/RegisterSlackWorkspaceForOrganizationCommand";
 import {
   UpdateSlackChannelConfigurationCommandInput,
   UpdateSlackChannelConfigurationCommandOutput,
 } from "./commands/UpdateSlackChannelConfigurationCommand";
+import {
+  ClientInputEndpointParameters,
+  ClientResolvedEndpointParameters,
+  EndpointParameters,
+  resolveClientEndpointParameters,
+} from "./endpoint/EndpointParameters";
 import { getRuntimeConfig as __getRuntimeConfig } from "./runtimeConfig";
 
 export type ServiceInputTypes =
@@ -91,6 +95,7 @@ export type ServiceInputTypes =
   | ListSlackChannelConfigurationsCommandInput
   | ListSlackWorkspaceConfigurationsCommandInput
   | PutAccountAliasCommandInput
+  | RegisterSlackWorkspaceForOrganizationCommandInput
   | UpdateSlackChannelConfigurationCommandInput;
 
 export type ServiceOutputTypes =
@@ -102,6 +107,7 @@ export type ServiceOutputTypes =
   | ListSlackChannelConfigurationsCommandOutput
   | ListSlackWorkspaceConfigurationsCommandOutput
   | PutAccountAliasCommandOutput
+  | RegisterSlackWorkspaceForOrganizationCommandOutput
   | UpdateSlackChannelConfigurationCommandOutput;
 
 export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
@@ -213,12 +219,6 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
    */
   credentialDefaultProvider?: (input: any) => __Provider<__Credentials>;
 
-  /**
-   * Fetch related hostname, signing name or signing region with given region.
-   * @internal
-   */
-  regionInfoProvider?: RegionInfoProvider;
-
   /**
    * The provider populating default tracking information to be sent with `user-agent`, `x-amz-user-agent` header
    * @internal
@@ -234,11 +234,12 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
 type SupportAppClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
   ClientDefaults &
   RegionInputConfig &
-  EndpointsInputConfig &
+  EndpointInputConfig<EndpointParameters> &
   RetryInputConfig &
   HostHeaderInputConfig &
   AwsAuthInputConfig &
-  UserAgentInputConfig;
+  UserAgentInputConfig &
+  ClientInputEndpointParameters;
 /**
  * The configuration interface of SupportAppClient class constructor that set the region, credentials and other options.
  */
@@ -247,11 +248,12 @@ export interface SupportAppClientConfig extends SupportAppClientConfigType {}
 type SupportAppClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
   Required<ClientDefaults> &
   RegionResolvedConfig &
-  EndpointsResolvedConfig &
+  EndpointResolvedConfig<EndpointParameters> &
   RetryResolvedConfig &
   HostHeaderResolvedConfig &
   AwsAuthResolvedConfig &
-  UserAgentResolvedConfig;
+  UserAgentResolvedConfig &
+  ClientResolvedEndpointParameters;
 /**
  * The resolved configuration interface of SupportAppClient class. This is resolved and normalized from the {@link SupportAppClientConfig | constructor configuration interface}.
  */
@@ -301,7 +303,6 @@ export interface SupportAppClientResolvedConfig extends SupportAppClientResolved
  *          <p>You can also use the Amazon Web Services Management Console instead of the Amazon Web Services Support App API to manage your Slack
  *       configurations. For more information, see <a href="https://docs.aws.amazon.com/awssupport/latest/user/authorize-slack-workspace.html">Authorize a
  *         Slack workspace to enable the Amazon Web Services Support App</a>.</p>
- *
  *          <note>
  *             <ul>
  *                <li>
@@ -327,14 +328,15 @@ export class SupportAppClient extends __Client<
 
   constructor(configuration: SupportAppClientConfig) {
     const _config_0 = __getRuntimeConfig(configuration);
-    const _config_1 = resolveRegionConfig(_config_0);
-    const _config_2 = resolveEndpointsConfig(_config_1);
-    const _config_3 = resolveRetryConfig(_config_2);
-    const _config_4 = resolveHostHeaderConfig(_config_3);
-    const _config_5 = resolveAwsAuthConfig(_config_4);
-    const _config_6 = resolveUserAgentConfig(_config_5);
-    super(_config_6);
-    this.config = _config_6;
+    const _config_1 = resolveClientEndpointParameters(_config_0);
+    const _config_2 = resolveRegionConfig(_config_1);
+    const _config_3 = resolveEndpointConfig(_config_2);
+    const _config_4 = resolveRetryConfig(_config_3);
+    const _config_5 = resolveHostHeaderConfig(_config_4);
+    const _config_6 = resolveAwsAuthConfig(_config_5);
+    const _config_7 = resolveUserAgentConfig(_config_6);
+    super(_config_7);
+    this.config = _config_7;
     this.middlewareStack.use(getRetryPlugin(this.config));
     this.middlewareStack.use(getContentLengthPlugin(this.config));
     this.middlewareStack.use(getHostHeaderPlugin(this.config));

clients/client-support-app/src/commands/CreateSlackChannelConfigurationCommand.ts

@@ -1,4 +1,5 @@
 // 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";
@@ -74,6 +75,15 @@ export class CreateSlackChannelConfigurationCommand extends $Command<
   // 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: CreateSlackChannelConfigurationCommandInput) {
     // Start section: command_constructor
     super();
@@ -89,6 +99,9 @@ export class CreateSlackChannelConfigurationCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<CreateSlackChannelConfigurationCommandInput, CreateSlackChannelConfigurationCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, CreateSlackChannelConfigurationCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);
 

clients/client-support-app/src/commands/DeleteAccountAliasCommand.ts

@@ -1,4 +1,5 @@
 // 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";
@@ -53,6 +54,15 @@ export class DeleteAccountAliasCommand extends $Command<
   // 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: DeleteAccountAliasCommandInput) {
     // Start section: command_constructor
     super();
@@ -68,6 +78,9 @@ export class DeleteAccountAliasCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<DeleteAccountAliasCommandInput, DeleteAccountAliasCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, DeleteAccountAliasCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);
 

clients/client-support-app/src/commands/DeleteSlackChannelConfigurationCommand.ts

@@ -1,4 +1,5 @@
 // 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";
@@ -55,6 +56,15 @@ export class DeleteSlackChannelConfigurationCommand extends $Command<
   // 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: DeleteSlackChannelConfigurationCommandInput) {
     // Start section: command_constructor
     super();
@@ -70,6 +80,9 @@ export class DeleteSlackChannelConfigurationCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<DeleteSlackChannelConfigurationCommandInput, DeleteSlackChannelConfigurationCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, DeleteSlackChannelConfigurationCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);
 

clients/client-support-app/src/commands/DeleteSlackWorkspaceConfigurationCommand.ts

@@ -1,4 +1,5 @@
 // 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";
@@ -55,6 +56,15 @@ export class DeleteSlackWorkspaceConfigurationCommand extends $Command<
   // 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: DeleteSlackWorkspaceConfigurationCommandInput) {
     // Start section: command_constructor
     super();
@@ -70,6 +80,9 @@ export class DeleteSlackWorkspaceConfigurationCommand extends $Command<
     options?: __HttpHandlerOptions
   ): Handler<DeleteSlackWorkspaceConfigurationCommandInput, DeleteSlackWorkspaceConfigurationCommandOutput> {
     this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, DeleteSlackWorkspaceConfigurationCommand.getEndpointParameterInstructions())
+    );
 
     const stack = clientStack.concat(this.middlewareStack);