CLI で GetResources を使用する

次のサンプルコードは、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"
                }
            ]
        }
    ]
}

詳細については、「Resource Groups Tagging API リファレンス」の「GetResources」を参照してください。

• API の詳細については、AWS CLI コマンドリファレンスの「GetResources」を参照してください。

PowerShell

Tools for PowerShell V4

例 1: リージョン内のすべてのタグ付けされたリソースと、リソースに関連付けられたタグキーを返します。コマンドレットに -Region パラメータが指定されていない場合、シェルまたは 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: リージョン内の指定されたタイプのタグ付けされたリソースをすべて返します。リソースタイプをコマンドレットにパイプすると、指定されたリソースタイプごとにサービスへの呼び出しが 1 回行われることに注意してください。

"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 コマンドレットリファレンス (V4)」の「GetResources」を参照してください。

Tools for PowerShell V5

例 1: リージョン内のすべてのタグ付けされたリソースと、リソースに関連付けられたタグキーを返します。コマンドレットに -Region パラメータが指定されていない場合、シェルまたは 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: リージョン内の指定されたタイプのタグ付けされたリソースをすべて返します。リソースタイプをコマンドレットにパイプすると、指定されたリソースタイプごとにサービスへの呼び出しが 1 回行われることに注意してください。

"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 コマンドレットリファレンス (V5)」の「GetResources」を参照してください。