feat(client-cloudformation): AWS CloudFormation StackSets provides customers with three new APIs to activate, deactivate, and describe AWS Organizations trusted access which is needed to get started with service-managed StackSets.

Author: awstools

clients/client-cloudformation/README.md

@@ -8,20 +8,15 @@ AWS SDK for JavaScript CloudFormation Client for Node.js, Browser and React Nati
 
 <fullname>CloudFormation</fullname>
 
-<p>CloudFormation allows you to create and manage Amazon Web Services infrastructure
-deployments predictably and repeatedly. You can use CloudFormation to leverage
-Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store,
-Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly
-reliable, highly scalable, cost-effective applications without creating or configuring the
-underlying Amazon Web Services infrastructure.</p>
-<p>With CloudFormation, you declare all your resources and dependencies in a template
-file. The template defines a collection of resources as a single unit called a stack.
-CloudFormation creates and deletes all member resources of the stack together and
-manages all dependencies between the resources for you.</p>
+<p>CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments predictably
+and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build
+highly reliable, highly scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services infrastructure.</p>
+<p>With CloudFormation, you declare all your resources and dependencies in a template file. The template
+defines a collection of resources as a single unit called a stack. CloudFormation creates and deletes all member
+resources of the stack together and manages all dependencies between the resources for you.</p>
 <p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation product page</a>.</p>
-<p>CloudFormation makes use of other Amazon Web Services products. If you need
-additional technical information about a specific Amazon Web Services product, you can find
-the product's technical documentation at <a href="https://docs.aws.amazon.com/">
+<p>CloudFormation makes use of other Amazon Web Services products. If you need additional technical information
+about a specific Amazon Web Services product, you can find the product's technical documentation at <a href="https://docs.aws.amazon.com/">
 <code>docs.aws.amazon.com</code>
 </a>.</p>
 
@@ -40,16 +35,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 `CloudFormationClient` and
-the commands you need, for example `ActivateTypeCommand`:
+the commands you need, for example `ActivateOrganizationsAccessCommand`:
 
 ```js
 // ES5 example
-const { CloudFormationClient, ActivateTypeCommand } = require("@aws-sdk/client-cloudformation");
+const { CloudFormationClient, ActivateOrganizationsAccessCommand } = require("@aws-sdk/client-cloudformation");
 ```
 
 ```ts
 // ES6+ example
-import { CloudFormationClient, ActivateTypeCommand } from "@aws-sdk/client-cloudformation";
+import { CloudFormationClient, ActivateOrganizationsAccessCommand } from "@aws-sdk/client-cloudformation";
 ```
 
 ### Usage
@@ -68,7 +63,7 @@ const client = new CloudFormationClient({ region: "REGION" });
 const params = {
   /** input parameters */
 };
-const command = new ActivateTypeCommand(params);
+const command = new ActivateOrganizationsAccessCommand(params);
 ```
 
 #### Async/await
@@ -147,15 +142,15 @@ const client = new AWS.CloudFormation({ region: "REGION" });
 
 // async/await.
 try {
-  const data = await client.activateType(params);
+  const data = await client.activateOrganizationsAccess(params);
   // process data.
 } catch (error) {
   // error handling.
 }
 
 // Promises.
 client
-  .activateType(params)
+  .activateOrganizationsAccess(params)
   .then((data) => {
     // process data.
   })
@@ -164,7 +159,7 @@ client
   });
 
 // callbacks.
-client.activateType(params, (err, data) => {
+client.activateOrganizationsAccess(params, (err, data) => {
   // process err and data.
 });
 ```
@@ -220,6 +215,14 @@ see LICENSE for more information.
 
 ## Client Commands (Operations List)
 
+<details>
+<summary>
+ActivateOrganizationsAccess
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/classes/activateorganizationsaccesscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/activateorganizationsaccesscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/activateorganizationsaccesscommandoutput.html)
+
+</details>
 <details>
 <summary>
 ActivateType
@@ -283,6 +286,14 @@ CreateStackSet
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/classes/createstacksetcommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/createstacksetcommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/createstacksetcommandoutput.html)
 
+</details>
+<details>
+<summary>
+DeactivateOrganizationsAccess
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/classes/deactivateorganizationsaccesscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/deactivateorganizationsaccesscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/deactivateorganizationsaccesscommandoutput.html)
+
 </details>
 <details>
 <summary>
@@ -355,6 +366,14 @@ DescribeChangeSetHooks
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/classes/describechangesethookscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/describechangesethookscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/describechangesethookscommandoutput.html)
 
+</details>
+<details>
+<summary>
+DescribeOrganizationsAccess
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/classes/describeorganizationsaccesscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/describeorganizationsaccesscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-cloudformation/interfaces/describeorganizationsaccesscommandoutput.html)
+
 </details>
 <details>
 <summary>

clients/client-cloudformation/src/CloudFormation.ts

@@ -3,6 +3,11 @@ import { createAggregatedClient } from "@aws-sdk/smithy-client";
 import { HttpHandlerOptions as __HttpHandlerOptions } from "@aws-sdk/types";
 
 import { CloudFormationClient, CloudFormationClientConfig } from "./CloudFormationClient";
+import {
+  ActivateOrganizationsAccessCommand,
+  ActivateOrganizationsAccessCommandInput,
+  ActivateOrganizationsAccessCommandOutput,
+} from "./commands/ActivateOrganizationsAccessCommand";
 import {
   ActivateTypeCommand,
   ActivateTypeCommandInput,
@@ -39,6 +44,11 @@ import {
   CreateStackSetCommandInput,
   CreateStackSetCommandOutput,
 } from "./commands/CreateStackSetCommand";
+import {
+  DeactivateOrganizationsAccessCommand,
+  DeactivateOrganizationsAccessCommandInput,
+  DeactivateOrganizationsAccessCommandOutput,
+} from "./commands/DeactivateOrganizationsAccessCommand";
 import {
   DeactivateTypeCommand,
   DeactivateTypeCommandInput,
@@ -80,6 +90,11 @@ import {
   DescribeChangeSetHooksCommandInput,
   DescribeChangeSetHooksCommandOutput,
 } from "./commands/DescribeChangeSetHooksCommand";
+import {
+  DescribeOrganizationsAccessCommand,
+  DescribeOrganizationsAccessCommandInput,
+  DescribeOrganizationsAccessCommandOutput,
+} from "./commands/DescribeOrganizationsAccessCommand";
 import {
   DescribePublisherCommand,
   DescribePublisherCommandInput,
@@ -295,6 +310,7 @@ import {
 } from "./commands/ValidateTemplateCommand";
 
 const commands = {
+  ActivateOrganizationsAccessCommand,
   ActivateTypeCommand,
   BatchDescribeTypeConfigurationsCommand,
   CancelUpdateStackCommand,
@@ -303,6 +319,7 @@ const commands = {
   CreateStackCommand,
   CreateStackInstancesCommand,
   CreateStackSetCommand,
+  DeactivateOrganizationsAccessCommand,
   DeactivateTypeCommand,
   DeleteChangeSetCommand,
   DeleteStackCommand,
@@ -312,6 +329,7 @@ const commands = {
   DescribeAccountLimitsCommand,
   DescribeChangeSetCommand,
   DescribeChangeSetHooksCommand,
+  DescribeOrganizationsAccessCommand,
   DescribePublisherCommand,
   DescribeStackDriftDetectionStatusCommand,
   DescribeStackEventsCommand,
@@ -364,6 +382,23 @@ const commands = {
 };
 
 export interface CloudFormation {
+  /**
+   * @see {@link ActivateOrganizationsAccessCommand}
+   */
+  activateOrganizationsAccess(
+    args: ActivateOrganizationsAccessCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ActivateOrganizationsAccessCommandOutput>;
+  activateOrganizationsAccess(
+    args: ActivateOrganizationsAccessCommandInput,
+    cb: (err: any, data?: ActivateOrganizationsAccessCommandOutput) => void
+  ): void;
+  activateOrganizationsAccess(
+    args: ActivateOrganizationsAccessCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ActivateOrganizationsAccessCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ActivateTypeCommand}
    */
@@ -482,6 +517,23 @@ export interface CloudFormation {
     cb: (err: any, data?: CreateStackSetCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link DeactivateOrganizationsAccessCommand}
+   */
+  deactivateOrganizationsAccess(
+    args: DeactivateOrganizationsAccessCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DeactivateOrganizationsAccessCommandOutput>;
+  deactivateOrganizationsAccess(
+    args: DeactivateOrganizationsAccessCommandInput,
+    cb: (err: any, data?: DeactivateOrganizationsAccessCommandOutput) => void
+  ): void;
+  deactivateOrganizationsAccess(
+    args: DeactivateOrganizationsAccessCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DeactivateOrganizationsAccessCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link DeactivateTypeCommand}
    */
@@ -617,6 +669,23 @@ export interface CloudFormation {
     cb: (err: any, data?: DescribeChangeSetHooksCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link DescribeOrganizationsAccessCommand}
+   */
+  describeOrganizationsAccess(
+    args: DescribeOrganizationsAccessCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<DescribeOrganizationsAccessCommandOutput>;
+  describeOrganizationsAccess(
+    args: DescribeOrganizationsAccessCommandInput,
+    cb: (err: any, data?: DescribeOrganizationsAccessCommandOutput) => void
+  ): void;
+  describeOrganizationsAccess(
+    args: DescribeOrganizationsAccessCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: DescribeOrganizationsAccessCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link DescribePublisherCommand}
    */
@@ -1364,20 +1433,15 @@ export interface CloudFormation {
 /**
  * @public
  * <fullname>CloudFormation</fullname>
- *          <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure
- *          deployments predictably and repeatedly. You can use CloudFormation to leverage
- *             Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store,
- *             Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly
- *          reliable, highly scalable, cost-effective applications without creating or configuring the
- *          underlying Amazon Web Services infrastructure.</p>
- *          <p>With CloudFormation, you declare all your resources and dependencies in a template
- *          file. The template defines a collection of resources as a single unit called a stack.
- *             CloudFormation creates and deletes all member resources of the stack together and
- *          manages all dependencies between the resources for you.</p>
+ *          <p>CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments predictably
+ *    and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build
+ *    highly reliable, highly scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services infrastructure.</p>
+ *          <p>With CloudFormation, you declare all your resources and dependencies in a template file. The template
+ *    defines a collection of resources as a single unit called a stack. CloudFormation creates and deletes all member
+ *    resources of the stack together and manages all dependencies between the resources for you.</p>
  *          <p>For more information about CloudFormation, see the <a href="http://aws.amazon.com/cloudformation/">CloudFormation product page</a>.</p>
- *          <p>CloudFormation makes use of other Amazon Web Services products. If you need
- *          additional technical information about a specific Amazon Web Services product, you can find
- *          the product's technical documentation at <a href="https://docs.aws.amazon.com/">
+ *          <p>CloudFormation makes use of other Amazon Web Services products. If you need additional technical information
+ *    about a specific Amazon Web Services product, you can find the product's technical documentation at <a href="https://docs.aws.amazon.com/">
  *                <code>docs.aws.amazon.com</code>
  *             </a>.</p>
  */