本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 Fleet。

## 自訂標籤
<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)。