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.
Si vous utilisez l'API AppStream 2.0, un AWS SDK 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 la AWS CLI, utilisez « \ s » (sans les guillemets).
| Tâche | AWS CLI | Opération API |
|---|---|---|
| Ajouter une ou plusieurs balise(s) à une nouvelle flotte | create-fleet | |
| Ajouter une ou plusieurs balise(s) à une nouvelle instance Image Builder | create-imagebuilder | |
| Ajouter une ou plusieurs balise(s) à une nouvelle pile |
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 | Opération API |
|---|---|---|
| Ajouter ou remplacer une ou plusieurs balise(s) pour une ressource | tag-resource | |
| Supprimer une ou plusieurs balise(s) d’une ressource | untag-resource | |
| Afficher une ou plusieurs balise(s) d’une ressource |
Lorsque vous utilisez l'API AppStream 2.0, un AWS SDK ou des actions AWS CLI pour ajouter, modifier, supprimer ou répertorier des balises pour une ressource AppStream 2.0 existante, spécifiez la ressource en utilisant son Amazon Resource Name (ARN). Un ARN identifie une AWS ressource de manière unique et utilise la syntaxe générale suivante.
arn:aws:appstream:region:account:resourceType/resourceNameregion-
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 l'ARN d'un parc AppStream 2.0 à l'aide de la AWS commande CLI describe-fleets. Copiez la commande ci-après.
aws appstream describe-fleets
Pour un environnement contenant une seule flotte nommée TestFleet, l’ARN de la ressource apparaît dans la sortie JSON sous une forme similaire à ce qui suit :
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"Après avoir obtenu l’ARN de la 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=ITLa 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/TestFleetDans cet exemple, la sortie JSON apparaît comme suit :
{
"Tags": {
"Environment" : "Test",
"Department" : "IT"
}
}