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.
# **eb tags**
## Description
Ajoutez, supprimez, mettez à jour et listez des balises d'une ressource Elastic Beanstalk.
Pour de plus amples informations sur le balisage des ressources dans Elastic Beanstalk, veuillez consulter [Étiquette des ressources d'application Elastic Beanstalk](applications-tagging-resources.md).
## Syntaxe
**eb tags [*environment-name*] [--resource *ARN*] -l \$1 --list**
**eb tags [*environment-name*] [--resource *ARN*] -a \$1 --add *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -u \$1 --update *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -d \$1 --delete *key1*[,*key2* ...]**
Vous pouvez combiner les options de sous-commande `--add`, `--update` et `--delete` en une seule commande. Au moins l'une d'elles est obligatoire. Vous ne pouvez pas combiner n'importe laquelle des trois options de sous-commande avec `--list`.
Sans tous les arguments supplémentaires, tous ces commandes répertorient ou modifient les balises de l'environnement par défaut dans le répertoire actuel de l'application. Avec un *environment-name* argument, les commandes répertorient ou modifient les balises de cet environnement. Avec l'option `--resource`, les commandes listent ou modifient les balises de n'importe quelle ressource Elastic Beanstalk – une application, un environnement, une version d'application, une configuration enregistrée, ou une version de plateforme personnalisée. Spécifiez la ressource par son Amazon Resource Name (ARN).
## Options
Aucune de ces options n'est obligatoire. Si vous exécutez **eb create** sans aucune option, vous êtes invité à saisir ou à sélectionner une valeur pour chaque paramètre.
****
| Nom | Description |
| --- | --- |
| `-l` ou `--list` | Liste tous les balises qui sont actuellement appliquées à la ressource. |
| `-a key1=value1[,key2=value2 ...]` ou `--add key1=value1[,key2=value2 ...]` | Appliquez de nouvelles balises à la ressource. Spécifiez les balises sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. Vous ne pouvez pas spécifier les clés de balises existantes. Valeurs valides : consultez [Balisage de ressources ](applications-tagging-resources.md). |
| `-u key1=value1[,key2=value2 ...]` ou `--update key1=value1[,key2=value2 ...]` | Mettez à jour les valeurs des balises de ressources existantes. Spécifiez les balises sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. Vous devez spécifier les clés de balises existantes. Valeurs valides : consultez [Balisage de ressources ](applications-tagging-resources.md). |
| `-d key1[,key2 ...]` ou `--delete key1[,key2 ...]` | Supprimez des balises de ressources existantes. Spécifiez les balises sous la forme d'une liste de clés séparées par des virgules. Vous devez spécifier les clés de balises existantes. Valeurs valides : consultez [Balisage de ressources ](applications-tagging-resources.md). |
| `-r` *region* or `--region` *region* | L' Région AWS endroit dans lequel se trouve votre ressource. Par défaut : la région configuré par défaut. Pour obtenir la liste des valeurs que vous pouvez spécifier pour cette option, consultez [Points de terminaison et quotas AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) dans *Références générales AWS*. |
| `--resource ARN` | L'ARN de la ressource que la commande modifie ou pour laquelle elle répertorie les balises. Si elle n'est pas spécifiée, la commande fait référence à l'environnement spécifié (par défaut) de l'application du répertoire actuel. Valeurs valides : voir l'une des sous-rubriques [Balisage de ressources ](applications-tagging-resources.md) qui est spécifique à la ressource qui vous intéresse. Ces rubriques montrent comment l'ARN de la ressource est construit et expliquent comment obtenir une liste de ces ressources ARNs qui existent pour votre application ou votre compte. |
## Output
L'option de sous-commande `--list` affiche la liste des balises de la ressource. La sortie montre à la fois les balises qu'Elastic Beanstalk applique par défaut et vos balises personnalisées.
```
$ eb tags --list
Showing tags for environment 'MyApp-env':
Key Value
Name MyApp-env
elasticbeanstalk:environment-id e-63cmxwjaut
elasticbeanstalk:environment-name MyApp-env
mytag tagvalue
tag2 2nd value
```
Les options de sous-commande `--add`, `--update` et `--delete`, lorsqu'elles aboutissent, n'ont pas de sortie. Vous pouvez ajouter l'option `--verbose` pour voir la sortie détaillée de l'activité de la commande.
```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:
Key Value
mytag tag value
```
## Exemples
La commande suivante ajoute une balise avec succès avec la clé `tag1` et la valeur `value1` à l'environnement par défaut de l’application, et, dans le même temps, supprime la balise `tag2`.
```
$ eb tags --add tag1=value1 --delete tag2
```
La commande suivante ajoute une balise avec succès à une configuration enregistrée au sein d'une application.
```
$ eb tags --add tag1=value1 \
--resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
La commande suivante échoue, car elle essaie de mettre à jour une balise inexistante.
```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:
tag3
```
La commande suivante échoue, car elle essaie de mettre à jour et de supprimer la même clé.
```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```