Skip to content

Commit 29679ab

Browse files
author
awstools
committed
feat(client-cloudformation): This release supports for a new API ListStackSetAutoDeploymentTargets, which provider auto-deployment configuration as a describable resource. Customers can now view the specific combinations of regions and OUs that are being auto-deployed.
1 parent 8a73474 commit 29679ab

15 files changed

+583
-128
lines changed

clients/client-cloudformation/README.md

+8
Original file line numberDiff line numberDiff line change
@@ -670,6 +670,14 @@ ListStacks
670670

671671
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ListStacksCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudformation/Interface/ListStacksCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudformation/Interface/ListStacksCommandOutput/)
672672

673+
</details>
674+
<details>
675+
<summary>
676+
ListStackSetAutoDeploymentTargets
677+
</summary>
678+
679+
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudformation/command/ListStackSetAutoDeploymentTargetsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudformation/Interface/ListStackSetAutoDeploymentTargetsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-cloudformation/Interface/ListStackSetAutoDeploymentTargetsCommandOutput/)
680+
673681
</details>
674682
<details>
675683
<summary>

clients/client-cloudformation/src/CloudFormation.ts

+23
Original file line numberDiff line numberDiff line change
@@ -264,6 +264,11 @@ import {
264264
ListStackResourcesCommandOutput,
265265
} from "./commands/ListStackResourcesCommand";
266266
import { ListStacksCommand, ListStacksCommandInput, ListStacksCommandOutput } from "./commands/ListStacksCommand";
267+
import {
268+
ListStackSetAutoDeploymentTargetsCommand,
269+
ListStackSetAutoDeploymentTargetsCommandInput,
270+
ListStackSetAutoDeploymentTargetsCommandOutput,
271+
} from "./commands/ListStackSetAutoDeploymentTargetsCommand";
267272
import {
268273
ListStackSetOperationResultsCommand,
269274
ListStackSetOperationResultsCommandInput,
@@ -427,6 +432,7 @@ const commands = {
427432
ListStackInstancesCommand,
428433
ListStackResourcesCommand,
429434
ListStacksCommand,
435+
ListStackSetAutoDeploymentTargetsCommand,
430436
ListStackSetOperationResultsCommand,
431437
ListStackSetOperationsCommand,
432438
ListStackSetsCommand,
@@ -1367,6 +1373,23 @@ export interface CloudFormation {
13671373
cb: (err: any, data?: ListStacksCommandOutput) => void
13681374
): void;
13691375

1376+
/**
1377+
* @see {@link ListStackSetAutoDeploymentTargetsCommand}
1378+
*/
1379+
listStackSetAutoDeploymentTargets(
1380+
args: ListStackSetAutoDeploymentTargetsCommandInput,
1381+
options?: __HttpHandlerOptions
1382+
): Promise<ListStackSetAutoDeploymentTargetsCommandOutput>;
1383+
listStackSetAutoDeploymentTargets(
1384+
args: ListStackSetAutoDeploymentTargetsCommandInput,
1385+
cb: (err: any, data?: ListStackSetAutoDeploymentTargetsCommandOutput) => void
1386+
): void;
1387+
listStackSetAutoDeploymentTargets(
1388+
args: ListStackSetAutoDeploymentTargetsCommandInput,
1389+
options: __HttpHandlerOptions,
1390+
cb: (err: any, data?: ListStackSetAutoDeploymentTargetsCommandOutput) => void
1391+
): void;
1392+
13701393
/**
13711394
* @see {@link ListStackSetOperationResultsCommand}
13721395
*/

clients/client-cloudformation/src/CloudFormationClient.ts

+6
Original file line numberDiff line numberDiff line change
@@ -200,6 +200,10 @@ import {
200200
import { ListStackInstancesCommandInput, ListStackInstancesCommandOutput } from "./commands/ListStackInstancesCommand";
201201
import { ListStackResourcesCommandInput, ListStackResourcesCommandOutput } from "./commands/ListStackResourcesCommand";
202202
import { ListStacksCommandInput, ListStacksCommandOutput } from "./commands/ListStacksCommand";
203+
import {
204+
ListStackSetAutoDeploymentTargetsCommandInput,
205+
ListStackSetAutoDeploymentTargetsCommandOutput,
206+
} from "./commands/ListStackSetAutoDeploymentTargetsCommand";
203207
import {
204208
ListStackSetOperationResultsCommandInput,
205209
ListStackSetOperationResultsCommandOutput,
@@ -325,6 +329,7 @@ export type ServiceInputTypes =
325329
| ListStackInstanceResourceDriftsCommandInput
326330
| ListStackInstancesCommandInput
327331
| ListStackResourcesCommandInput
332+
| ListStackSetAutoDeploymentTargetsCommandInput
328333
| ListStackSetOperationResultsCommandInput
329334
| ListStackSetOperationsCommandInput
330335
| ListStackSetsCommandInput
@@ -411,6 +416,7 @@ export type ServiceOutputTypes =
411416
| ListStackInstanceResourceDriftsCommandOutput
412417
| ListStackInstancesCommandOutput
413418
| ListStackResourcesCommandOutput
419+
| ListStackSetAutoDeploymentTargetsCommandOutput
414420
| ListStackSetOperationResultsCommandOutput
415421
| ListStackSetOperationsCommandOutput
416422
| ListStackSetsCommandOutput

clients/client-cloudformation/src/commands/ActivateTypeCommand.ts

+3-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,9 @@ export interface ActivateTypeCommandOutput extends ActivateTypeOutput, __Metadat
3232
* extensions</a> in the <i>CloudFormation User Guide</i>.</p>
3333
* <p>Once you have activated a public third-party extension in your account and Region, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html">
3434
* <code>SetTypeConfiguration</code>
35-
* </a> to specify configuration properties for the extension. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration">Configuring extensions at the account level</a> in the <i>CloudFormation User Guide</i>.</p>
35+
* </a> to specify configuration properties for the extension. For more
36+
* information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration">Configuring extensions at
37+
* the account level</a> in the <i>CloudFormation User Guide</i>.</p>
3638
* @example
3739
* Use a bare-bones client and the command you need to make an API call.
3840
* ```javascript
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
// smithy-typescript generated code
2+
import { getEndpointPlugin } from "@smithy/middleware-endpoint";
3+
import { getSerdePlugin } from "@smithy/middleware-serde";
4+
import { Command as $Command } from "@smithy/smithy-client";
5+
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
6+
7+
import { CloudFormationClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFormationClient";
8+
import { commonParams } from "../endpoint/EndpointParameters";
9+
import { ListStackSetAutoDeploymentTargetsInput, ListStackSetAutoDeploymentTargetsOutput } from "../models/models_0";
10+
import {
11+
de_ListStackSetAutoDeploymentTargetsCommand,
12+
se_ListStackSetAutoDeploymentTargetsCommand,
13+
} from "../protocols/Aws_query";
14+
15+
/**
16+
* @public
17+
*/
18+
export { __MetadataBearer, $Command };
19+
/**
20+
* @public
21+
*
22+
* The input for {@link ListStackSetAutoDeploymentTargetsCommand}.
23+
*/
24+
export interface ListStackSetAutoDeploymentTargetsCommandInput extends ListStackSetAutoDeploymentTargetsInput {}
25+
/**
26+
* @public
27+
*
28+
* The output of {@link ListStackSetAutoDeploymentTargetsCommand}.
29+
*/
30+
export interface ListStackSetAutoDeploymentTargetsCommandOutput
31+
extends ListStackSetAutoDeploymentTargetsOutput,
32+
__MetadataBearer {}
33+
34+
/**
35+
* <p>Returns summary information about deployment targets for a stack set.</p>
36+
* @example
37+
* Use a bare-bones client and the command you need to make an API call.
38+
* ```javascript
39+
* import { CloudFormationClient, ListStackSetAutoDeploymentTargetsCommand } from "@aws-sdk/client-cloudformation"; // ES Modules import
40+
* // const { CloudFormationClient, ListStackSetAutoDeploymentTargetsCommand } = require("@aws-sdk/client-cloudformation"); // CommonJS import
41+
* const client = new CloudFormationClient(config);
42+
* const input = { // ListStackSetAutoDeploymentTargetsInput
43+
* StackSetName: "STRING_VALUE", // required
44+
* NextToken: "STRING_VALUE",
45+
* MaxResults: Number("int"),
46+
* CallAs: "SELF" || "DELEGATED_ADMIN",
47+
* };
48+
* const command = new ListStackSetAutoDeploymentTargetsCommand(input);
49+
* const response = await client.send(command);
50+
* // { // ListStackSetAutoDeploymentTargetsOutput
51+
* // Summaries: [ // StackSetAutoDeploymentTargetSummaries
52+
* // { // StackSetAutoDeploymentTargetSummary
53+
* // OrganizationalUnitId: "STRING_VALUE",
54+
* // Regions: [ // RegionList
55+
* // "STRING_VALUE",
56+
* // ],
57+
* // },
58+
* // ],
59+
* // NextToken: "STRING_VALUE",
60+
* // };
61+
*
62+
* ```
63+
*
64+
* @param ListStackSetAutoDeploymentTargetsCommandInput - {@link ListStackSetAutoDeploymentTargetsCommandInput}
65+
* @returns {@link ListStackSetAutoDeploymentTargetsCommandOutput}
66+
* @see {@link ListStackSetAutoDeploymentTargetsCommandInput} for command's `input` shape.
67+
* @see {@link ListStackSetAutoDeploymentTargetsCommandOutput} for command's `response` shape.
68+
* @see {@link CloudFormationClientResolvedConfig | config} for CloudFormationClient's `config` shape.
69+
*
70+
* @throws {@link StackSetNotFoundException} (client fault)
71+
* <p>The specified stack set doesn't exist.</p>
72+
*
73+
* @throws {@link CloudFormationServiceException}
74+
* <p>Base exception class for all service exceptions from CloudFormation service.</p>
75+
*
76+
* @public
77+
*/
78+
export class ListStackSetAutoDeploymentTargetsCommand extends $Command
79+
.classBuilder<
80+
ListStackSetAutoDeploymentTargetsCommandInput,
81+
ListStackSetAutoDeploymentTargetsCommandOutput,
82+
CloudFormationClientResolvedConfig,
83+
ServiceInputTypes,
84+
ServiceOutputTypes
85+
>()
86+
.ep({
87+
...commonParams,
88+
})
89+
.m(function (this: any, Command: any, cs: any, config: CloudFormationClientResolvedConfig, o: any) {
90+
return [
91+
getSerdePlugin(config, this.serialize, this.deserialize),
92+
getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
93+
];
94+
})
95+
.s("CloudFormation", "ListStackSetAutoDeploymentTargets", {})
96+
.n("CloudFormationClient", "ListStackSetAutoDeploymentTargetsCommand")
97+
.f(void 0, void 0)
98+
.ser(se_ListStackSetAutoDeploymentTargetsCommand)
99+
.de(de_ListStackSetAutoDeploymentTargetsCommand)
100+
.build() {}

clients/client-cloudformation/src/commands/RegisterTypeCommand.ts

+2-2
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,8 @@ export interface RegisterTypeCommandOutput extends RegisterTypeOutput, __Metadat
4949
* <p>Once you have initiated a registration request using <a>RegisterType</a>, you can use <a>DescribeTypeRegistration</a> to monitor the progress of the registration request.</p>
5050
* <p>Once you have registered a private extension in your account and Region, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_SetTypeConfiguration.html">
5151
* <code>SetTypeConfiguration</code>
52-
* </a> to specify
53-
* configuration properties for the extension. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration">Configuring extensions at
52+
* </a>
53+
* to specify configuration properties for the extension. For more information, see <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry-register.html#registry-set-configuration">Configuring extensions at
5454
* the account level</a> in the <i>CloudFormation User Guide</i>.</p>
5555
* @example
5656
* Use a bare-bones client and the command you need to make an API call.

clients/client-cloudformation/src/commands/SetTypeDefaultVersionCommand.ts

+2-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { CloudFormationClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFormationClient";
88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { SetTypeDefaultVersionInput, SetTypeDefaultVersionOutput } from "../models/models_0";
9+
import { SetTypeDefaultVersionInput } from "../models/models_0";
10+
import { SetTypeDefaultVersionOutput } from "../models/models_1";
1011
import { de_SetTypeDefaultVersionCommand, se_SetTypeDefaultVersionCommand } from "../protocols/Aws_query";
1112

1213
/**

clients/client-cloudformation/src/commands/SignalResourceCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
66

77
import { CloudFormationClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudFormationClient";
88
import { commonParams } from "../endpoint/EndpointParameters";
9-
import { SignalResourceInput } from "../models/models_0";
9+
import { SignalResourceInput } from "../models/models_1";
1010
import { de_SignalResourceCommand, se_SignalResourceCommand } from "../protocols/Aws_query";
1111

1212
/**

clients/client-cloudformation/src/commands/TestTypeCommand.ts

+2-2
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,8 @@ export interface TestTypeCommandOutput extends TestTypeOutput, __MetadataBearer
4747
* <p>Once you've initiated testing on an extension using <code>TestType</code>, you can pass the returned
4848
* <code>TypeVersionArn</code> into <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeType.html">
4949
* <code>DescribeType</code>
50-
* </a> to monitor the current test
51-
* status and test status description for the extension.</p>
50+
* </a> to monitor the
51+
* current test status and test status description for the extension.</p>
5252
* <p>An extension must have a test status of <code>PASSED</code> before it can be published. For more information,
5353
* see <a href="https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-publish.html">Publishing
5454
* extensions to make them available for public use</a> in the <i>CloudFormation CLI User

clients/client-cloudformation/src/commands/UpdateStackInstancesCommand.ts

+6-6
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,13 @@ export interface UpdateStackInstancesCommandOutput extends UpdateStackInstancesO
3737
* <p>You can only update the parameter <i>values</i> that are specified in the stack set; to add or
3838
* delete a parameter itself, use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html">
3939
* <code>UpdateStackSet</code>
40-
* </a> to update the stack set
41-
* template. If you add a parameter to a template, before you can override the parameter value specified in the stack
42-
* set you must first use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html">
40+
* </a> to update the
41+
* stack set template. If you add a parameter to a template, before you can override the parameter value specified in
42+
* the stack set you must first use <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html">
4343
* <code>UpdateStackSet</code>
44-
* </a> to update all stack
45-
* instances with the updated template and parameter value specified in the stack set. Once a stack instance has been
46-
* updated with the new parameter, you can then override the parameter value using
44+
* </a> to update all
45+
* stack instances with the updated template and parameter value specified in the stack set. Once a stack instance has
46+
* been updated with the new parameter, you can then override the parameter value using
4747
* <code>UpdateStackInstances</code>.</p>
4848
* @example
4949
* Use a bare-bones client and the command you need to make an API call.

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

+1
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@ export * from "./ListResourceScansCommand";
5555
export * from "./ListStackInstanceResourceDriftsCommand";
5656
export * from "./ListStackInstancesCommand";
5757
export * from "./ListStackResourcesCommand";
58+
export * from "./ListStackSetAutoDeploymentTargetsCommand";
5859
export * from "./ListStackSetOperationResultsCommand";
5960
export * from "./ListStackSetOperationsCommand";
6061
export * from "./ListStackSetsCommand";

0 commit comments

Comments
 (0)