AWS::Synthetics::Group - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Creates or updates 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.

Groups are global resources. When you create a group, it is replicated across all Amazon Regions, and you can add canaries from any Region to it, and view it in 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.

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.


To declare this entity in your Amazon CloudFormation template, use the following syntax:


{ "Type" : "AWS::Synthetics::Group", "Properties" : { "Name" : String, "ResourceArns" : [ String, ... ], "Tags" : [ Tag, ... ] } }


Type: AWS::Synthetics::Group Properties: Name: String ResourceArns: - String Tags: - Tag



A name for the group. It can include any Unicode characters.

The names for all groups in your account, across all Regions, must be unique.

Required: Yes

Type: String

Pattern: ^[0-9a-z_\-]{1,64}$

Update requires: Replacement


The ARNs of the canaries that you want to associate with this group.

Required: No

Type: Array of String

Maximum: 10

Update requires: No interruption


The list of key-value pairs that are associated with the group.

Required: No

Type: Array of Tag

Minimum: 0

Update requires: No interruption

Return values


When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the name of the group.


The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.


The Id of the group.