AWS 文档 SDK 示例
将 CreateGroup 与 CLI 配合使用
以下代码示例演示如何使用 CreateGroup。
- CLI
-
- AWS CLI
-
示例 1:创建基于标签的资源组
以下
create-group示例在当前区域中创建 Amazon EC2 实例的基于标签的资源组。它基于使用键Name和值WebServers标记的资源的查询。日志组为tbq-WebServer。该查询在传递给命令的单独 JSON 文件中。aws resource-groups create-group \ --nametbq-WebServer\ --resource-queryfile://query.jsonquery.json的内容:{ "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" }输出:
{ "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer", "Name": "tbq-WebServer" }, "ResourceQuery": { "Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}" } }示例 2:创建基于 CloudFormation 堆栈的资源组
以下
create-group示例创建了一个名为sampleCFNstackgroup的基于 AWS CloudFormation 堆栈的资源组。该查询包括 AWS Resource Groups 支持的指定 CloudFormation 堆栈中的所有资源。aws resource-groups create-group \ --namecbq-CFNstackgroup\ --resource-queryfile://query.jsonquery.json的内容:{ "Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}" }输出:
{ "Group": { "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup", "Name": "cbq-CFNstackgroup" }, "ResourceQuery": { "Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}' } }有关更多信息,请参阅《AWS 用户指南》中的创建组。
-
有关 API 详细信息,请参阅《AWS CLI 命令参考》中的 CreateGroup
。
-
- PowerShell
-
- Tools for PowerShell V4
-
示例 1:此示例新建一个名为 TestPowerShellGroup 的基于标签的 AWS Resource Groups 资源组。该组包括当前区域中使用标签键“Name”和标签值“test2”标记的 Amazon EC2 实例。该命令返回组的查询和类型以及操作结果。
$ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery $ResourceQuery.Type = "TAG_FILTERS_1_0" $ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}' $ResourceQuery New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group."输出:
Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0 LoggedAt : 11/20/2018 2:40:59 PM Group : Amazon.ResourceGroups.Model.Group ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery Tags : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 338 HttpStatusCode : OK-
有关 API 详细信息,请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 CreateGroup。
-
- Tools for PowerShell V5
-
示例 1:此示例新建一个名为 TestPowerShellGroup 的基于标签的 AWS Resource Groups 资源组。该组包括当前区域中使用标签键“Name”和标签值“test2”标记的 Amazon EC2 实例。该命令返回组的查询和类型以及操作结果。
$ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery $ResourceQuery.Type = "TAG_FILTERS_1_0" $ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}' $ResourceQuery New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group."输出:
Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0 LoggedAt : 11/20/2018 2:40:59 PM Group : Amazon.ResourceGroups.Model.Group ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery Tags : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 338 HttpStatusCode : OK-
有关 API 详细信息,请参阅《AWS Tools for PowerShell Cmdlet Reference (V5)》中的 CreateGroup。
-