Creating query-based groups in Amazon Resource Groups

Tag-based queries include lists of resource types that are specified in the following format AWS::service::resource, and tags. Tags are keys that help identify and sort your resources in your organization. Optionally, tags include values for keys.

For a tag-based query, you also specify the tags that are shared by the resources that you want to be members of the group. For example, if you want to create a resource group that has all of the Amazon EC2 instances and Amazon S3 buckets that you are using to run the testing stage of an application, and you have instances and buckets that are tagged this way, choose the AWS::EC2::Instance and AWS::S3::Bucket resource types from the drop-down list, and then specify the tag key Stage, with a tag value of Test.

The syntax of the ResourceQuery parameter of a tag-based resource group contains the following elements:

All of these JSON elements must be combined into a single-line string representation of the JSON structure. For example, consider a Query with the following example JSON structure. This query is meant to match only Amazon EC2 instances that have a tag "Stage" with a value "Test".

{
    "ResourceTypeFilters": [ "AWS::EC2::Instance" ],
    "TagFilters": [
        {
            "Key": "Stage",
            "Values": [ "Test" ]
        }
    ]
}

That JSON can be represented as the following single-line string, and used as the value of the Query element. Because the value of a JSON structure must be a double-quoted string, you must escape any embedded double-quote characters or forward slash characters by preceding each with a backslash as shown here:

"Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"

The complete ResourceQuery string is then represented as shown here, as a CLI command parameter:

--resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

In an Amazon CloudFormation stack-based query, you choose an Amazon CloudFormation stack in your account in the current region, and then choose resource types in the stack that you want to be in the group. You can base your query on only one Amazon CloudFormation stack.

Resource Groups supports queries based on Amazon CloudFormation stacks that have one of the following statuses.

If you create a group based on an Amazon CloudFormation stack, and the stack's status changes to one that is no longer supported as a basis for a group query, such as DELETE_COMPLETE, the resource group still exists, but it has no member resources.