タグを使用して Auto Scaling グループをフィルタリングする - Amazon EC2 Auto Scaling

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

タグを使用して Auto Scaling グループをフィルタリングする

次の例は、describe-auto-scaling-groups コマンドでフィルターを使用して、特定のタグを持つ Auto Scaling グループを記述する方法を示しています。タグによるフィルタリングは、 AWS CLI または SDK に限定され、コンソールからは利用できません。

フィルタリングの考慮事項

  • 1 つのリクエストで複数のフィルターと複数のフィルタの値を指定できます。

  • フィルターの値にワイルドカードを使用することはできません。

  • フィルターの値は大文字と小文字が区別されます。

例: 特定のタグキーと値のペアを持つ Auto Scaling グループを記述する

次のコマンドは、environment=production のタグキーと値のペアを持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment Name=tag-value,Values=production

以下に、応答の例を示します。

{
    "AutoScalingGroups": [
        {
            "AutoScalingGroupName": "my-asg",
            "AutoScalingGroupARN": "arn",
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-0b97f1e282EXAMPLE",
                "LaunchTemplateName": "my-launch-template",
                "Version": "$Latest"
            },
            "MinSize": 1,
            "MaxSize": 5,
            "DesiredCapacity": 1,
            ...
            "Tags": [
                {
                    "ResourceType": "auto-scaling-group",
                    "ResourceId": "my-asg",
                    "PropagateAtLaunch": true,
                    "Value": "production",
                    "Key": "environment"
                }
            ],
            ...
        },

    ... additional groups ...

    ]
}

または tag:<key> フィルターを使用して、タグを指定することもできます。例えば、次のコマンドは、environment=production のタグキーと値のペアを持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。このフィルターは、次の形式になります: Name=tag:<key>,Values=<value> (<key> および <value> はタグキーと値のペアを表します。) 

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag:environment,Values=production

--query オプションを使用して AWS CLI 出力をフィルタリングすることもできます。次の例は、前のコマンドの AWS CLI 出力をグループ名、最小サイズ、最大サイズ、および希望する容量属性のみに制限する方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag:environment,Values=production \
  --query "AutoScalingGroups[].{AutoScalingGroupName: AutoScalingGroupName, MinSize: MinSize, MaxSize: MaxSize, DesiredCapacity: DesiredCapacity}"

以下に、応答の例を示します。

[
    {
        "AutoScalingGroupName": "my-asg",
        "MinSize": 0,
        "MaxSize": 10,
        "DesiredCapacity": 1
    },

    ... additional groups ...

]

フィルタリングの詳細については、「 AWS Command Line Interface ユーザーガイド」のAWS CLI 「出力のフィルタリング」を参照してください。

例: 指定したタグキーと一致するタグを持つ Auto Scaling グループを記述する

次のコマンドは、タグ値に関係なく environment タグを持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment
例: 指定したタグキーのセットに一致するタグを持つ Auto Scaling グループを記述する

次のコマンドは、タグ値に関係なく environment および project のタグを持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment Name=tag-key,Values=project
例: 指定したタグキーのうち少なくとも 1 つに一致するタグを持つ Auto Scaling グループを記述する

次のコマンドは、タグ値に関係なく environment または project のタグを持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-key,Values=environment,project
例: 指定したタグ値を持つ Auto Scaling グループを記述する

次のコマンドは、タグキーに関係なくタグ値 production を持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-value,Values=production
例: 指定したタグ値のセットを持つ Auto Scaling グループを記述する

次のコマンドは、タグキーに関係なくタグ値 production および development を持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-value,Values=production Name=tag-value,Values=development
例: 指定したタグ値の少なくとも 1 つに一致するタグを持つ Auto Scaling グループを記述する

次のコマンドは、タグキーに関係なくタグ値 production または development を持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag-value,Values=production,development
例: 複数のタグキーおよびタグ値が一致するタグを持つ Auto Scaling グループを記述する

フィルターを組み合わせてカスタム を作成することもできます。AND また、OR より複雑なフィルタリングを行うロジック。

次のコマンドは、特定のタグのセットを持つ Auto Scaling グループのみを表示するように、結果をフィルタリングする方法を示しています。1 つのタグキーは environment AND タグ値は (production OR development) AND もう 1 つのタグキーは costcenter AND タグ値は ですcc123。

aws autoscaling describe-auto-scaling-groups \
  --filters Name=tag:environment,Values=production,development Name=tag:costcenter,Values=cc123