eb tags - AWS Elastic Beanstalk
DescriptionSyntaxeOptionsSortieExemples

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.

Syntaxe

eb tags [environment-name] [--resource ARN] -l | --list

eb tags [environment-name] [--resource ARN] -a | --add key1=value1[,key2=value2 ...]

eb tags [environment-name] [--resource ARN] -u | --update key1=value1[,key2=value2 ...]

eb tags [environment-name] [--resource ARN] -d | --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 argument environment-name, les commandes listent 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 .

-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 .

-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 .

-r région

ou

--region région

Région Région AWS dans laquelle votre ressource existe.

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 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 qui est spécifique à la ressource qui vous intéresse. Ces rubriques expliquent comment la ressource de l'ARN est construite et expliquent comment obtenir une liste d'ARN de cette ressource qui existent pour votre application ou votre compte.

Sortie

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.