使用标签筛选 Auto Scaling 组 - Amazon EC2 Auto Scaling
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用标签筛选 Auto Scaling 组

以下示例向您演示如何将筛选条件与 describe-auto-scaling-groups 命令搭配使用来描述具有特定标签的 Auto Scaling 组。按标签筛选仅限于 Amazon CLI 或 SDK，并且不可从控制台使用。

筛选注意事项

  • 您可以在单一请求中指定多个筛选条件和多个筛选条件值。

  • 您不可以将通配符与筛选值一同使用。

  • 筛选值区分大小写。

示例：使用特定标签键和值对描述 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 选项筛选 Amazon CLI 输出。以下示例演示了如何限制上一条命令的 Amazon 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 ...

]

有关筛选的详细信息，请参阅 Amazon Command Line Interface 用户指南中的筛选 Amazon 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
示例：描述具有与至少一个指定标签键匹配的标签的 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
示例：描述带有与至少一个指定标签值匹配的标签的 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 组。一个标签键是 environment AND，并且标签值是 (production OR development) AND；而另一个标签键是 costcenter AND，并且标签值是 cc123。

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