feat(client-ssm): Added support for providing high-level overviews of managed nodes and previewing the potential impact of a runbook execution.

Author: awstools

Diff for: clients/client-ssm/README.md

@@ -58,16 +58,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 `SSMClient` and
-the commands you need, for example `ListAssociationsCommand`:
+the commands you need, for example `ListNodesCommand`:
 
 ```js
 // ES5 example
-const { SSMClient, ListAssociationsCommand } = require("@aws-sdk/client-ssm");
+const { SSMClient, ListNodesCommand } = require("@aws-sdk/client-ssm");
 ```
 
 ```ts
 // ES6+ example
-import { SSMClient, ListAssociationsCommand } from "@aws-sdk/client-ssm";
+import { SSMClient, ListNodesCommand } from "@aws-sdk/client-ssm";
 ```
 
 ### Usage
@@ -86,7 +86,7 @@ const client = new SSMClient({ region: "REGION" });
 const params = {
   /** input parameters */
 };
-const command = new ListAssociationsCommand(params);
+const command = new ListNodesCommand(params);
 ```
 
 #### Async/await
@@ -165,15 +165,15 @@ const client = new AWS.SSM({ region: "REGION" });
 
 // async/await.
 try {
-  const data = await client.listAssociations(params);
+  const data = await client.listNodes(params);
   // process data.
 } catch (error) {
   // error handling.
 }
 
 // Promises.
 client
-  .listAssociations(params)
+  .listNodes(params)
   .then((data) => {
     // process data.
   })
@@ -182,7 +182,7 @@ client
   });
 
 // callbacks.
-client.listAssociations(params, (err, data) => {
+client.listNodes(params, (err, data) => {
   // process err and data.
 });
 ```
@@ -797,6 +797,14 @@ GetDocument
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/GetDocumentCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/GetDocumentCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/GetDocumentCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetExecutionPreview
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/GetExecutionPreviewCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/GetExecutionPreviewCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/GetExecutionPreviewCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -1029,6 +1037,22 @@ ListInventoryEntries
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/ListInventoryEntriesCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/ListInventoryEntriesCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/ListInventoryEntriesCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListNodes
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/ListNodesCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/ListNodesCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/ListNodesCommandOutput/)
+
+</details>
+<details>
+<summary>
+ListNodesSummary
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/ListNodesSummaryCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/ListNodesSummaryCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/ListNodesSummaryCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -1213,6 +1237,14 @@ StartChangeRequestExecution
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/StartChangeRequestExecutionCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/StartChangeRequestExecutionCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/StartChangeRequestExecutionCommandOutput/)
 
+</details>
+<details>
+<summary>
+StartExecutionPreview
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ssm/command/StartExecutionPreviewCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/StartExecutionPreviewCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ssm/Interface/StartExecutionPreviewCommandOutput/)
+
 </details>
 <details>
 <summary>

Diff for: clients/client-ssm/src/SSM.ts

@@ -348,6 +348,11 @@ import {
   GetDeployablePatchSnapshotForInstanceCommandOutput,
 } from "./commands/GetDeployablePatchSnapshotForInstanceCommand";
 import { GetDocumentCommand, GetDocumentCommandInput, GetDocumentCommandOutput } from "./commands/GetDocumentCommand";
+import {
+  GetExecutionPreviewCommand,
+  GetExecutionPreviewCommandInput,
+  GetExecutionPreviewCommandOutput,
+} from "./commands/GetExecutionPreviewCommand";
 import {
   GetInventoryCommand,
   GetInventoryCommandInput,
@@ -489,6 +494,12 @@ import {
   ListInventoryEntriesCommandInput,
   ListInventoryEntriesCommandOutput,
 } from "./commands/ListInventoryEntriesCommand";
+import { ListNodesCommand, ListNodesCommandInput, ListNodesCommandOutput } from "./commands/ListNodesCommand";
+import {
+  ListNodesSummaryCommand,
+  ListNodesSummaryCommandInput,
+  ListNodesSummaryCommandOutput,
+} from "./commands/ListNodesSummaryCommand";
 import {
   ListOpsItemEventsCommand,
   ListOpsItemEventsCommandInput,
@@ -600,6 +611,11 @@ import {
   StartChangeRequestExecutionCommandInput,
   StartChangeRequestExecutionCommandOutput,
 } from "./commands/StartChangeRequestExecutionCommand";
+import {
+  StartExecutionPreviewCommand,
+  StartExecutionPreviewCommandInput,
+  StartExecutionPreviewCommandOutput,
+} from "./commands/StartExecutionPreviewCommand";
 import {
   StartSessionCommand,
   StartSessionCommandInput,
@@ -763,6 +779,7 @@ const commands = {
   GetDefaultPatchBaselineCommand,
   GetDeployablePatchSnapshotForInstanceCommand,
   GetDocumentCommand,
+  GetExecutionPreviewCommand,
   GetInventoryCommand,
   GetInventorySchemaCommand,
   GetMaintenanceWindowCommand,
@@ -792,6 +809,8 @@ const commands = {
   ListDocumentsCommand,
   ListDocumentVersionsCommand,
   ListInventoryEntriesCommand,
+  ListNodesCommand,
+  ListNodesSummaryCommand,
   ListOpsItemEventsCommand,
   ListOpsItemRelatedItemsCommand,
   ListOpsMetadataCommand,
@@ -815,6 +834,7 @@ const commands = {
   StartAssociationsOnceCommand,
   StartAutomationExecutionCommand,
   StartChangeRequestExecutionCommand,
+  StartExecutionPreviewCommand,
   StartSessionCommand,
   StopAutomationExecutionCommand,
   TerminateSessionCommand,
@@ -2005,6 +2025,23 @@ export interface SSM {
     cb: (err: any, data?: GetDocumentCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link GetExecutionPreviewCommand}
+   */
+  getExecutionPreview(
+    args: GetExecutionPreviewCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<GetExecutionPreviewCommandOutput>;
+  getExecutionPreview(
+    args: GetExecutionPreviewCommandInput,
+    cb: (err: any, data?: GetExecutionPreviewCommandOutput) => void
+  ): void;
+  getExecutionPreview(
+    args: GetExecutionPreviewCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetExecutionPreviewCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link GetInventoryCommand}
    */
@@ -2462,6 +2499,35 @@ export interface SSM {
     cb: (err: any, data?: ListInventoryEntriesCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListNodesCommand}
+   */
+  listNodes(): Promise<ListNodesCommandOutput>;
+  listNodes(args: ListNodesCommandInput, options?: __HttpHandlerOptions): Promise<ListNodesCommandOutput>;
+  listNodes(args: ListNodesCommandInput, cb: (err: any, data?: ListNodesCommandOutput) => void): void;
+  listNodes(
+    args: ListNodesCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListNodesCommandOutput) => void
+  ): void;
+
+  /**
+   * @see {@link ListNodesSummaryCommand}
+   */
+  listNodesSummary(
+    args: ListNodesSummaryCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListNodesSummaryCommandOutput>;
+  listNodesSummary(
+    args: ListNodesSummaryCommandInput,
+    cb: (err: any, data?: ListNodesSummaryCommandOutput) => void
+  ): void;
+  listNodesSummary(
+    args: ListNodesSummaryCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListNodesSummaryCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListOpsItemEventsCommand}
    */
@@ -2831,6 +2897,23 @@ export interface SSM {
     cb: (err: any, data?: StartChangeRequestExecutionCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link StartExecutionPreviewCommand}
+   */
+  startExecutionPreview(
+    args: StartExecutionPreviewCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<StartExecutionPreviewCommandOutput>;
+  startExecutionPreview(
+    args: StartExecutionPreviewCommandInput,
+    cb: (err: any, data?: StartExecutionPreviewCommandOutput) => void
+  ): void;
+  startExecutionPreview(
+    args: StartExecutionPreviewCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: StartExecutionPreviewCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link StartSessionCommand}
    */

Diff for: clients/client-ssm/src/SSMClient.ts

@@ -270,6 +270,10 @@ import {
   GetDeployablePatchSnapshotForInstanceCommandOutput,
 } from "./commands/GetDeployablePatchSnapshotForInstanceCommand";
 import { GetDocumentCommandInput, GetDocumentCommandOutput } from "./commands/GetDocumentCommand";
+import {
+  GetExecutionPreviewCommandInput,
+  GetExecutionPreviewCommandOutput,
+} from "./commands/GetExecutionPreviewCommand";
 import { GetInventoryCommandInput, GetInventoryCommandOutput } from "./commands/GetInventoryCommand";
 import { GetInventorySchemaCommandInput, GetInventorySchemaCommandOutput } from "./commands/GetInventorySchemaCommand";
 import {
@@ -350,6 +354,8 @@ import {
   ListInventoryEntriesCommandInput,
   ListInventoryEntriesCommandOutput,
 } from "./commands/ListInventoryEntriesCommand";
+import { ListNodesCommandInput, ListNodesCommandOutput } from "./commands/ListNodesCommand";
+import { ListNodesSummaryCommandInput, ListNodesSummaryCommandOutput } from "./commands/ListNodesSummaryCommand";
 import { ListOpsItemEventsCommandInput, ListOpsItemEventsCommandOutput } from "./commands/ListOpsItemEventsCommand";
 import {
   ListOpsItemRelatedItemsCommandInput,
@@ -418,6 +424,10 @@ import {
   StartChangeRequestExecutionCommandInput,
   StartChangeRequestExecutionCommandOutput,
 } from "./commands/StartChangeRequestExecutionCommand";
+import {
+  StartExecutionPreviewCommandInput,
+  StartExecutionPreviewCommandOutput,
+} from "./commands/StartExecutionPreviewCommand";
 import { StartSessionCommandInput, StartSessionCommandOutput } from "./commands/StartSessionCommand";
 import {
   StopAutomationExecutionCommandInput,
@@ -557,6 +567,7 @@ export type ServiceInputTypes =
   | GetDefaultPatchBaselineCommandInput
   | GetDeployablePatchSnapshotForInstanceCommandInput
   | GetDocumentCommandInput
+  | GetExecutionPreviewCommandInput
   | GetInventoryCommandInput
   | GetInventorySchemaCommandInput
   | GetMaintenanceWindowCommandInput
@@ -586,6 +597,8 @@ export type ServiceInputTypes =
   | ListDocumentVersionsCommandInput
   | ListDocumentsCommandInput
   | ListInventoryEntriesCommandInput
+  | ListNodesCommandInput
+  | ListNodesSummaryCommandInput
   | ListOpsItemEventsCommandInput
   | ListOpsItemRelatedItemsCommandInput
   | ListOpsMetadataCommandInput
@@ -609,6 +622,7 @@ export type ServiceInputTypes =
   | StartAssociationsOnceCommandInput
   | StartAutomationExecutionCommandInput
   | StartChangeRequestExecutionCommandInput
+  | StartExecutionPreviewCommandInput
   | StartSessionCommandInput
   | StopAutomationExecutionCommandInput
   | TerminateSessionCommandInput
@@ -702,6 +716,7 @@ export type ServiceOutputTypes =
   | GetDefaultPatchBaselineCommandOutput
   | GetDeployablePatchSnapshotForInstanceCommandOutput
   | GetDocumentCommandOutput
+  | GetExecutionPreviewCommandOutput
   | GetInventoryCommandOutput
   | GetInventorySchemaCommandOutput
   | GetMaintenanceWindowCommandOutput
@@ -731,6 +746,8 @@ export type ServiceOutputTypes =
   | ListDocumentVersionsCommandOutput
   | ListDocumentsCommandOutput
   | ListInventoryEntriesCommandOutput
+  | ListNodesCommandOutput
+  | ListNodesSummaryCommandOutput
   | ListOpsItemEventsCommandOutput
   | ListOpsItemRelatedItemsCommandOutput
   | ListOpsMetadataCommandOutput
@@ -754,6 +771,7 @@ export type ServiceOutputTypes =
   | StartAssociationsOnceCommandOutput
   | StartAutomationExecutionCommandOutput
   | StartChangeRequestExecutionCommandOutput
+  | StartExecutionPreviewCommandOutput
   | StartSessionCommandOutput
   | StopAutomationExecutionCommandOutput
   | TerminateSessionCommandOutput

Diff for: clients/client-ssm/src/commands/CreateResourceDataSyncCommand.ts

@@ -32,7 +32,7 @@ export interface CreateResourceDataSyncCommandOutput extends CreateResourceDataS
  *    Amazon Web Services Systems Manager offers two types of resource data sync: <code>SyncToDestination</code> and
  *     <code>SyncFromSource</code>.</p>
  *          <p>You can configure Systems Manager Inventory to use the <code>SyncToDestination</code> type to
- *    synchronize Inventory data from multiple Amazon Web Services Regions to a single Amazon Simple Storage Service (Amazon S3) bucket. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-create-resource-data-sync.html">Creatinga a
+ *    synchronize Inventory data from multiple Amazon Web Services Regions to a single Amazon Simple Storage Service (Amazon S3) bucket. For more information, see <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-create-resource-data-sync.html">Creating a
  *     resource data sync for Inventory</a> in the <i>Amazon Web Services Systems Manager User Guide</i>.</p>
  *          <p>You can configure Systems Manager Explorer to use the <code>SyncFromSource</code> type to synchronize
  *    operational work items (OpsItems) and operational data (OpsData) from multiple Amazon Web Services Regions to a

Diff for: clients/client-ssm/src/commands/DeleteActivationCommand.ts

@@ -60,7 +60,7 @@ export interface DeleteActivationCommandOutput extends DeleteActivationResult, _
  *    the ActivationCode don't match.</p>
  *
  * @throws {@link InvalidActivationId} (client fault)
- *  <p>The activation ID isn't valid. Verify the you entered the correct ActivationId or
+ *  <p>The activation ID isn't valid. Verify that you entered the correct ActivationId or
  *    ActivationCode and try again.</p>
  *
  * @throws {@link TooManyUpdates} (client fault)

Diff for: clients/client-ssm/src/commands/DescribeActivationsCommand.ts

@@ -87,7 +87,7 @@ export interface DescribeActivationsCommandOutput extends DescribeActivationsRes
  *  <p>An error occurred on the server side.</p>
  *
  * @throws {@link InvalidFilter} (client fault)
- *  <p>The filter name isn't valid. Verify the you entered the correct name and try again.</p>
+ *  <p>The filter name isn't valid. Verify that you entered the correct name and try again.</p>
  *
  * @throws {@link InvalidNextToken} (client fault)
  *  <p>The specified token isn't valid.</p>

Diff for: clients/client-ssm/src/commands/DescribeInstancePatchStatesForPatchGroupCommand.ts

@@ -104,7 +104,7 @@ export interface DescribeInstancePatchStatesForPatchGroupCommandOutput
  *  <p>An error occurred on the server side.</p>
  *
  * @throws {@link InvalidFilter} (client fault)
- *  <p>The filter name isn't valid. Verify the you entered the correct name and try again.</p>
+ *  <p>The filter name isn't valid. Verify that you entered the correct name and try again.</p>
  *
  * @throws {@link InvalidNextToken} (client fault)
  *  <p>The specified token isn't valid.</p>

Diff for: clients/client-ssm/src/commands/DescribeInstancePatchesCommand.ts

@@ -78,7 +78,7 @@ export interface DescribeInstancePatchesCommandOutput extends DescribeInstancePa
  *  <p>An error occurred on the server side.</p>
  *
  * @throws {@link InvalidFilter} (client fault)
- *  <p>The filter name isn't valid. Verify the you entered the correct name and try again.</p>
+ *  <p>The filter name isn't valid. Verify that you entered the correct name and try again.</p>
  *
  * @throws {@link InvalidInstanceId} (client fault)
  *  <p>The following problems can cause this exception:</p>

Diff for: clients/client-ssm/src/commands/DescribeInstancePropertiesCommand.ts

@@ -114,7 +114,7 @@ export interface DescribeInstancePropertiesCommandOutput extends DescribeInstanc
  *  <p>An error occurred on the server side.</p>
  *
  * @throws {@link InvalidActivationId} (client fault)
- *  <p>The activation ID isn't valid. Verify the you entered the correct ActivationId or
+ *  <p>The activation ID isn't valid. Verify that you entered the correct ActivationId or
  *    ActivationCode and try again.</p>
  *
  * @throws {@link InvalidDocument} (client fault)