# Tags para instâncias gerenciadas do Amazon ECS
<a name="instance-details-tags-managed-instances"></a>

As instâncias gerenciadas do Amazon ECS oferecem suporte a uma combinação de tags personalizadas e tags adicionadas pela AWS que podem ser usadas para otimização de custos. Para obter mais informações sobre como usar tags para faturamento, consulte [Usar etiquetas para faturamento](ecs-using-tags.md#tag-resources-for-billing).

## Tags adicionadas pela AWS
<a name="instance-details-tags-managed-instances-system"></a>

 A AWS adiciona as seguintes tags a cada instância gerenciada do Amazon ECS criada pelo provedor de capacidade:
+ O Amazon ECS adiciona automaticamente as tags reservadas `AmazonECSCreated` e `AmazonECSManaged` às Instâncias gerenciadas do Amazon ECS.
+ O Amazon ECS adiciona as seguintes tags de sistema a cada instância:
  + Uma tag com uma *Chave* como `aws:ecs:clusterName` e um *Valor* definido com o nome do cluster.
  + Uma tag com uma *Chave* como `aws:ecs:capacityProviderName` e um *Valor* definido com o nome do provedor de capacidade.
  + Uma tag com uma *Chave* como `aws:ecs:containerInstanceId` e um *Valor* como ID da instância de contêiner para a instância gerenciada do Amazon ECS.
+ O Amazon EC2 adiciona a tag de sistema `aws:ec2:managed-launch` com o valor `ecs-managed-instances`. Além disso, o Amazon EC2 adiciona tags de sistema que indicam o modelo de inicialização usado para criar a instância gerenciada e o Amazon EC2 Fleet do qual a instância gerenciada faz parte.

## Tags personalizadas
<a name="instance-details-tags-managed-instances-custom"></a>

Você pode adicionar outras tags personalizadas às instâncias gerenciadas do Amazon ECS adicionando tags ao provedor de capacidade e habilitando a propagação de tags usando a propriedade `propagateTags`. As etiquetas do provedor de capacidade são propagadas para as instâncias gerenciadas que o provedor de capacidade inicia

O exemplo de definição de provedor de capacidade a seguir mostra como as tags podem ser especificadas e propagadas no provedor de capacidade ao criá-lo usando o valor `CAPACITY_PROVIDER` para `propagateTags`.

```
{
    "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"
                ]
            }
        }
    }
}
```

**nota**  
Quando você adiciona novas tags a um provedor de capacidade, as tags recém-adicionadas não são propagadas para as instâncias existentes, mas para todas as instâncias recém-criadas.
Os clientes podem adicionar etiquetas diretamente às instâncias do EC2, mas essas etiquetas não são repassadas ao provedor de capacidade
Você também pode aplicar ou remover etiquetas ao provedor de capacidade usando [Adicionar etiquetas a recursos existentes (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) ou [Adicionar etiquetas a recursos existentes (console do Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags)

Para obter mais informações sobre provedores de capacidade de instâncias gerenciadas do Amazon ECS, consulte [Provedores de capacidade das instâncias gerenciadas do Amazon ECS](managed-instances-capacity-providers-concept.md).