Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Etiquetado de los recursos de salida de Generador de imágenes
<a name="tag-resources"></a>

Etiquetar los recursos puede resultar útil para filtrar y realizar un seguimiento de los costos de los recursos o de otras categorías. También puede controlar el acceso mediante etiquetas. Para obtener más información acerca de la autorización basada en etiquetas, consulte [Autorización basada en etiquetas de Generador de Imágenes](security_iam_service-with-iam.md#security-iam-service-with-ib-tags)

Generador de Imágenes es compatible con las siguientes etiquetas dinámicas:
+ `- {{imagebuilder:buildDate}}`

  Resuelve construir date/time en el momento de la construcción.
+ `- {{imagebuilder:buildVersion}}`

  Se resuelve en una versión de compilación, que es un número que se encuentra al final de un Nombre de recurso de Amazon (ARN) de Generador de imágenes. Por ejemplo, `"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"` muestra la versión de compilación como `1`.

Para ayudarle a realizar un seguimiento de las imágenes de Amazon Machine (AMIs) que ha distribuido, Image Builder añade automáticamente las siguientes etiquetas a la salida AMIs.
+ `"CreatedBy":"EC2 Image Builder"`
+ `"Ec2ImageBuilderArn":"arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0/10"`. Esta etiqueta contiene el ARN del recurso de imagen de Generador de imágenes que se utilizó para crear la AMI.

**Topics**
+ [Etiquete un recurso del AWS CLI](#cli-tag-resource)
+ [Quite la etiqueta de un recurso del AWS CLI](#cli-untag-resource)
+ [Enumera todas las etiquetas de un recurso específico del AWS CLI](#cli-list-tags-for-resource)

## Etiquete un recurso del AWS CLI
<a name="cli-tag-resource"></a>

El siguiente ejemplo muestra cómo utilizar un comando de la CLI **imagebuilder** para añadir y etiquetar un recurso en Generador de imágenes de EC2. Debe proporcionar `resourceArn` y las etiquetas que desee aplicárselas.

Los contenidos del ejemplo `tag-resource.json` son los siguientes:

```
{
    "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline",
    "tags": {
        "KeyName": "KeyValue"
    }
}
```

Ejecute el siguiente comando que hace referencia al archivo `tag-resource.json` anterior.

```
aws imagebuilder tag-resource --cli-input-json file://tag-resource.json
```

## Quite la etiqueta de un recurso del AWS CLI
<a name="cli-untag-resource"></a>

En el ejemplo siguiente se indica cómo utilizar un comando de la CLI **imagebuilder** para eliminar una etiqueta de un recurso. Debe proporcionar `resourceArn` y las claves para eliminar la etiqueta.

Los contenidos del ejemplo `untag-resource.json` son los siguientes:

```
{
    "resourceArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline",
    "tagKeys": [
        "KeyName"
    ]
}
```

Ejecute el siguiente comando que hace referencia al archivo `untag-resource.json` anterior.

```
aws imagebuilder untag-resource --cli-input-json file://untag-resource.json
```

## Enumera todas las etiquetas de un recurso específico del AWS CLI
<a name="cli-list-tags-for-resource"></a>

El siguiente ejemplo muestra cómo utilizar un comando de la CLI **imagebuilder** para enumerar todas las etiquetas de un recurso específico.

```
aws imagebuilder list-tags-for-resource --resource-arn arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/my-example-pipeline
```