@aws-sdk/client-synthetics 3.121.0 → 3.128.0

package/dist-types/Synthetics.d.ts

@@ -1,11 +1,19 @@
 import { HttpHandlerOptions as __HttpHandlerOptions } from "@aws-sdk/types";
+import { AssociateResourceCommandInput, AssociateResourceCommandOutput } from "./commands/AssociateResourceCommand";
 import { CreateCanaryCommandInput, CreateCanaryCommandOutput } from "./commands/CreateCanaryCommand";
+import { CreateGroupCommandInput, CreateGroupCommandOutput } from "./commands/CreateGroupCommand";
 import { DeleteCanaryCommandInput, DeleteCanaryCommandOutput } from "./commands/DeleteCanaryCommand";
+import { DeleteGroupCommandInput, DeleteGroupCommandOutput } from "./commands/DeleteGroupCommand";
 import { DescribeCanariesCommandInput, DescribeCanariesCommandOutput } from "./commands/DescribeCanariesCommand";
 import { DescribeCanariesLastRunCommandInput, DescribeCanariesLastRunCommandOutput } from "./commands/DescribeCanariesLastRunCommand";
 import { DescribeRuntimeVersionsCommandInput, DescribeRuntimeVersionsCommandOutput } from "./commands/DescribeRuntimeVersionsCommand";
+import { DisassociateResourceCommandInput, DisassociateResourceCommandOutput } from "./commands/DisassociateResourceCommand";
 import { GetCanaryCommandInput, GetCanaryCommandOutput } from "./commands/GetCanaryCommand";
 import { GetCanaryRunsCommandInput, GetCanaryRunsCommandOutput } from "./commands/GetCanaryRunsCommand";
+import { GetGroupCommandInput, GetGroupCommandOutput } from "./commands/GetGroupCommand";
+import { ListAssociatedGroupsCommandInput, ListAssociatedGroupsCommandOutput } from "./commands/ListAssociatedGroupsCommand";
+import { ListGroupResourcesCommandInput, ListGroupResourcesCommandOutput } from "./commands/ListGroupResourcesCommand";
+import { ListGroupsCommandInput, ListGroupsCommandOutput } from "./commands/ListGroupsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
 import { StartCanaryCommandInput, StartCanaryCommandOutput } from "./commands/StartCanaryCommand";
 import { StopCanaryCommandInput, StopCanaryCommandOutput } from "./commands/StopCanaryCommand";
@@ -32,6 +40,15 @@ import { SyntheticsClient } from "./SyntheticsClient";
  *             Considerations for Synthetics Canaries</a>.</p>
  */
 export declare class Synthetics extends SyntheticsClient {
+    /**
+     * <p>Associates a canary with a group. Using groups can help you with
+     *          managing and automating your canaries, and you can also view aggregated run results and statistics
+     *          for all canaries in a group. </p>
+     *          <p>You must run this operation in the Region where the canary exists.</p>
+     */
+    associateResource(args: AssociateResourceCommandInput, options?: __HttpHandlerOptions): Promise<AssociateResourceCommandOutput>;
+    associateResource(args: AssociateResourceCommandInput, cb: (err: any, data?: AssociateResourceCommandOutput) => void): void;
+    associateResource(args: AssociateResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: AssociateResourceCommandOutput) => void): void;
     /**
      * <p>Creates a canary. Canaries are scripts that monitor your endpoints and APIs from the
      *          outside-in. Canaries help you check the availability and latency of your web services and
@@ -40,7 +57,7 @@ export declare class Synthetics extends SyntheticsClient {
      *          <p>Do not use <code>CreateCanary</code> to modify an existing canary. Use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_UpdateCanary.html">UpdateCanary</a> instead.</p>
      *          <p>To create canaries, you must have the <code>CloudWatchSyntheticsFullAccess</code> policy.
      *          If you are creating a new IAM role for the canary, you also need the
-     *          the <code>iam:CreateRole</code>, <code>iam:CreatePolicy</code> and
+     *          <code>iam:CreateRole</code>, <code>iam:CreatePolicy</code> and
      *             <code>iam:AttachRolePolicy</code> permissions. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Roles">Necessary
      *             Roles and Permissions</a>.</p>
      *          <p>Do not include secrets or proprietary information in your canary names. The canary name
@@ -51,11 +68,29 @@ export declare class Synthetics extends SyntheticsClient {
     createCanary(args: CreateCanaryCommandInput, options?: __HttpHandlerOptions): Promise<CreateCanaryCommandOutput>;
     createCanary(args: CreateCanaryCommandInput, cb: (err: any, data?: CreateCanaryCommandOutput) => void): void;
     createCanary(args: CreateCanaryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateCanaryCommandOutput) => void): void;
+    /**
+     * <p>Creates a group which you can use to associate canaries with each other, including cross-Region
+     *          canaries. Using groups can help you with
+     *          managing and automating your canaries, and you can also view aggregated run results and statistics
+     *       for all canaries in a group. </p>
+     *          <p>Groups are global resources. When you create a group, it is replicated across Amazon Web Services Regions, and
+     *          you can view it and add canaries to it from any Region.
+     *          Although the group ARN format reflects the Region name where it was created, a group is not constrained to any Region.
+     *          This means that you can put canaries from multiple Regions into the same group, and then use
+     *       that group to view and manage all of those canaries in a single view.</p>
+     *          <p>Groups are supported in all Regions except the Regions that are disabled by default. For more information
+     *          about these Regions, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable">Enabling a Region</a>.</p>
+     *          <p>Each group can contain as many as 10 canaries. You can have as many as 20 groups in your account. Any single canary
+     *       can be a member of up to 10 groups.</p>
+     */
+    createGroup(args: CreateGroupCommandInput, options?: __HttpHandlerOptions): Promise<CreateGroupCommandOutput>;
+    createGroup(args: CreateGroupCommandInput, cb: (err: any, data?: CreateGroupCommandOutput) => void): void;
+    createGroup(args: CreateGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateGroupCommandOutput) => void): void;
     /**
      * <p>Permanently deletes the specified canary.</p>
      *          <p>If you specify <code>DeleteLambda</code> to <code>true</code>, CloudWatch Synthetics also deletes
      *          the Lambda functions and layers that are used by the canary.</p>
-     *          <p>Other esources used and created by the canary are not automatically deleted.
+     *          <p>Other resources used and created by the canary are not automatically deleted.
      *          After you delete a canary that you do not intend to
      *          use again, you
      *       should also delete the following:</p>
@@ -89,6 +124,16 @@ export declare class Synthetics extends SyntheticsClient {
     deleteCanary(args: DeleteCanaryCommandInput, options?: __HttpHandlerOptions): Promise<DeleteCanaryCommandOutput>;
     deleteCanary(args: DeleteCanaryCommandInput, cb: (err: any, data?: DeleteCanaryCommandOutput) => void): void;
     deleteCanary(args: DeleteCanaryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteCanaryCommandOutput) => void): void;
+    /**
+     * <p>Deletes a group. The group doesn't need to be empty to be deleted. If there are canaries in the group,
+     *          they are not deleted when you delete the group.
+     *       </p>
+     *          <p>Groups are a global resource that appear in all Regions, but the request to delete a group
+     *       must be made from its home Region. You can find the home Region of a group within its ARN.</p>
+     */
+    deleteGroup(args: DeleteGroupCommandInput, options?: __HttpHandlerOptions): Promise<DeleteGroupCommandOutput>;
+    deleteGroup(args: DeleteGroupCommandInput, cb: (err: any, data?: DeleteGroupCommandOutput) => void): void;
+    deleteGroup(args: DeleteGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteGroupCommandOutput) => void): void;
     /**
      * <p>This operation returns a list of the canaries in your account, along with full details
      *       about each canary.</p>
@@ -127,6 +172,12 @@ export declare class Synthetics extends SyntheticsClient {
     describeRuntimeVersions(args: DescribeRuntimeVersionsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeRuntimeVersionsCommandOutput>;
     describeRuntimeVersions(args: DescribeRuntimeVersionsCommandInput, cb: (err: any, data?: DescribeRuntimeVersionsCommandOutput) => void): void;
     describeRuntimeVersions(args: DescribeRuntimeVersionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeRuntimeVersionsCommandOutput) => void): void;
+    /**
+     * <p>Removes a canary from a group. You must run this operation in the Region where the canary exists.</p>
+     */
+    disassociateResource(args: DisassociateResourceCommandInput, options?: __HttpHandlerOptions): Promise<DisassociateResourceCommandOutput>;
+    disassociateResource(args: DisassociateResourceCommandInput, cb: (err: any, data?: DisassociateResourceCommandOutput) => void): void;
+    disassociateResource(args: DisassociateResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DisassociateResourceCommandOutput) => void): void;
     /**
      * <p>Retrieves complete information about one canary. You must specify
      *       the name of the canary that you want. To get a list of canaries
@@ -142,7 +193,34 @@ export declare class Synthetics extends SyntheticsClient {
     getCanaryRuns(args: GetCanaryRunsCommandInput, cb: (err: any, data?: GetCanaryRunsCommandOutput) => void): void;
     getCanaryRuns(args: GetCanaryRunsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetCanaryRunsCommandOutput) => void): void;
     /**
-     * <p>Displays the tags associated with a canary.</p>
+     * <p>Returns information about one group. Groups are a global resource, so you can use this operation from
+     *       any Region.</p>
+     */
+    getGroup(args: GetGroupCommandInput, options?: __HttpHandlerOptions): Promise<GetGroupCommandOutput>;
+    getGroup(args: GetGroupCommandInput, cb: (err: any, data?: GetGroupCommandOutput) => void): void;
+    getGroup(args: GetGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetGroupCommandOutput) => void): void;
+    /**
+     * <p>Returns a list of the groups that the specified canary is associated with. The canary
+     *       that you specify must be in the current Region.</p>
+     */
+    listAssociatedGroups(args: ListAssociatedGroupsCommandInput, options?: __HttpHandlerOptions): Promise<ListAssociatedGroupsCommandOutput>;
+    listAssociatedGroups(args: ListAssociatedGroupsCommandInput, cb: (err: any, data?: ListAssociatedGroupsCommandOutput) => void): void;
+    listAssociatedGroups(args: ListAssociatedGroupsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListAssociatedGroupsCommandOutput) => void): void;
+    /**
+     * <p>This operation returns a list of the ARNs of the canaries that are associated with the specified group.</p>
+     */
+    listGroupResources(args: ListGroupResourcesCommandInput, options?: __HttpHandlerOptions): Promise<ListGroupResourcesCommandOutput>;
+    listGroupResources(args: ListGroupResourcesCommandInput, cb: (err: any, data?: ListGroupResourcesCommandOutput) => void): void;
+    listGroupResources(args: ListGroupResourcesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListGroupResourcesCommandOutput) => void): void;
+    /**
+     * <p>Returns a list of all groups in the account, displaying their names, unique IDs, and ARNs. The groups
+     *       from all Regions are returned.</p>
+     */
+    listGroups(args: ListGroupsCommandInput, options?: __HttpHandlerOptions): Promise<ListGroupsCommandOutput>;
+    listGroups(args: ListGroupsCommandInput, cb: (err: any, data?: ListGroupsCommandOutput) => void): void;
+    listGroups(args: ListGroupsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListGroupsCommandOutput) => void): void;
+    /**
+     * <p>Displays the tags associated with a canary or group.</p>
      */
     listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
     listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
@@ -156,8 +234,7 @@ export declare class Synthetics extends SyntheticsClient {
     startCanary(args: StartCanaryCommandInput, cb: (err: any, data?: StartCanaryCommandOutput) => void): void;
     startCanary(args: StartCanaryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StartCanaryCommandOutput) => void): void;
     /**
-     * <p>Stops the canary to prevent all future runs. If the canary is currently running,
-     *          Synthetics stops waiting for the current run of the specified canary to complete. The
+     * <p>Stops the canary to prevent all future runs. If the canary is currently running,the
      *         run that is in progress completes on its own, publishes metrics, and uploads artifacts, but
      *          it is not recorded in Synthetics as a completed run.</p>
      *          <p>You can use <code>StartCanary</code> to start it running again
@@ -167,28 +244,30 @@ export declare class Synthetics extends SyntheticsClient {
     stopCanary(args: StopCanaryCommandInput, cb: (err: any, data?: StopCanaryCommandOutput) => void): void;
     stopCanary(args: StopCanaryCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopCanaryCommandOutput) => void): void;
     /**
-     * <p>Assigns one or more tags (key-value pairs) to the specified canary. </p>
+     * <p>Assigns one or more tags (key-value pairs) to the specified canary or group. </p>
      *          <p>Tags can help you organize and categorize your
      *          resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with
      *          certain tag values.</p>
      *          <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
-     *          <p>You can use the <code>TagResource</code> action with a canary that already has tags. If you specify a new tag key for the alarm,
+     *          <p>You can use the <code>TagResource</code> action with a resource that already has tags. If you specify a new
+     *          tag key for the resource,
      *          this tag is appended to the list of tags associated
-     *          with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces
+     *          with the resource. If you specify a tag key that is already associated with the resource, the new tag
+     *          value that you specify replaces
      *          the previous value for that tag.</p>
-     *          <p>You can associate as many as 50 tags with a canary.</p>
+     *          <p>You can associate as many as 50 tags with a canary or group.</p>
      */
     tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
     tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     /**
-     * <p>Removes one or more tags from the specified canary.</p>
+     * <p>Removes one or more tags from the specified resource.</p>
      */
     untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
     untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     /**
-     * <p>Use this operation to change the settings of a canary that has
+     * <p>Updates the configuration of a canary that has
      *          already been created.</p>
      *          <p>You can't use this operation to update the tags of an existing canary. To
      *          change the tags of an existing canary, use

package/dist-types/SyntheticsClient.d.ts

@@ -6,21 +6,29 @@ import { UserAgentInputConfig, UserAgentResolvedConfig } from "@aws-sdk/middlewa
 import { HttpHandler as __HttpHandler } from "@aws-sdk/protocol-http";
 import { Client as __Client, DefaultsMode, SmithyConfiguration as __SmithyConfiguration, SmithyResolvedConfiguration as __SmithyResolvedConfiguration } from "@aws-sdk/smithy-client";
 import { BodyLengthCalculator as __BodyLengthCalculator, Credentials as __Credentials, Decoder as __Decoder, Encoder as __Encoder, HashConstructor as __HashConstructor, HttpHandlerOptions as __HttpHandlerOptions, Logger as __Logger, Provider as __Provider, Provider, RegionInfoProvider, StreamCollector as __StreamCollector, UrlParser as __UrlParser, UserAgent as __UserAgent } from "@aws-sdk/types";
+import { AssociateResourceCommandInput, AssociateResourceCommandOutput } from "./commands/AssociateResourceCommand";
 import { CreateCanaryCommandInput, CreateCanaryCommandOutput } from "./commands/CreateCanaryCommand";
+import { CreateGroupCommandInput, CreateGroupCommandOutput } from "./commands/CreateGroupCommand";
 import { DeleteCanaryCommandInput, DeleteCanaryCommandOutput } from "./commands/DeleteCanaryCommand";
+import { DeleteGroupCommandInput, DeleteGroupCommandOutput } from "./commands/DeleteGroupCommand";
 import { DescribeCanariesCommandInput, DescribeCanariesCommandOutput } from "./commands/DescribeCanariesCommand";
 import { DescribeCanariesLastRunCommandInput, DescribeCanariesLastRunCommandOutput } from "./commands/DescribeCanariesLastRunCommand";
 import { DescribeRuntimeVersionsCommandInput, DescribeRuntimeVersionsCommandOutput } from "./commands/DescribeRuntimeVersionsCommand";
+import { DisassociateResourceCommandInput, DisassociateResourceCommandOutput } from "./commands/DisassociateResourceCommand";
 import { GetCanaryCommandInput, GetCanaryCommandOutput } from "./commands/GetCanaryCommand";
 import { GetCanaryRunsCommandInput, GetCanaryRunsCommandOutput } from "./commands/GetCanaryRunsCommand";
+import { GetGroupCommandInput, GetGroupCommandOutput } from "./commands/GetGroupCommand";
+import { ListAssociatedGroupsCommandInput, ListAssociatedGroupsCommandOutput } from "./commands/ListAssociatedGroupsCommand";
+import { ListGroupResourcesCommandInput, ListGroupResourcesCommandOutput } from "./commands/ListGroupResourcesCommand";
+import { ListGroupsCommandInput, ListGroupsCommandOutput } from "./commands/ListGroupsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
 import { StartCanaryCommandInput, StartCanaryCommandOutput } from "./commands/StartCanaryCommand";
 import { StopCanaryCommandInput, StopCanaryCommandOutput } from "./commands/StopCanaryCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { UpdateCanaryCommandInput, UpdateCanaryCommandOutput } from "./commands/UpdateCanaryCommand";
-export declare type ServiceInputTypes = CreateCanaryCommandInput | DeleteCanaryCommandInput | DescribeCanariesCommandInput | DescribeCanariesLastRunCommandInput | DescribeRuntimeVersionsCommandInput | GetCanaryCommandInput | GetCanaryRunsCommandInput | ListTagsForResourceCommandInput | StartCanaryCommandInput | StopCanaryCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateCanaryCommandInput;
-export declare type ServiceOutputTypes = CreateCanaryCommandOutput | DeleteCanaryCommandOutput | DescribeCanariesCommandOutput | DescribeCanariesLastRunCommandOutput | DescribeRuntimeVersionsCommandOutput | GetCanaryCommandOutput | GetCanaryRunsCommandOutput | ListTagsForResourceCommandOutput | StartCanaryCommandOutput | StopCanaryCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateCanaryCommandOutput;
+export declare type ServiceInputTypes = AssociateResourceCommandInput | CreateCanaryCommandInput | CreateGroupCommandInput | DeleteCanaryCommandInput | DeleteGroupCommandInput | DescribeCanariesCommandInput | DescribeCanariesLastRunCommandInput | DescribeRuntimeVersionsCommandInput | DisassociateResourceCommandInput | GetCanaryCommandInput | GetCanaryRunsCommandInput | GetGroupCommandInput | ListAssociatedGroupsCommandInput | ListGroupResourcesCommandInput | ListGroupsCommandInput | ListTagsForResourceCommandInput | StartCanaryCommandInput | StopCanaryCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateCanaryCommandInput;
+export declare type ServiceOutputTypes = AssociateResourceCommandOutput | CreateCanaryCommandOutput | CreateGroupCommandOutput | DeleteCanaryCommandOutput | DeleteGroupCommandOutput | DescribeCanariesCommandOutput | DescribeCanariesLastRunCommandOutput | DescribeRuntimeVersionsCommandOutput | DisassociateResourceCommandOutput | GetCanaryCommandOutput | GetCanaryRunsCommandOutput | GetGroupCommandOutput | ListAssociatedGroupsCommandOutput | ListGroupResourcesCommandOutput | ListGroupsCommandOutput | ListTagsForResourceCommandOutput | StartCanaryCommandOutput | StopCanaryCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateCanaryCommandOutput;
 export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
     /**
      * The HTTP handler to use. Fetch in browser and Https in Nodejs.

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

@@ -0,0 +1,38 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { AssociateResourceRequest, AssociateResourceResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface AssociateResourceCommandInput extends AssociateResourceRequest {
+}
+export interface AssociateResourceCommandOutput extends AssociateResourceResponse, __MetadataBearer {
+}
+/**
+ * <p>Associates a canary with a group. Using groups can help you with
+ *          managing and automating your canaries, and you can also view aggregated run results and statistics
+ *          for all canaries in a group. </p>
+ *          <p>You must run this operation in the Region where the canary exists.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, AssociateResourceCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, AssociateResourceCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new AssociateResourceCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link AssociateResourceCommandInput} for command's `input` shape.
+ * @see {@link AssociateResourceCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class AssociateResourceCommand extends $Command<AssociateResourceCommandInput, AssociateResourceCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: AssociateResourceCommandInput;
+    constructor(input: AssociateResourceCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<AssociateResourceCommandInput, AssociateResourceCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -14,7 +14,7 @@ export interface CreateCanaryCommandOutput extends CreateCanaryResponse, __Metad
  *          <p>Do not use <code>CreateCanary</code> to modify an existing canary. Use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_UpdateCanary.html">UpdateCanary</a> instead.</p>
  *          <p>To create canaries, you must have the <code>CloudWatchSyntheticsFullAccess</code> policy.
  *          If you are creating a new IAM role for the canary, you also need the
- *          the <code>iam:CreateRole</code>, <code>iam:CreatePolicy</code> and
+ *          <code>iam:CreateRole</code>, <code>iam:CreatePolicy</code> and
  *             <code>iam:AttachRolePolicy</code> permissions. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Roles">Necessary
  *             Roles and Permissions</a>.</p>
  *          <p>Do not include secrets or proprietary information in your canary names. The canary name

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

@@ -0,0 +1,47 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { CreateGroupRequest, CreateGroupResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface CreateGroupCommandInput extends CreateGroupRequest {
+}
+export interface CreateGroupCommandOutput extends CreateGroupResponse, __MetadataBearer {
+}
+/**
+ * <p>Creates a group which you can use to associate canaries with each other, including cross-Region
+ *          canaries. Using groups can help you with
+ *          managing and automating your canaries, and you can also view aggregated run results and statistics
+ *       for all canaries in a group. </p>
+ *          <p>Groups are global resources. When you create a group, it is replicated across Amazon Web Services Regions, and
+ *          you can view it and add canaries to it from any Region.
+ *          Although the group ARN format reflects the Region name where it was created, a group is not constrained to any Region.
+ *          This means that you can put canaries from multiple Regions into the same group, and then use
+ *       that group to view and manage all of those canaries in a single view.</p>
+ *          <p>Groups are supported in all Regions except the Regions that are disabled by default. For more information
+ *          about these Regions, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable">Enabling a Region</a>.</p>
+ *          <p>Each group can contain as many as 10 canaries. You can have as many as 20 groups in your account. Any single canary
+ *       can be a member of up to 10 groups.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, CreateGroupCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, CreateGroupCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new CreateGroupCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link CreateGroupCommandInput} for command's `input` shape.
+ * @see {@link CreateGroupCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class CreateGroupCommand extends $Command<CreateGroupCommandInput, CreateGroupCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: CreateGroupCommandInput;
+    constructor(input: CreateGroupCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreateGroupCommandInput, CreateGroupCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -10,7 +10,7 @@ export interface DeleteCanaryCommandOutput extends DeleteCanaryResponse, __Metad
  * <p>Permanently deletes the specified canary.</p>
  *          <p>If you specify <code>DeleteLambda</code> to <code>true</code>, CloudWatch Synthetics also deletes
  *          the Lambda functions and layers that are used by the canary.</p>
- *          <p>Other esources used and created by the canary are not automatically deleted.
+ *          <p>Other resources used and created by the canary are not automatically deleted.
  *          After you delete a canary that you do not intend to
  *          use again, you
  *       should also delete the following:</p>

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

@@ -0,0 +1,39 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { DeleteGroupRequest, DeleteGroupResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface DeleteGroupCommandInput extends DeleteGroupRequest {
+}
+export interface DeleteGroupCommandOutput extends DeleteGroupResponse, __MetadataBearer {
+}
+/**
+ * <p>Deletes a group. The group doesn't need to be empty to be deleted. If there are canaries in the group,
+ *          they are not deleted when you delete the group.
+ *       </p>
+ *          <p>Groups are a global resource that appear in all Regions, but the request to delete a group
+ *       must be made from its home Region. You can find the home Region of a group within its ARN.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, DeleteGroupCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, DeleteGroupCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new DeleteGroupCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link DeleteGroupCommandInput} for command's `input` shape.
+ * @see {@link DeleteGroupCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class DeleteGroupCommand extends $Command<DeleteGroupCommandInput, DeleteGroupCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: DeleteGroupCommandInput;
+    constructor(input: DeleteGroupCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteGroupCommandInput, DeleteGroupCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -0,0 +1,35 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { DisassociateResourceRequest, DisassociateResourceResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface DisassociateResourceCommandInput extends DisassociateResourceRequest {
+}
+export interface DisassociateResourceCommandOutput extends DisassociateResourceResponse, __MetadataBearer {
+}
+/**
+ * <p>Removes a canary from a group. You must run this operation in the Region where the canary exists.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, DisassociateResourceCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, DisassociateResourceCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new DisassociateResourceCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link DisassociateResourceCommandInput} for command's `input` shape.
+ * @see {@link DisassociateResourceCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class DisassociateResourceCommand extends $Command<DisassociateResourceCommandInput, DisassociateResourceCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: DisassociateResourceCommandInput;
+    constructor(input: DisassociateResourceCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DisassociateResourceCommandInput, DisassociateResourceCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -0,0 +1,36 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { GetGroupRequest, GetGroupResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface GetGroupCommandInput extends GetGroupRequest {
+}
+export interface GetGroupCommandOutput extends GetGroupResponse, __MetadataBearer {
+}
+/**
+ * <p>Returns information about one group. Groups are a global resource, so you can use this operation from
+ *       any Region.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, GetGroupCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, GetGroupCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new GetGroupCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link GetGroupCommandInput} for command's `input` shape.
+ * @see {@link GetGroupCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class GetGroupCommand extends $Command<GetGroupCommandInput, GetGroupCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: GetGroupCommandInput;
+    constructor(input: GetGroupCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetGroupCommandInput, GetGroupCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -0,0 +1,36 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { ListAssociatedGroupsRequest, ListAssociatedGroupsResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface ListAssociatedGroupsCommandInput extends ListAssociatedGroupsRequest {
+}
+export interface ListAssociatedGroupsCommandOutput extends ListAssociatedGroupsResponse, __MetadataBearer {
+}
+/**
+ * <p>Returns a list of the groups that the specified canary is associated with. The canary
+ *       that you specify must be in the current Region.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, ListAssociatedGroupsCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, ListAssociatedGroupsCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new ListAssociatedGroupsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListAssociatedGroupsCommandInput} for command's `input` shape.
+ * @see {@link ListAssociatedGroupsCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class ListAssociatedGroupsCommand extends $Command<ListAssociatedGroupsCommandInput, ListAssociatedGroupsCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: ListAssociatedGroupsCommandInput;
+    constructor(input: ListAssociatedGroupsCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListAssociatedGroupsCommandInput, ListAssociatedGroupsCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -0,0 +1,35 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { ListGroupResourcesRequest, ListGroupResourcesResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface ListGroupResourcesCommandInput extends ListGroupResourcesRequest {
+}
+export interface ListGroupResourcesCommandOutput extends ListGroupResourcesResponse, __MetadataBearer {
+}
+/**
+ * <p>This operation returns a list of the ARNs of the canaries that are associated with the specified group.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, ListGroupResourcesCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, ListGroupResourcesCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new ListGroupResourcesCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListGroupResourcesCommandInput} for command's `input` shape.
+ * @see {@link ListGroupResourcesCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class ListGroupResourcesCommand extends $Command<ListGroupResourcesCommandInput, ListGroupResourcesCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: ListGroupResourcesCommandInput;
+    constructor(input: ListGroupResourcesCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListGroupResourcesCommandInput, ListGroupResourcesCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -0,0 +1,36 @@
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { ListGroupsRequest, ListGroupsResponse } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SyntheticsClientResolvedConfig } from "../SyntheticsClient";
+export interface ListGroupsCommandInput extends ListGroupsRequest {
+}
+export interface ListGroupsCommandOutput extends ListGroupsResponse, __MetadataBearer {
+}
+/**
+ * <p>Returns a list of all groups in the account, displaying their names, unique IDs, and ARNs. The groups
+ *       from all Regions are returned.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SyntheticsClient, ListGroupsCommand } from "@aws-sdk/client-synthetics"; // ES Modules import
+ * // const { SyntheticsClient, ListGroupsCommand } = require("@aws-sdk/client-synthetics"); // CommonJS import
+ * const client = new SyntheticsClient(config);
+ * const command = new ListGroupsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListGroupsCommandInput} for command's `input` shape.
+ * @see {@link ListGroupsCommandOutput} for command's `response` shape.
+ * @see {@link SyntheticsClientResolvedConfig | config} for SyntheticsClient's `config` shape.
+ *
+ */
+export declare class ListGroupsCommand extends $Command<ListGroupsCommandInput, ListGroupsCommandOutput, SyntheticsClientResolvedConfig> {
+    readonly input: ListGroupsCommandInput;
+    constructor(input: ListGroupsCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SyntheticsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListGroupsCommandInput, ListGroupsCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -7,7 +7,7 @@ export interface ListTagsForResourceCommandInput extends ListTagsForResourceRequ
 export interface ListTagsForResourceCommandOutput extends ListTagsForResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Displays the tags associated with a canary.</p>
+ * <p>Displays the tags associated with a canary or group.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,8 +7,7 @@ export interface StopCanaryCommandInput extends StopCanaryRequest {
 export interface StopCanaryCommandOutput extends StopCanaryResponse, __MetadataBearer {
 }
 /**
- * <p>Stops the canary to prevent all future runs. If the canary is currently running,
- *          Synthetics stops waiting for the current run of the specified canary to complete. The
+ * <p>Stops the canary to prevent all future runs. If the canary is currently running,the
  *         run that is in progress completes on its own, publishes metrics, and uploads artifacts, but
  *          it is not recorded in Synthetics as a completed run.</p>
  *          <p>You can use <code>StartCanary</code> to start it running again

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

@@ -7,16 +7,18 @@ export interface TagResourceCommandInput extends TagResourceRequest {
 export interface TagResourceCommandOutput extends TagResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Assigns one or more tags (key-value pairs) to the specified canary. </p>
+ * <p>Assigns one or more tags (key-value pairs) to the specified canary or group. </p>
  *          <p>Tags can help you organize and categorize your
  *          resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with
  *          certain tag values.</p>
  *          <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
- *          <p>You can use the <code>TagResource</code> action with a canary that already has tags. If you specify a new tag key for the alarm,
+ *          <p>You can use the <code>TagResource</code> action with a resource that already has tags. If you specify a new
+ *          tag key for the resource,
  *          this tag is appended to the list of tags associated
- *          with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces
+ *          with the resource. If you specify a tag key that is already associated with the resource, the new tag
+ *          value that you specify replaces
  *          the previous value for that tag.</p>
- *          <p>You can associate as many as 50 tags with a canary.</p>
+ *          <p>You can associate as many as 50 tags with a canary or group.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,7 +7,7 @@ export interface UntagResourceCommandInput extends UntagResourceRequest {
 export interface UntagResourceCommandOutput extends UntagResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Removes one or more tags from the specified canary.</p>
+ * <p>Removes one or more tags from the specified resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript