# Adición de etiquetas a una instancia de contenedor de Amazon EC2 para Amazon ECS
<a name="instance-details-tags"></a>

Para asociar etiquetas con las instancias de contenedor de Amazon EC2 para Amazon ECS, utilice uno de los siguientes métodos:
+ Método 1: al crear su instancia de contenedor desde la API de Amazon EC2, la CLI o la consola, especifique las etiquetas pasando los datos del usuario a la instancia mediante el parámetro de configuración del agente de contenedor `ECS_CONTAINER_INSTANCE_TAGS`. Esto crea etiquetas que están asociadas solo a la instancia de contenedor de Amazon ECS, y no pueden enumerar mediante la API de Amazon EC2. Para obtener más información, consulte [Arranque de instancias de contenedor de Linux de Amazon ECS para la transferencia de datos](bootstrap_container_instance.md).
**importante**  
Si inicia las instancias de contenedor mediante un grupo de Amazon EC2 Auto Scaling, debe utilizar el parámetro de configuración del agente ECS\$1CONTAINER\$1INSTANCE\$1TAGS para agregar etiquetas. Esto se debe a la forma en que se agregan las etiquetas a las instancias de Amazon EC2 que se lanzan mediante grupos de Auto Scaling.

  A continuación, se muestra un ejemplo de un script de datos de usuario que asocia etiquetas con su instancia de contenedor:

  ```
  #!/bin/bash
  cat <<'EOF' >> /etc/ecs/ecs.config
  ECS_CLUSTER=MyCluster
  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
  EOF
  ```
+ Método 2: al crear su instancia de contenedor desde la API de Amazon EC2, la CLI o la consola, especifique primero las etiquetas mediante el parámetro `TagSpecification.N`. A continuación, transfiera los datos de usuario a la instancia mediante el parámetro de configuración del agente de contenedor `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM`. Al hacerlo, se propaga desde Amazon EC2 a Amazon ECS.

  A continuación, se muestra un ejemplo de un script de datos de usuario que propaga las etiquetas que están asociadas a una instancia de Amazon EC2, además de registrar la instancia en un clúster con el nombre `MyCluster`.

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

  Para proporcionar acceso y permitir que las etiquetas de instancia de contenedor se propaguen de Amazon EC2 a Amazon ECS, agregue manualmente los siguientes permisos como una política insertada al rol de IAM de instancia de contenedor de Amazon ECS. Para obtener más información, consulte [Adición y eliminación de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).
  + `ec2:DescribeTags`

  A continuación, se presenta una política de ejemplo mediante la cual se agregan estos permisos.

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

****  

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

------