创建基于 CloudFormation 堆栈的群组

以下过程说明了如何构建基于堆栈的查询和使用此查询创建资源组。

Console

1. 登录 AWS Resource Groups 控制台。

2. 在导航窗格中，选择创建资源组。

3. 在创建基于查询的群组中，在群组类型下，选择基于CloudFormation 堆栈的群组类型。

4. 选择要作为组基础的堆栈。只能将资源组基于一个堆栈。要筛选堆栈列表，请开始键入堆栈的名称。仅在列表中显示具有支持的状态的堆栈。

5. 在堆栈中选择要包含在组中的资源类型。对于本演练，请保留默认值所有受支持的资源类型。有关可以包含在组中的受支持资源类型的更多信息，请参阅可以与标签编辑器一起 AWS Resource Groups 使用的资源类型。

6. 选择查看组资源以返回 CloudFormation 堆栈中与所选资源类型相匹配的资源列表。

7. 获得所需的结果后，根据此查询创建一个组。

   1. 在组详细信息下， 对于组名称，为您的资源组键入一个名称。

      资源组名称最多可以包含 128 个字符，包括字母、数字、连字符、句点和下划线。名称不能以 AWS 或 aws 开头。这些名称是预留的。资源组名称在您账户的当前区域中必须是唯一的。

   2. （可选）在组描述中，输入您的组的描述。

   3. （可选）在组标签中，添加仅适用于资源组（而不适用于组中的成员资源）的标签键和值对。

      如果计划将此组作为较大组的成员，则组标签非常有用。由于需要指定至少一个标签键以创建组，因此，请务必将组标签中的至少一个标签键添加到打算嵌套到更大组的组中。

8. 在完成后，选择创建组。

AWS CLI & AWS SDKs

CloudFormation 基于堆栈的组基于类型的查询。CLOUDFORMATION_STACK_1_0

1. 运行以下命令，将组名称、描述、堆栈标识符和资源类型的值替换为您自己的值。描述最多可以包含 512 个字符，包括字母、数字、连字符、下划线、标点符号和空格。

   如果未指定资源类型，则 Resource Groups 包含堆栈中的所有支持的资源类型。您最多可以在查询中包含 20 种资源类型。资源组名称最多可以包含 128 个字符，包括字母、数字、连字符、句点和下划线。名称不能以 AWS 或 aws 开头。这些名称是预留的。资源组名称在您的账户中必须是唯一的。

   stack_identifier是堆栈 ARN，如示例命令所示。

   $ aws resource-groups create-group \
       --name group_name \
       --description "description" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'

   以下命令是一个示例。

   $ aws resource-groups create-group \
       --name My-CFN-stack-group \
       --description "My first CloudFormation stack-based group" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'

2. 在对命令的响应中返回以下内容。

   • 您创建的组的完整描述。

   • 您用于创建组的资源查询。