@aws-sdk/client-resource-groups 3.658.0 → 3.661.0

package/dist-types/commands/ListTagSyncTasksCommand.d.ts

@@ -0,0 +1,122 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ListTagSyncTasksInput, ListTagSyncTasksOutput } from "../models/models_0";
+import { ResourceGroupsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ResourceGroupsClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListTagSyncTasksCommand}.
+ */
+export interface ListTagSyncTasksCommandInput extends ListTagSyncTasksInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListTagSyncTasksCommand}.
+ */
+export interface ListTagSyncTasksCommandOutput extends ListTagSyncTasksOutput, __MetadataBearer {
+}
+declare const ListTagSyncTasksCommand_base: {
+    new (input: ListTagSyncTasksCommandInput): import("@smithy/smithy-client").CommandImpl<ListTagSyncTasksCommandInput, ListTagSyncTasksCommandOutput, ResourceGroupsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [ListTagSyncTasksCommandInput]): import("@smithy/smithy-client").CommandImpl<ListTagSyncTasksCommandInput, ListTagSyncTasksCommandOutput, ResourceGroupsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Returns a list of tag-sync tasks. </p>
+ *          <p>
+ *             <b>Minimum permissions</b>
+ *          </p>
+ *          <p>To run this command, you must have the following permissions:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>resource-groups:ListTagSyncTasks</code> with the group passed in the filters as the resource
+ *                     or * if using no filters </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ResourceGroupsClient, ListTagSyncTasksCommand } from "@aws-sdk/client-resource-groups"; // ES Modules import
+ * // const { ResourceGroupsClient, ListTagSyncTasksCommand } = require("@aws-sdk/client-resource-groups"); // CommonJS import
+ * const client = new ResourceGroupsClient(config);
+ * const input = { // ListTagSyncTasksInput
+ *   Filters: [ // ListTagSyncTasksFilterList
+ *     { // ListTagSyncTasksFilter
+ *       GroupArn: "STRING_VALUE",
+ *       GroupName: "STRING_VALUE",
+ *     },
+ *   ],
+ *   MaxResults: Number("int"),
+ *   NextToken: "STRING_VALUE",
+ * };
+ * const command = new ListTagSyncTasksCommand(input);
+ * const response = await client.send(command);
+ * // { // ListTagSyncTasksOutput
+ * //   TagSyncTasks: [ // TagSyncTaskList
+ * //     { // TagSyncTaskItem
+ * //       GroupArn: "STRING_VALUE",
+ * //       GroupName: "STRING_VALUE",
+ * //       TaskArn: "STRING_VALUE",
+ * //       TagKey: "STRING_VALUE",
+ * //       TagValue: "STRING_VALUE",
+ * //       RoleArn: "STRING_VALUE",
+ * //       Status: "ACTIVE" || "ERROR",
+ * //       ErrorMessage: "STRING_VALUE",
+ * //       CreatedAt: new Date("TIMESTAMP"),
+ * //     },
+ * //   ],
+ * //   NextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param ListTagSyncTasksCommandInput - {@link ListTagSyncTasksCommandInput}
+ * @returns {@link ListTagSyncTasksCommandOutput}
+ * @see {@link ListTagSyncTasksCommandInput} for command's `input` shape.
+ * @see {@link ListTagSyncTasksCommandOutput} for command's `response` shape.
+ * @see {@link ResourceGroupsClientResolvedConfig | config} for ResourceGroupsClient's `config` shape.
+ *
+ * @throws {@link BadRequestException} (client fault)
+ *  <p>The request includes one or more parameters that violate validation rules.</p>
+ *
+ * @throws {@link ForbiddenException} (client fault)
+ *  <p>The caller isn't authorized to make the request. Check permissions.</p>
+ *
+ * @throws {@link InternalServerErrorException} (server fault)
+ *  <p>An internal error occurred while processing the request. Try again later.</p>
+ *
+ * @throws {@link MethodNotAllowedException} (client fault)
+ *  <p>The request uses an HTTP method that isn't allowed for the specified resource.</p>
+ *
+ * @throws {@link TooManyRequestsException} (client fault)
+ *  <p>You've exceeded throttling limits by making too many requests in a period of
+ *             time.</p>
+ *
+ * @throws {@link UnauthorizedException} (client fault)
+ *  <p>The request was rejected because it doesn't have valid credentials for the target
+ *             resource.</p>
+ *
+ * @throws {@link ResourceGroupsServiceException}
+ * <p>Base exception class for all service exceptions from ResourceGroups service.</p>
+ *
+ * @public
+ */
+export declare class ListTagSyncTasksCommand extends ListTagSyncTasksCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: ListTagSyncTasksInput;
+            output: ListTagSyncTasksOutput;
+        };
+        sdk: {
+            input: ListTagSyncTasksCommandInput;
+            output: ListTagSyncTasksCommandOutput;
+        };
+    };
+}

package/dist-types/commands/StartTagSyncTaskCommand.d.ts

@@ -0,0 +1,122 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { StartTagSyncTaskInput, StartTagSyncTaskOutput } from "../models/models_0";
+import { ResourceGroupsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ResourceGroupsClient";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link StartTagSyncTaskCommand}.
+ */
+export interface StartTagSyncTaskCommandInput extends StartTagSyncTaskInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link StartTagSyncTaskCommand}.
+ */
+export interface StartTagSyncTaskCommandOutput extends StartTagSyncTaskOutput, __MetadataBearer {
+}
+declare const StartTagSyncTaskCommand_base: {
+    new (input: StartTagSyncTaskCommandInput): import("@smithy/smithy-client").CommandImpl<StartTagSyncTaskCommandInput, StartTagSyncTaskCommandOutput, ResourceGroupsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: StartTagSyncTaskCommandInput): import("@smithy/smithy-client").CommandImpl<StartTagSyncTaskCommandInput, StartTagSyncTaskCommandOutput, ResourceGroupsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Creates a new tag-sync task to onboard and sync resources tagged with a specific tag key-value pair to an
+ *             application. </p>
+ *          <p>
+ *             <b>Minimum permissions</b>
+ *          </p>
+ *          <p>To run this command, you must have the following permissions:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>resource-groups:StartTagSyncTask</code> on the application group</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>resource-groups:CreateGroup</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>iam:PassRole</code> on the role provided in the request </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ResourceGroupsClient, StartTagSyncTaskCommand } from "@aws-sdk/client-resource-groups"; // ES Modules import
+ * // const { ResourceGroupsClient, StartTagSyncTaskCommand } = require("@aws-sdk/client-resource-groups"); // CommonJS import
+ * const client = new ResourceGroupsClient(config);
+ * const input = { // StartTagSyncTaskInput
+ *   Group: "STRING_VALUE", // required
+ *   TagKey: "STRING_VALUE", // required
+ *   TagValue: "STRING_VALUE", // required
+ *   RoleArn: "STRING_VALUE", // required
+ * };
+ * const command = new StartTagSyncTaskCommand(input);
+ * const response = await client.send(command);
+ * // { // StartTagSyncTaskOutput
+ * //   GroupArn: "STRING_VALUE",
+ * //   GroupName: "STRING_VALUE",
+ * //   TaskArn: "STRING_VALUE",
+ * //   TagKey: "STRING_VALUE",
+ * //   TagValue: "STRING_VALUE",
+ * //   RoleArn: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param StartTagSyncTaskCommandInput - {@link StartTagSyncTaskCommandInput}
+ * @returns {@link StartTagSyncTaskCommandOutput}
+ * @see {@link StartTagSyncTaskCommandInput} for command's `input` shape.
+ * @see {@link StartTagSyncTaskCommandOutput} for command's `response` shape.
+ * @see {@link ResourceGroupsClientResolvedConfig | config} for ResourceGroupsClient's `config` shape.
+ *
+ * @throws {@link BadRequestException} (client fault)
+ *  <p>The request includes one or more parameters that violate validation rules.</p>
+ *
+ * @throws {@link ForbiddenException} (client fault)
+ *  <p>The caller isn't authorized to make the request. Check permissions.</p>
+ *
+ * @throws {@link InternalServerErrorException} (server fault)
+ *  <p>An internal error occurred while processing the request. Try again later.</p>
+ *
+ * @throws {@link MethodNotAllowedException} (client fault)
+ *  <p>The request uses an HTTP method that isn't allowed for the specified resource.</p>
+ *
+ * @throws {@link NotFoundException} (client fault)
+ *  <p>One or more of the specified resources don't exist.</p>
+ *
+ * @throws {@link TooManyRequestsException} (client fault)
+ *  <p>You've exceeded throttling limits by making too many requests in a period of
+ *             time.</p>
+ *
+ * @throws {@link UnauthorizedException} (client fault)
+ *  <p>The request was rejected because it doesn't have valid credentials for the target
+ *             resource.</p>
+ *
+ * @throws {@link ResourceGroupsServiceException}
+ * <p>Base exception class for all service exceptions from ResourceGroups service.</p>
+ *
+ * @public
+ */
+export declare class StartTagSyncTaskCommand extends StartTagSyncTaskCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: StartTagSyncTaskInput;
+            output: StartTagSyncTaskOutput;
+        };
+        sdk: {
+            input: StartTagSyncTaskCommandInput;
+            output: StartTagSyncTaskCommandOutput;
+        };
+    };
+}

package/dist-types/commands/TagCommand.d.ts

@@ -27,7 +27,7 @@ declare const TagCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Adds tags to a resource group with the specified ARN. Existing tags on a resource
+ * <p>Adds tags to a resource group with the specified Amazon resource name (ARN). Existing tags on a resource
  *             group are not changed if they are not specified in the request parameters.</p>
  *          <important>
  *             <p>Do not store personally identifiable information (PII) or other confidential or

package/dist-types/commands/UpdateGroupCommand.d.ts

@@ -50,6 +50,9 @@ declare const UpdateGroupCommand_base: {
  *   GroupName: "STRING_VALUE",
  *   Group: "STRING_VALUE",
  *   Description: "STRING_VALUE",
+ *   Criticality: Number("int"),
+ *   Owner: "STRING_VALUE",
+ *   DisplayName: "STRING_VALUE",
  * };
  * const command = new UpdateGroupCommand(input);
  * const response = await client.send(command);
@@ -58,6 +61,12 @@ declare const UpdateGroupCommand_base: {
  * //     GroupArn: "STRING_VALUE", // required
  * //     Name: "STRING_VALUE", // required
  * //     Description: "STRING_VALUE",
+ * //     Criticality: Number("int"),
+ * //     Owner: "STRING_VALUE",
+ * //     DisplayName: "STRING_VALUE",
+ * //     ApplicationTag: { // ApplicationTag
+ * //       "<keys>": "STRING_VALUE",
+ * //     },
  * //   },
  * // };
  *

package/dist-types/commands/index.d.ts

@@ -1,15 +1,20 @@
+export * from "./CancelTagSyncTaskCommand";
 export * from "./CreateGroupCommand";
 export * from "./DeleteGroupCommand";
 export * from "./GetAccountSettingsCommand";
 export * from "./GetGroupCommand";
 export * from "./GetGroupConfigurationCommand";
 export * from "./GetGroupQueryCommand";
+export * from "./GetTagSyncTaskCommand";
 export * from "./GetTagsCommand";
 export * from "./GroupResourcesCommand";
 export * from "./ListGroupResourcesCommand";
+export * from "./ListGroupingStatusesCommand";
 export * from "./ListGroupsCommand";
+export * from "./ListTagSyncTasksCommand";
 export * from "./PutGroupConfigurationCommand";
 export * from "./SearchResourcesCommand";
+export * from "./StartTagSyncTaskCommand";
 export * from "./TagCommand";
 export * from "./UngroupResourcesCommand";
 export * from "./UntagCommand";

package/dist-types/index.d.ts

@@ -23,7 +23,7 @@
  *                <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>