# 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)」を参照してください。