CLI で DescribeTags を使用する

次のサンプルコードは、DescribeTags を使用する方法を説明しています。

CLI

AWS CLI

すべてのタグを記述する方法

この例では、すべてのタグを記述します。

aws autoscaling describe-tags

出力:

{
    "Tags": [
        {
            "ResourceType": "auto-scaling-group",
            "ResourceId": "my-asg",
            "PropagateAtLaunch": true,
            "Value": "Research",
            "Key": "Dept"
        },
        {
            "ResourceType": "auto-scaling-group",
            "ResourceId": "my-asg",
            "PropagateAtLaunch": true,
            "Value": "WebServer",
            "Key": "Role"
        }
    ]
}

詳細については、「Amazon EC2 Auto Scaling ユーザーガイド」の「Auto Scaling グループとインスタンスのタグ付け」を参照してください。

例 2: 指定されたグループのタグを記述する方法

特定の Auto Scaling グループのタグを説明するには、--filters オプションを使用します。

aws autoscaling describe-tags --filters Name=auto-scaling-group,Values=my-asg

詳細については、「Amazon EC2 Auto Scaling ユーザーガイド」の「Auto Scaling グループとインスタンスのタグ付け」を参照してください。

例 3: 指定された数のタグを記述する方法

特定の数のタグを返すには、--max-items オプションを使用します。

aws autoscaling describe-tags \
    --max-items 1

出力に NextToken フィールドが含まれている場合は、さらに多くのタグがあることを示しています。追加のタグを取得するには、次のように、以降の呼び出しで --starting-token オプションを使用してこのフィールドの値を使用します。

aws autoscaling describe-tags \
    --filters Name=auto-scaling-group,Values=my-asg \
    --starting-token Z3M3LMPEXAMPLE

詳細については、「Amazon EC2 Auto Scaling ユーザーガイド」の「Auto Scaling グループとインスタンスのタグ付け」を参照してください。

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

PowerShell

Tools for PowerShell V4

例 1: この例では、キー値が「myTag」または「myTag2」のタグを記述します。フィルター名に使用できる値は、「auto-scaling-group」、「key」、「value」、および「propagate-at-launch」です。この例で使用される構文には、PowerShell バージョン 3 以降が必要です。

Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )

出力:

Key               : myTag2
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue2

Key               : myTag
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue

例 2: PowerShell バージョン 2 では、New-Object を使用してフィルターパラメータのフィルターを作成する必要があります。

$keys = New-Object string[] 2
$keys[0] = "myTag"
$keys[1] = "myTag2"
$filter = New-Object Amazon.AutoScaling.Model.Filter
$filter.Name = "key"
$filter.Values = $keys
Get-ASTag -Filter @( $filter )

例 3: この例では、すべての Auto Scaling グループのすべてのタグを記述します。

Get-ASTag

• API の詳細については、「AWS Tools for PowerShell コマンドレットリファレンス (V4)」の「DescribeTags」を参照してください。

Tools for PowerShell V5

例 1: この例では、キー値が「myTag」または「myTag2」のタグを記述します。フィルター名に使用できる値は、「auto-scaling-group」、「key」、「value」、および「propagate-at-launch」です。この例で使用される構文には、PowerShell バージョン 3 以降が必要です。

Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )

出力:

Key               : myTag2
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue2

Key               : myTag
PropagateAtLaunch : True
ResourceId        : my-asg
ResourceType      : auto-scaling-group
Value             : myTagValue

例 2: PowerShell バージョン 2 では、New-Object を使用してフィルターパラメータのフィルターを作成する必要があります。

$keys = New-Object string[] 2
$keys[0] = "myTag"
$keys[1] = "myTag2"
$filter = New-Object Amazon.AutoScaling.Model.Filter
$filter.Name = "key"
$filter.Values = $keys
Get-ASTag -Filter @( $filter )

例 3: この例では、すべての Auto Scaling グループのすべてのタグを記述します。

Get-ASTag

• API の詳細については、「AWS Tools for PowerShell コマンドレットリファレンス (V5)」の「DescribeTags」を参照してください。