# Etiquetas para instancias administradas de Amazon ECS
<a name="instance-details-tags-managed-instances"></a>

Instancias administradas de Amazon ECS admite una combinación de etiquetas personalizadas y etiquetas agregadas por AWS que se pueden utilizar para optimizar los costos. Para obtener más información acerca del uso de etiquetas para la facturación, consulte [Uso de etiquetas para facturación](ecs-using-tags.md#tag-resources-for-billing).

## Etiquetas agregadas por AWS
<a name="instance-details-tags-managed-instances-system"></a>

 AWS agrega las siguientes etiquetas a cada instancia administrada de Amazon ECS creada por el proveedor de capacidad:
+ Amazon ECS agrega automáticamente las etiquetas reservadas `AmazonECSCreated` y `AmazonECSManaged` a instancias administradas de Amazon ECS.
+ Amazon ECS agrega las siguientes etiquetas de sistema a cada instancia:
  + Una etiqueta con una *clave* como `aws:ecs:clusterName` y un *valor* establecidos en el nombre del clúster.
  + Una etiqueta con una *clave* como `aws:ecs:capacityProviderName` y un *valor* establecidos en el nombre del proveedor de capacidad.
  + Una etiqueta con una *clave* como `aws:ecs:containerInstanceId` y un *valor* como ID de instancia de contenedor para la instancia administrada de Amazon ECS.
+ Amazon EC2 agrega la etiqueta del sistema `aws:ec2:managed-launch` con el valor `ecs-managed-instances`. Además, Amazon EC2 agrega etiquetas de sistema que indican la plantilla de lanzamiento que se utilizó para crear la instancia administrada y la flota de Amazon EC2 de la que forma parte la instancia administrada.

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

Para agregar etiquetas personalizadas adicionales a instancias administradas de Amazon ECS, agregue etiquetas al proveedor de capacidad y habilite la propagación de etiquetas mediante la propiedad `propagateTags`. Las etiquetas del proveedor de capacidad se propagan a las instancias administradas que lanza el proveedor de capacidad.

El siguiente ejemplo de definición de proveedor de capacidad muestra cómo se pueden especificar y propagar las etiquetas desde el proveedor de capacidad al crear el proveedor de capacidad utilizando el 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**  
Al agregar etiquetas nuevas a un proveedor de capacidad, las etiquetas recién agregadas no se propagarán a las instancias existentes, sino que se propagarán a las instancias recién creadas.
Los clientes pueden agregar etiquetas de forma directa a las instancias de EC2, pero esas etiquetas no se propagan de nuevo al proveedor de capacidad
También puede etiquetar o quitar la etiqueta del proveedor de capacidad mediante [Adición de etiquetas a los recursos existentes (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) o [Adición de etiquetas a los recursos existentes (consola de Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags)

Para obtener más información sobre los proveedores de capacidad de instancias administradas de Amazon ECS, consulte [Proveedores de capacidad de instancias administradas de Amazon ECS](managed-instances-capacity-providers-concept.md).