Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

为 Auto Scaling 组和实例添加标签

标签是您分配的自定义属性标签，或者是 Amazon 分配给 Amazon 资源的标签。每个标签具有两个部分：

标签可帮助您：

您可以标记新的或现有 Auto Scaling 组。您还可以将来自某个自动扩缩组的标签传播到该组启动的 EC2 实例。

标签不会传播到 Amazon EBS 卷。要向 Amazon EBS 卷添加标签，请在启动模板中指定标签。有关更多信息，请参阅 为 Auto Scaling 组创建启动模板。

您可以通过 Amazon Web Services Management Console、Amazon CLI 或 SDK 创建并管理标签。

标签命名和使用限制

下面是适用于标签的基本限制：

EC2 实例标签生命周期

如果您选择将标签传播到 EC2 实例，则将按以下方式管理标签：

标记 Auto Scaling 组

当您向 Auto Scaling 组添加标签时，可以指定是否应将其添加到 Auto Scaling 组中启动的实例。如果修改标签，在更改后，标签的更新版本将添加到在 Auto Scaling 组中启动的实例。如果创建或修改 Auto Scaling 组的标签，不会对已经在 Auto Scaling 组中运行的实例进行这些更改。

添加或修改标签（控制台）

创建时标记 Auto Scaling 组

当您使用 Amazon EC2 控制台创建 Auto Scaling 组时，您可以在“创建 Auto Scaling 组”向导的添加标签页面上指定标签键和值。要将标签传播到在 Auto Scaling 组中启动的实例，请确保该标签的 Tag new instances（标记新实例）选项保持选中状态。否则，您可以取消选择它。

添加或修改标签 (Amazon CLI)

以下示例说明如何使用 Amazon CLI 在您创建 Auto Scaling 组时添加标签，以及添加或修改现有 Auto Scaling 组的标签。

创建时标记 Auto Scaling 组

使用 create-auto-scaling-group 命令创建新的 Auto Scaling 组并将标签（例如 environment=production）添加到 Auto Scaling 组。该标签还会添加到在 Auto Scaling 组中启动的任何实例。

aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
  --launch-configuration-name my-launch-config --min-size 1 --max-size 3 \
  --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" \
  --tags Key=environment,Value=production,PropagateAtLaunch=true

创建或修改现有 Auto Scaling 组的标签

使用 create-or-update-tags 命令创建或修改标签。例如，以下命令将添加 Name=my-asg 和 costcenter=cc123 标签。在进行该更改后，该标签还会添加到在 Auto Scaling 组中启动的任何实例。如果具有任一键的标签已经存在，则会替换现有标签。Amazon EC2 控制台将每个实例的显示名称与为 Name 键指定的名称（区分大小写）关联。

aws autoscaling create-or-update-tags \
  --tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Name,Value=my-asg,PropagateAtLaunch=true \
  ResourceId=my-asg,ResourceType=auto-scaling-group,Key=costcenter,Value=cc123,PropagateAtLaunch=true

描述 Auto Scaling 组的标签 (Amazon CLI）

如果您要查看应用于特定的 Auto Scaling 组的标签，可以使用以下任一命令：

删除标签

您可以随时删除与 Auto Scaling 组关联的标签。

删除标签（控制台）

删除标签 (Amazon CLI)

使用 delete-tags 命令删除标签。例如，以下命令删除键为 environment 的标签。

aws autoscaling delete-tags --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=environment"

您必须指定标签键，但无需指定值。如果您指定了一个值，并且该值不正确，则不会删除标签。

安全性标签

使用标签来验证请求者（例如 IAM 用户或角色）是否有权创建、修改或删除特定自动扩缩组。使用下面的一个或多个条件键，在 IAM policy 的条件元素中提供标签信息：

例如，您可能拒绝对包含具有键 environment 和值 production 的标签的 Auto Scaling 组的访问，如以下示例所示。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [        
                "autoscaling:CreateAutoScalingGroup",
                "autoscaling:UpdateAutoScalingGroup",
                "autoscaling:DeleteAutoScalingGroup"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {"autoscaling:ResourceTag/environment": "production"}
            }
        }
    ]
}

有关更多示例，请参阅 Amazon EC2 Auto Scaling 基于身份的策略示例：

控制对标签的访问

使用标签来验证请求者（例如 IAM 用户或角色）是否有权添加、修改或删除自动扩缩组的标签。

例如，您可以创建一个 IAM policy，以仅允许从自动扩缩组删除具有 temporary 键的标签。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [        
                "autoscaling:DeleteTags"
            ],
            "Resource": "*",
            "Condition": {
                "ForAllValues:StringEquals": { "aws:TagKeys": ["temporary"] }
            }
        }
    ]
}

有关更多示例，请参阅 Amazon EC2 Auto Scaling 基于身份的策略示例：

使用标签筛选 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": [
        {
            "AutoScalingGroupARN": "arn",
            "HealthCheckGracePeriod": 0,
            "SuspendedProcesses": [],
            "DesiredCapacity": 1,
            "Tags": [
                {
                    "ResourceType": "auto-scaling-group",
                    "ResourceId": "my-asg",
                    "PropagateAtLaunch": true,
                    "Value": "production",
                    "Key": "environment"
                }
            ],
            "EnabledMetrics": [],
            "LoadBalancerNames": [],
            "AutoScalingGroupName": "my-asg",
            ...
        }
    ]
}

或者，您也可以使用 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
    }
  ...
]

有关筛选的详细信息，请参阅 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