# Amazon ECS 托管实例的标签
<a name="instance-details-tags-managed-instances"></a>

Amazon ECS 托管实例支持自定义标签和 AWS 添加的标签的组合，可用于成本优化。有关使用标签进行计费的更多信息，请参阅[使用标签记账](ecs-using-tags.md#tag-resources-for-billing)。

## 由 AWS 添加的标签
<a name="instance-details-tags-managed-instances-system"></a>

 AWS 会向容量提供程序创建的每个 Amazon ECS 托管实例添加以下标签：
+ Amazon ECS 会自动将保留标签 `AmazonECSCreated` 和 `AmazonECSManaged` 添加到 Amazon ECS 托管实例。
+ Amazon ECS 会将以下系统标签添加到每个实例：
  + *键*为 `aws:ecs:clusterName` 且*值*设置为集群名称的标签。
  + *键*为 `aws:ecs:capacityProviderName` 且*值*设置为容量提供程序名称的标签。
  + *键*为 `aws:ecs:containerInstanceId` 且*值*为 Amazon ECS 托管实例的容器实例 ID 的标签。
+ Amazon EC2 会添加值为 `ecs-managed-instances` 的系统标签 `aws:ec2:managed-launch`。此外，Amazon EC2 还会添加系统标签，表示用于创建托管实例的启动模板以及托管实例所属的 Amazon EC2 实例集。

## 自定义标签
<a name="instance-details-tags-managed-instances-custom"></a>

您可以通过向容量提供程序添加标签并使用 `propagateTags` 属性启用标签传播，向 Amazon ECS 托管实例添加其他自定义标签。容量提供程序上的标签会传播到容量提供程序启动的托管实例

以下示例容量提供程序定义显示了在使用 `propagateTags` 的 `CAPACITY_PROVIDER` 值创建容量提供程序时，如何指定标签并从容量提供程序传播标签。

```
{
    "name": "my-cluster-managed-instances-cp",
    "cluster": "my-cluster",
     "tags": [
                {
                "key":"tag_key",
                "value":"tag_value"
                }
            ],
    "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
        "propagateTags": "CAPACITY_PROVIDER",
        "instanceLaunchTemplate": {
            "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
            "networkConfiguration": {
                "subnets": [
                    "subnet-abcdef01234567",
                    "subnet-bcdefa98765432"
                ],
                "securityGroups": [ 
                    "sg-0123456789abcdef"
                ]
            }
        }
    }
}
```

**注意**  
当您向容量提供程序添加新标签时，新添加的标签不会传播到现有实例，但会传播到任何新创建的实例。
允许客户直接向 EC2 实例添加标签，但这些标签不会传播回容量提供程序
您也可以使用 [向现有资源添加标签（AWS CLI）](tag-resources-console.md#tag-resources-api-sdk) 或 [为现有资源添加标签（Amazon ECS 控制台）](tag-resources-console.md#adding-or-deleting-tags) 标记或取消标记容量提供程序

有关 Amazon ECS 托管实例容量提供程序的更多信息，请参阅 [Amazon ECS 托管实例容量提供程序](managed-instances-capacity-providers-concept.md)。