Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Ressources de sortie de Tag Image Builder
<a name="tag-resources"></a>

Le balisage de vos ressources peut être utile pour filtrer et suivre les coûts des ressources, ou pour d'autres catégories. Vous pouvez également contrôler l'accès en fonction des balises. Pour plus d'informations sur l'autorisation basée sur des balises, voir [Autorisation basée sur les balises Image Builder](security_iam_service-with-iam.md#security-iam-service-with-ib-tags)

Image Builder prend en charge les balises dynamiques suivantes :
+ `- {{imagebuilder:buildDate}}`

  Résout à la construction date/time au moment de la construction.
+ `- {{imagebuilder:buildVersion}}`

  Résout à une version de build, qui est un numéro situé à la fin du nom de ressource Amazon (ARN) d'Image Builder. Par exemple, `"arn:aws:imagebuilder:us-west-2:123456789012:component/myexample-component/2019.12.02/1"` affiche la version de compilation sous la forme`1`.

Pour vous aider à suivre les Amazon Machine Images (AMIs) que vous avez distribuées, Image Builder ajoute automatiquement les balises suivantes à votre sortie AMIs.
+ `"CreatedBy":"EC2 Image Builder"`
+ `"Ec2ImageBuilderArn":"arn:aws:imagebuilder:us-west-2:123456789012:image/simple-recipe-linux/1.0.0/10"`. Cette balise contient l'ARN de la ressource d'image Image Builder qui a été utilisée pour créer l'AMI.

**Topics**
+ [Marquez une ressource depuis AWS CLI](#cli-tag-resource)
+ [Supprimer le tag d'une ressource du AWS CLI](#cli-untag-resource)
+ [Répertoriez toutes les balises d'une ressource spécifique à partir du AWS CLI](#cli-list-tags-for-resource)

## Marquez une ressource depuis AWS CLI
<a name="cli-tag-resource"></a>

L'exemple suivant montre comment utiliser une commande **imagebuilder** CLI pour ajouter et étiqueter une ressource dans EC2 Image Builder. Vous devez fournir les balises `resourceArn` et à appliquer.

Le `tag-resource.json` contenu de l'exemple est le suivant :

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

Exécutez la commande suivante, qui fait référence au `tag-resource.json` fichier précédent.

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

## Supprimer le tag d'une ressource du AWS CLI
<a name="cli-untag-resource"></a>

L'exemple suivant montre comment utiliser une commande **imagebuilder** CLI pour supprimer une balise d'une ressource. Vous devez fournir les clés `resourceArn` et pour retirer le tag.

Le `untag-resource.json` contenu de l'exemple est le suivant :

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

Exécutez la commande suivante, qui fait référence au `untag-resource.json` fichier précédent.

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

## Répertoriez toutes les balises d'une ressource spécifique à partir du AWS CLI
<a name="cli-list-tags-for-resource"></a>

L'exemple suivant montre comment utiliser une commande **imagebuilder** CLI pour répertorier toutes les balises d'une ressource spécifique.

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