# Adicionar tags a uma instância de contêiner do Amazon EC2 para o Amazon ECS
<a name="instance-details-tags"></a>

É possível associar tags a suas instâncias de contêiner do Amazon EC2 para Amazon ECS usando um dos seguintes métodos:
+ Método 1: ao criar a instância de contêiner usando a API, a CLI ou o console do Amazon EC2, especifique as etiquetas transmitindo os dados do usuário para a instância usando o parâmetro de configuração do agente de contêiner `ECS_CONTAINER_INSTANCE_TAGS`. Isso cria etiquetas que são associadas à instância de contêiner somente no Amazon ECS. Elas não podem ser listadas usando a API do Amazon EC2. Para obter mais informações, consulte [Inicialização de instâncias de contêiner do Linux no Amazon ECS para transmitir dados](bootstrap_container_instance.md).
**Importante**  
Se você iniciar as instâncias de contêiner usando um grupo do Amazon EC2 Auto Scaling, deverá usar o parâmetro de configuração do agente ECS\$1CONTAINER\$1INSTANCE\$1TAGS para adicionar etiquetas. Isso é decorrente da maneira como as etiquetas são adicionadas às instâncias do Amazon EC2 que são iniciadas por meio de grupos do Auto Scaling.

  Veja a seguir um exemplo de um script de dados do usuário que associa tags à sua instância de contêiner:

  ```
  #!/bin/bash
  cat <<'EOF' >> /etc/ecs/ecs.config
  ECS_CLUSTER=MyCluster
  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
  EOF
  ```
+ Método 2: ao criar sua instância de contêiner usando a API, a CLI ou o console do Amazon EC2, especifique primeiramente as tags usando o parâmetro `TagSpecification.N`. Em seguida, transmita os dados do usuário para a instância usando o parâmetro `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM` de configuração do agente de contêiner. Essa ação propaga os dados do Amazon EC2 para o Amazon ECS.

  Veja a seguir um exemplo de um script de dados do usuário que propaga as tags associadas a uma instância do Amazon EC2 e registra a instância em um cluster denominado `MyCluster`.

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

  Para fornecer acesso para permitir que as etiquetas de instância de contêiner se propaguem do Amazon EC2 para o Amazon ECS, adicione manualmente as seguintes permissões, como uma política alinhada, à função do IAM da instância de contêiner do Amazon ECS. Para obter mais informações, consulte [Adicionar e remover políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).
  + `ec2:DescribeTags`

  Veja a seguir um exemplo de política usada para adicionar essas permissões.

------
#### [ JSON ]

****  

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

------