feat(client-resource-groups): This update includes new APIs to suppor…

…t application groups and to allow users to manage resource tag-sync tasks in applications.
aws · Sep 30, 2024 · 22f9f33 · 22f9f33
1 parent dddd164
commit 22f9f33
Show file tree

Hide file tree

Showing 25 changed files with 3,097 additions and 256 deletions.
diff --git a/clients/client-resource-groups/README.md b/clients/client-resource-groups/README.md
@@ -30,7 +30,7 @@ resource query entities</p>
 <p>Applying, editing, and removing tags from resource groups</p>
 </li>
 <li>
-<p>Resolving resource group member ARNs so they can be returned as search
+<p>Resolving resource group member Amazon resource names (ARN)s so they can be returned as search
 results</p>
 </li>
 <li>
@@ -236,6 +236,14 @@ see LICENSE for more information.
 
 ## Client Commands (Operations List)
 
+<details>
+<summary>
+CancelTagSyncTask
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/CancelTagSyncTaskCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/CancelTagSyncTaskCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/CancelTagSyncTaskCommandOutput/)
+
+</details>
 <details>
 <summary>
 CreateGroup
@@ -291,6 +299,14 @@ GetTags
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/GetTagsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/GetTagsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/GetTagsCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetTagSyncTask
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/GetTagSyncTaskCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/GetTagSyncTaskCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/GetTagSyncTaskCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -299,6 +315,14 @@ GroupResources
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/GroupResourcesCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/GroupResourcesCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/GroupResourcesCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListGroupingStatuses
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/ListGroupingStatusesCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/ListGroupingStatusesCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/ListGroupingStatusesCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -315,6 +339,14 @@ ListGroups
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/ListGroupsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/ListGroupsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/ListGroupsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListTagSyncTasks
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/ListTagSyncTasksCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/ListTagSyncTasksCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/ListTagSyncTasksCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -331,6 +363,14 @@ SearchResources
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/SearchResourcesCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/SearchResourcesCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/SearchResourcesCommandOutput/)
 
+</details>
+<details>
+<summary>
+StartTagSyncTask
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/resource-groups/command/StartTagSyncTaskCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/StartTagSyncTaskCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-resource-groups/Interface/StartTagSyncTaskCommandOutput/)
+
 </details>
 <details>
 <summary>

diff --git a/clients/client-resource-groups/src/ResourceGroups.ts b/clients/client-resource-groups/src/ResourceGroups.ts
@@ -2,6 +2,11 @@
 import { createAggregatedClient } from "@smithy/smithy-client";
 import { HttpHandlerOptions as __HttpHandlerOptions } from "@smithy/types";
 
+import {
+  CancelTagSyncTaskCommand,
+  CancelTagSyncTaskCommandInput,
+  CancelTagSyncTaskCommandOutput,
+} from "./commands/CancelTagSyncTaskCommand";
 import { CreateGroupCommand, CreateGroupCommandInput, CreateGroupCommandOutput } from "./commands/CreateGroupCommand";
 import { DeleteGroupCommand, DeleteGroupCommandInput, DeleteGroupCommandOutput } from "./commands/DeleteGroupCommand";
 import {
@@ -21,17 +26,32 @@ import {
   GetGroupQueryCommandOutput,
 } from "./commands/GetGroupQueryCommand";
 import { GetTagsCommand, GetTagsCommandInput, GetTagsCommandOutput } from "./commands/GetTagsCommand";
+import {
+  GetTagSyncTaskCommand,
+  GetTagSyncTaskCommandInput,
+  GetTagSyncTaskCommandOutput,
+} from "./commands/GetTagSyncTaskCommand";
 import {
   GroupResourcesCommand,
   GroupResourcesCommandInput,
   GroupResourcesCommandOutput,
 } from "./commands/GroupResourcesCommand";
+import {
+  ListGroupingStatusesCommand,
+  ListGroupingStatusesCommandInput,
+  ListGroupingStatusesCommandOutput,
+} from "./commands/ListGroupingStatusesCommand";
 import {
   ListGroupResourcesCommand,
   ListGroupResourcesCommandInput,
   ListGroupResourcesCommandOutput,
 } from "./commands/ListGroupResourcesCommand";
 import { ListGroupsCommand, ListGroupsCommandInput, ListGroupsCommandOutput } from "./commands/ListGroupsCommand";
+import {
+  ListTagSyncTasksCommand,
+  ListTagSyncTasksCommandInput,
+  ListTagSyncTasksCommandOutput,
+} from "./commands/ListTagSyncTasksCommand";
 import {
   PutGroupConfigurationCommand,
   PutGroupConfigurationCommandInput,
@@ -42,6 +62,11 @@ import {
   SearchResourcesCommandInput,
   SearchResourcesCommandOutput,
 } from "./commands/SearchResourcesCommand";
+import {
+  StartTagSyncTaskCommand,
+  StartTagSyncTaskCommandInput,
+  StartTagSyncTaskCommandOutput,
+} from "./commands/StartTagSyncTaskCommand";
 import { TagCommand, TagCommandInput, TagCommandOutput } from "./commands/TagCommand";
 import {
   UngroupResourcesCommand,
@@ -63,18 +88,23 @@ import {
 import { ResourceGroupsClient, ResourceGroupsClientConfig } from "./ResourceGroupsClient";
 
 const commands = {
+  CancelTagSyncTaskCommand,
   CreateGroupCommand,
   DeleteGroupCommand,
   GetAccountSettingsCommand,
   GetGroupCommand,
   GetGroupConfigurationCommand,
   GetGroupQueryCommand,
   GetTagsCommand,
+  GetTagSyncTaskCommand,
   GroupResourcesCommand,
+  ListGroupingStatusesCommand,
   ListGroupResourcesCommand,
   ListGroupsCommand,
+  ListTagSyncTasksCommand,
   PutGroupConfigurationCommand,
   SearchResourcesCommand,
+  StartTagSyncTaskCommand,
   TagCommand,
   UngroupResourcesCommand,
   UntagCommand,
@@ -84,6 +114,23 @@ const commands = {
 };
 
 export interface ResourceGroups {
+  /**
+   * @see {@link CancelTagSyncTaskCommand}
+   */
+  cancelTagSyncTask(
+    args: CancelTagSyncTaskCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<CancelTagSyncTaskCommandOutput>;
+  cancelTagSyncTask(
+    args: CancelTagSyncTaskCommandInput,
+    cb: (err: any, data?: CancelTagSyncTaskCommandOutput) => void
+  ): void;
+  cancelTagSyncTask(
+    args: CancelTagSyncTaskCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: CancelTagSyncTaskCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link CreateGroupCommand}
    */
@@ -178,6 +225,20 @@ export interface ResourceGroups {
     cb: (err: any, data?: GetTagsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link GetTagSyncTaskCommand}
+   */
+  getTagSyncTask(
+    args: GetTagSyncTaskCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<GetTagSyncTaskCommandOutput>;
+  getTagSyncTask(args: GetTagSyncTaskCommandInput, cb: (err: any, data?: GetTagSyncTaskCommandOutput) => void): void;
+  getTagSyncTask(
+    args: GetTagSyncTaskCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetTagSyncTaskCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link GroupResourcesCommand}
    */
@@ -192,6 +253,23 @@ export interface ResourceGroups {
     cb: (err: any, data?: GroupResourcesCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListGroupingStatusesCommand}
+   */
+  listGroupingStatuses(
+    args: ListGroupingStatusesCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListGroupingStatusesCommandOutput>;
+  listGroupingStatuses(
+    args: ListGroupingStatusesCommandInput,
+    cb: (err: any, data?: ListGroupingStatusesCommandOutput) => void
+  ): void;
+  listGroupingStatuses(
+    args: ListGroupingStatusesCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListGroupingStatusesCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListGroupResourcesCommand}
    */
@@ -222,6 +300,24 @@ export interface ResourceGroups {
     cb: (err: any, data?: ListGroupsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListTagSyncTasksCommand}
+   */
+  listTagSyncTasks(): Promise<ListTagSyncTasksCommandOutput>;
+  listTagSyncTasks(
+    args: ListTagSyncTasksCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListTagSyncTasksCommandOutput>;
+  listTagSyncTasks(
+    args: ListTagSyncTasksCommandInput,
+    cb: (err: any, data?: ListTagSyncTasksCommandOutput) => void
+  ): void;
+  listTagSyncTasks(
+    args: ListTagSyncTasksCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListTagSyncTasksCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link PutGroupConfigurationCommand}
    */
@@ -254,6 +350,23 @@ export interface ResourceGroups {
     cb: (err: any, data?: SearchResourcesCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link StartTagSyncTaskCommand}
+   */
+  startTagSyncTask(
+    args: StartTagSyncTaskCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<StartTagSyncTaskCommandOutput>;
+  startTagSyncTask(
+    args: StartTagSyncTaskCommandInput,
+    cb: (err: any, data?: StartTagSyncTaskCommandOutput) => void
+  ): void;
+  startTagSyncTask(
+    args: StartTagSyncTaskCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: StartTagSyncTaskCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link TagCommand}
    */
@@ -362,7 +475,7 @@ export interface ResourceGroups {
  *                <p>Applying, editing, and removing tags from resource groups</p>
  *             </li>
  *             <li>
- *                <p>Resolving resource group member ARNs so they can be returned as search
+ *                <p>Resolving resource group member Amazon resource names (ARN)s so they can be returned as search
  *                     results</p>
  *             </li>
  *             <li>

diff --git a/clients/client-resource-groups/src/ResourceGroupsClient.ts b/clients/client-resource-groups/src/ResourceGroupsClient.ts
@@ -53,6 +53,7 @@ import {
   HttpAuthSchemeResolvedConfig,
   resolveHttpAuthSchemeConfig,
 } from "./auth/httpAuthSchemeProvider";
+import { CancelTagSyncTaskCommandInput, CancelTagSyncTaskCommandOutput } from "./commands/CancelTagSyncTaskCommand";
 import { CreateGroupCommandInput, CreateGroupCommandOutput } from "./commands/CreateGroupCommand";
 import { DeleteGroupCommandInput, DeleteGroupCommandOutput } from "./commands/DeleteGroupCommand";
 import { GetAccountSettingsCommandInput, GetAccountSettingsCommandOutput } from "./commands/GetAccountSettingsCommand";
@@ -63,14 +64,21 @@ import {
 } from "./commands/GetGroupConfigurationCommand";
 import { GetGroupQueryCommandInput, GetGroupQueryCommandOutput } from "./commands/GetGroupQueryCommand";
 import { GetTagsCommandInput, GetTagsCommandOutput } from "./commands/GetTagsCommand";
+import { GetTagSyncTaskCommandInput, GetTagSyncTaskCommandOutput } from "./commands/GetTagSyncTaskCommand";
 import { GroupResourcesCommandInput, GroupResourcesCommandOutput } from "./commands/GroupResourcesCommand";
+import {
+  ListGroupingStatusesCommandInput,
+  ListGroupingStatusesCommandOutput,
+} from "./commands/ListGroupingStatusesCommand";
 import { ListGroupResourcesCommandInput, ListGroupResourcesCommandOutput } from "./commands/ListGroupResourcesCommand";
 import { ListGroupsCommandInput, ListGroupsCommandOutput } from "./commands/ListGroupsCommand";
+import { ListTagSyncTasksCommandInput, ListTagSyncTasksCommandOutput } from "./commands/ListTagSyncTasksCommand";
 import {
   PutGroupConfigurationCommandInput,
   PutGroupConfigurationCommandOutput,
 } from "./commands/PutGroupConfigurationCommand";
 import { SearchResourcesCommandInput, SearchResourcesCommandOutput } from "./commands/SearchResourcesCommand";
+import { StartTagSyncTaskCommandInput, StartTagSyncTaskCommandOutput } from "./commands/StartTagSyncTaskCommand";
 import { TagCommandInput, TagCommandOutput } from "./commands/TagCommand";
 import { UngroupResourcesCommandInput, UngroupResourcesCommandOutput } from "./commands/UngroupResourcesCommand";
 import { UntagCommandInput, UntagCommandOutput } from "./commands/UntagCommand";
@@ -95,18 +103,23 @@ export { __Client };
  * @public
  */
 export type ServiceInputTypes =
+  | CancelTagSyncTaskCommandInput
   | CreateGroupCommandInput
   | DeleteGroupCommandInput
   | GetAccountSettingsCommandInput
   | GetGroupCommandInput
   | GetGroupConfigurationCommandInput
   | GetGroupQueryCommandInput
+  | GetTagSyncTaskCommandInput
   | GetTagsCommandInput
   | GroupResourcesCommandInput
   | ListGroupResourcesCommandInput
+  | ListGroupingStatusesCommandInput
   | ListGroupsCommandInput
+  | ListTagSyncTasksCommandInput
   | PutGroupConfigurationCommandInput
   | SearchResourcesCommandInput
+  | StartTagSyncTaskCommandInput
   | TagCommandInput
   | UngroupResourcesCommandInput
   | UntagCommandInput
@@ -118,18 +131,23 @@ export type ServiceInputTypes =
  * @public
  */
 export type ServiceOutputTypes =
+  | CancelTagSyncTaskCommandOutput
   | CreateGroupCommandOutput
   | DeleteGroupCommandOutput
   | GetAccountSettingsCommandOutput
   | GetGroupCommandOutput
   | GetGroupConfigurationCommandOutput
   | GetGroupQueryCommandOutput
+  | GetTagSyncTaskCommandOutput
   | GetTagsCommandOutput
   | GroupResourcesCommandOutput
   | ListGroupResourcesCommandOutput
+  | ListGroupingStatusesCommandOutput
   | ListGroupsCommandOutput
+  | ListTagSyncTasksCommandOutput
   | PutGroupConfigurationCommandOutput
   | SearchResourcesCommandOutput
+  | StartTagSyncTaskCommandOutput
   | TagCommandOutput
   | UngroupResourcesCommandOutput
   | UntagCommandOutput
@@ -333,7 +351,7 @@ export interface ResourceGroupsClientResolvedConfig extends ResourceGroupsClient
  *                <p>Applying, editing, and removing tags from resource groups</p>
  *             </li>
  *             <li>
- *                <p>Resolving resource group member ARNs so they can be returned as search
+ *                <p>Resolving resource group member Amazon resource names (ARN)s so they can be returned as search
  *                     results</p>
  *             </li>
  *             <li>