为您的 Amazon ECS 资源添加标签

用户使用 Amazon Web Services Management Console、Amazon ECS API、Amazon CLI 或 Amazon SDK 为资源手动添加标签。

用户创建服务或运行独立任务，然后选择 Amazon ECS 托管标签选项。

Amazon ECS 会自动为所有新启动的任务添加标签。有关更多信息，请参阅Amazon ECS 托管标签：

用户使用控制台创建资源。控制台会自动为资源添加标签。

这些标签在Amazon CLI，以及AmazonSDK 响应和显示在控制台中。您无法修改或删除这些标签。

有关添加的标签的信息，请参阅 Amazon ECS 资源标签支持表中的控制台自动添加的标签列。

Amazon ECS 任务

Amazon ECS 服务

Amazon ECS 任务定义

Amazon ECS 任务集

Amazon ECS 集群

Amazon ECS 容器实例。

Amazon ECS 容量提供程序

您必须选择使用该功能。有关更多信息，请参阅标记授权：

选择加入后，用户必须拥有创建资源的操作权限，例如ecsCreateCluster。如果在资源创建操作中指定了标签，Amazon执行额外授权以验证用户或角色是否具有创建标签的权限。因此，必须授予明确的权限才能使用ecs:TagResource行动。有关更多信息，请参阅授予在创建资源时标记资源的权限：

一个资源最多可以关联 50 个标签。

不能对一个资源重复使用标签键。每个标签键必须具有唯一性，而且只能有一个值。

键最长可达 128 个字符（采用 UTF-8 格式）。

值最长可达 256 个字符（采用 UTF-8 格式）。

如果有多个 Amazon Web Services 和资源使用您的标记方案，请限制您使用的字符类型。某些服务可能对允许使用的字符有限制。通常允许使用的字符包括字母、数字、空格以及以下字符：+ - = . _ : / @。

标签键和值区分大小写。

不能使用 aws:、AWS: 或它们的任何大写或小写组合作为键或值的前缀。它们保留供 Amazon 使用。您无法编辑或删除带此前缀的标签键或值。带有此前缀的标签不对您不利tags-per-resource限制。

独立任务 – 键为 aws:ecs:clusterName 且值设置为集群名称的标签。用户添加的所有任务定义标签。

服务所包含的任务 – 键为 aws:ecs:clusterName 且值设置为集群名称的标签。键为 aws:ecs:serviceName 且值设置为服务名称的标签。来自以下资源之一的标签：

您必须选择使用新的 Amazon 资源名称 (ARN) 和资源标识符 (ID) 格式。有关更多信息，请参阅Amazon Resource Names (ARN) 和 ID：

当您使用 API 创建服务或运行任务时，您必须将 run-task 和 create-service 的 enableECSManagedTags 设置为 true。有关更多信息，请参阅 Amazon Command Line Interface API 参考中的 create-service 和 run-task。

方法 1 - 在使用 Amazon EC2 API、CLI 或控制台创建容器实例时，通过使用容器代理配置参数 ECS_CONTAINER_INSTANCE_TAGS 将用户数据传递到实例来指定标签。这只创建与 Amazon ECS 中的容器实例关联的标签，而无法使用 Amazon EC2 API 列出这些标签。有关更多信息，请参阅使用 Amazon EC2 用户数据引导启动容器实例：

下面是将标签与您的容器实例关联的用户数据脚本示例：

#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
EOF

方法 2 – 当您使用 Amazon EC2 API、CLI 或控制台创建容器实例时，请首先使用 TagSpecification.N 参数指定标签。然后，使用容器代理配置参数 ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM 将用户数据传递给实例。这样做会将它们从 Amazon EC2 传播到 Amazon ECS。

下面是一个用户数据脚本示例，该脚本将传播与 Amazon EC2 实例关联的标签，以及向名为 MyCluster 的集群注册实例。

#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
EOF

要提供访问权限以允许容器实例标签从 Amazon EC2 传播到 Amazon ECS，请手动将以下权限作为内链策略添加到 Amazon ECS 容器实例 IAM 角色。有关更多信息，请参阅添加和删除 IAM policy。

以下是用于添加这些权限的示例策略。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
            	"ec2:DescribeTags"
            ],
            "Resource": "*"
        }
    ]
}

方法 1–在运行安装脚本向集群注册外部实例之前，请在 /etc/ecs/ecs.config 处创建或编辑 Amazon ECS 容器代理配置文件，并添加 ECS_CONTAINER_INSTANCE_TAGS 容器代理配置参数。这将创建与外部实例关联的标签。

以下是示例语法。

ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}

方法 2 – 将外部实例注册到集群后，您可以使用 Amazon Web Services Management Console 添加标签。有关更多信息，请参阅使用控制台管理单个资源标签：