Utilisation de balises à l'aide d'Amazon AppStream 2.0 API AWS SDK, d'un ou AWS CLI - Amazon AppStream 2.0

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.

Utilisation de balises à l'aide d'Amazon AppStream 2.0 API AWS SDK, d'un ou AWS CLI

Si vous utilisez la AppStream version 2.0 API AWS SDK, une ou l'interface de ligne de AWS commande (AWS CLI), vous pouvez utiliser les opérations AppStream 2.0 suivantes avec le tags paramètre pour ajouter des balises lorsque vous créez de nouvelles ressources.

Note

Vous pouvez utiliser des espaces dans les clés et les valeurs des balises. Pour indiquer un espace lorsque vous utilisez le AWS CLI, utilisez « \ s » (sans les guillemets).

Tâche AWS CLI APIFonctionnement
Ajouter une ou plusieurs balise(s) à une nouvelle flotte create-fleet

CreateFleet
Ajouter une ou plusieurs balise(s) à une nouvelle instance Image Builder create-imagebuilder

CreateImageBuilder
Ajouter une ou plusieurs balise(s) à une nouvelle pile

create-stack

CreateStack

Vous pouvez utiliser les opérations AppStream 2.0 suivantes pour ajouter, modifier, supprimer ou répertorier des balises pour des ressources existantes :

Tâche AWS CLI APIFonctionnement
Ajouter ou remplacer une ou plusieurs balise(s) pour une ressource tag-resource

TagResource
Supprimer une ou plusieurs balise(s) d’une ressource untag-resource

UntagResource
Afficher une ou plusieurs balise(s) d’une ressource

list-tags-for-resource

ListTagsForResource

Lorsque vous utilisez les AWS CLI actions AppStream 2.0 API AWS SDK, an ou pour ajouter, modifier, supprimer ou répertorier les balises d'une ressource AppStream 2.0 existante, spécifiez la ressource en utilisant son Amazon Resource Name (ARN). An ARN identifie une AWS ressource de manière unique et utilise la syntaxe générale suivante.

arn:aws:appstream:region:account:resourceType/resourceName
region

AWS Région dans laquelle la ressource a été créée (par exemple,us-east-1).

account

L' Compte AWS identifiant, sans tiret (par exemple,123456789012).

resourceType

Type de ressource. Vous pouvez baliser les types de ressources AppStream 2.0 suivants : image-builderimage,fleet, etstack.

resourceName

Nom de la ressource.

Par exemple, vous pouvez obtenir le ARN pour une flotte AppStream 2.0 à l'aide de la commande AWS CLI describe-fleets. Copiez la commande ci-après.

aws appstream describe-fleets

Pour un environnement contenant une seule flotte nomméeTestFleet, le nom ARN de cette ressource apparaîtrait dans la JSON sortie de la même manière que ci-dessous. 

"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"

Après avoir obtenu le ARN pour cette ressource, vous pouvez ajouter deux balises à l'aide de la commande tag-resource : 

aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT

La première balise, Environment=Test, indique que la flotte se trouve dans un environnement de test. La seconde balise, Department=IT, indique que la flotte se trouve dans le service informatique.

Vous pouvez utiliser la commande suivante pour afficher les deux balises ajoutées à la flotte.

aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet

Dans cet exemple, le JSON résultat apparaît comme suit : 

{
    "Tags": {
       "Environment" : "Test",
       "Department" : "IT"
    }
}