AWS::ResourceGroups::Group - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::ResourceGroups::Group

创建具有指定名称和说明的资源组。您可以选择包括资源查询或服务配置。

最小权限

要运行此命令,您必须具有以下权限:

  • resourcegroups:CreateGroup

相关操作

  • 要删除组,请使用 DeleteGroup。

  • 要检索有关组的详细信息,请使用 GetGroup。

  • 要检索附加到组的配置,请使用 GetGroupConfiguration。

  • 要向组中添加各个资源,请使用 GroupResources。

  • 要检索与组关联的查询,请使用 GetGroupQuery。

  • 要列出属于组成员的资源,请使用 ListGroupResources。

  • 要列出您的组,请使用 ListGroups。

  • 要从组中删除单个资源,请使用 UngroupResources。

  • 要修改组,请使用 UpdateGroup。

  • 要修改附加到组的查询,请使用 UpdateGroupQuery。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::ResourceGroups::Group", "Properties" : { "Description" : String, "Name" : String, "ResourceQuery" : ResourceQuery, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::ResourceGroups::Group Properties: Description: String Name: String ResourceQuery: ResourceQuery Tags: - Tag

属性

Description

资源组的描述。

必需:否

类型:字符串

Update requires: No interruption

Name

资源组的名称。指定在区域中唯一的名称。要基于同一 CloudFormation 堆栈创建多个资源组,请为每个资源组使用唯一的名称。

必需:是

类型:字符串

Update requires: Replacement

ResourceQuery

确定哪些 AWS 资源是关联资源组成员的资源查询。

必需:否

类型ResourceQuery

Update requires: No interruption

Tags

与指定资源组关联的标签。

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

资源组的名称。

Fn::GetAtt

Arn

资源组的 ARN。

示例

使用默认值创建基于 CloudFormation 堆栈的组

此示例使用默认值创建一个基于 CloudFormation 堆栈的组。它包含所有支持的资源类型,并使用与定义组的 CloudFormation 堆栈相同的 StackIdentifier

JSON

{ "ResourceGroup": { "Type": "AWS::ResourceGroups::Group", "Properties": { "Name": "MyResourceGroup" } } }

YAML

ResourceGroup: Type: "AWS::ResourceGroups::Group" Properties: Name: "MyMinimalResourceGroup"

创建包含特定资源的基于 CloudFormation 堆栈的组

此示例创建了一个基于 CloudFormation 堆栈的组,该组类似于上一个示例中显示的组。不同之处在于它只包括特定的资源类型:EC2 实例和 DynamoDB 表。

JSON

{ "CloudFormationStackGroupForSelectedResourceTypes": { "Type": "AWS::ResourceGroups::Group", "Properties": { "Name": "MyCloudFormationResourceGroup-Filters", "ResourceQuery": { "Query": { "ResourceTypeFilters": [ "AWS::EC2::Instance", "AWS::DynamoDB::Table" ] } } } } }

YAML

CloudFormationStackGroupForSelectedResourceTypes: Type: "AWS::ResourceGroups::Group" Properties: Name: "MyCloudFormationResourceGroup-Filters" ResourceQuery: Query: ResourceTypeFilters: - "AWS::EC2::Instance" - "AWS::DynamoDB::Table"

基于其他堆栈创建基于 CloudFormation 堆栈的组

此示例创建一个从其他堆栈构建的组。StackIdentifier 值指定组中包含 arn:aws:cloudformation:us-east-1:0123456789:stack/stack-name/9b6f8604-4a39-490c-870b-44b0ebdd38b9 堆栈中的资源。使用 TagKey=TagValue. 标记组

JSON

{ "CloudFormationStackGroupForAnotherStack": { "Type": "AWS::ResourceGroups::Group", "Properties": { "Name": "MyCloudFormationResourceGroupForAnotherStack", "Description": "A group that is created via CFN", "ResourceQuery": { "Type": "CLOUDFORMATION_STACK_1_0", "Query": { "ResourceTypeFilters": [ "AWS::AllSupported" ], "StackIdentifier": "arn:aws:cloudformation:us-east-1:0123456789:stack/stack-name/9b6f8604-4a39-490c-870b-44b0ebdd38b9" } }, "Tags": [ { "Key": "TagKey", "Value": "TagValue" } ] } } }

YAML

CloudFormationStackGroupForAnotherStack: Type: "AWS::ResourceGroups::Group" Properties: Name: "MyCloudFormationResourceGroupForAnotherStack" Description: "A group that is created via CFN" ResourceQuery: Type: "CLOUDFORMATION_STACK_1_0" Query: ResourceTypeFilters: - "AWS::AllSupported" StackIdentifier: "arn:aws:cloudformation:us-east-1:0123456789:stack/stack-name/9b6f8604-4a39-490c-870b-44b0ebdd38b9" Tags: - Key: "TagKey" Value: "TagValue"

创建基于标签的组

此示例演示如何基于标签创建组。使用值为 Integration TestsUsage 键标记的所有资源将成为此组的成员。

JSON

{ "TagBasedGroup": { "Type": "AWS::ResourceGroups::Group", "Properties": { "Name": "MyTagBasedResourceGroup", "Description": "A group that is created via CFN", "ResourceQuery": { "Type": "TAG_FILTERS_1_0", "Query": { "ResourceTypeFilters": [ "AWS::AllSupported" ], "TagFilters": [ { "Key": "Usage", "Values": [ "Integration Tests" ] } ] } } } } }

YAML

TagBasedGroup: Type: "AWS::ResourceGroups::Group" Properties: Name: "MyTagBasedResourceGroup" Description: "A group that is created via CFN" ResourceQuery: Type: "TAG_FILTERS_1_0" Query: ResourceTypeFilters: - "AWS::AllSupported" TagFilters: - Key: "Usage" Values: - "Integration Tests"