将 GetResources 与 CLI 配合使用

以下代码示例演示如何使用 GetResources。

CLI

AWS CLI

获取已标记资源的列表

以下 get-resources 示例显示账户中使用指定键名和值标记的资源的列表。

aws resourcegroupstaggingapi get-resources \
    --tag-filters Key=Environment,Values=Production \
    --tags-per-page 100

输出：

{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}

有关更多信息，请参阅 Resour GetResourcesce G roups 标记 API 参考中的。

• 有关 API 的详细信息，请参阅AWS CLI 命令参考GetResources中的。

PowerShell

适用于 PowerShell V4 的工具

示例 1：返回某个区域中所有带标签的资源及与资源关联的标签键。如果未向 cmdlet 提供 -Region 参数，它将尝试从 Shell 或 EC2 实例元数据推断区域。

Get-RGTResource

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}   
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 2：返回某个区域中指定类型的所有带标签的资源。每个服务名称和资源类型的字符串都与嵌入在资源的 Amazon 资源名称（ARN）中的字符串相同。

Get-RGTResource -ResourceType "s3"

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 3：返回某个区域中指定类型的所有带标签的资源。请注意，当资源类型通过管道传输到 cmdlet 时，将为每个提供的资源类型向服务发出一个调用。

"dynamodb","s3" | Get-RGTResource

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}   
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 4：返回与指定筛选条件匹配的所有带标签的资源。

Get-RGTResource -TagFilter @{ Key="stage" }

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 5：返回与指定筛选条件和资源类型匹配的所有带标签的资源。

Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb"

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}

示例 6：返回与指定筛选条件匹配的所有带标签的资源。

Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") }

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考 (V 4) GetResources中的。

适用于 PowerShell V5 的工具

示例 1：返回某个区域中所有带标签的资源及与资源关联的标签键。如果未向 cmdlet 提供 -Region 参数，它将尝试从 Shell 或 EC2 实例元数据推断区域。

Get-RGTResource

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}   
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 2：返回某个区域中指定类型的所有带标签的资源。每个服务名称和资源类型的字符串都与嵌入在资源的 Amazon 资源名称（ARN）中的字符串相同。

Get-RGTResource -ResourceType "s3"

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 3：返回某个区域中指定类型的所有带标签的资源。请注意，当资源类型通过管道传输到 cmdlet 时，将为每个提供的资源类型向服务发出一个调用。

"dynamodb","s3" | Get-RGTResource

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}   
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 4：返回与指定筛选条件匹配的所有带标签的资源。

Get-RGTResource -TagFilter @{ Key="stage" }

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:s3:::amzn-s3-demo-bucket                                            {stage, version, othertag}

示例 5：返回与指定筛选条件和资源类型匹配的所有带标签的资源。

Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb"

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}

示例 6：返回与指定筛选条件匹配的所有带标签的资源。

Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") }

输出：

ResourceARN                                                      Tags          
-----------                                                      ----            
arn:aws:dynamodb:us-west-2:123456789012:table/mytable            {stage, version}

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考 (V 5) GetResources中的。