Balisage des ressources Amazon AppStream 2.0

AWS permet d'attribuer des métadonnées aux ressources AWS sous la forme de balises. Vous pouvez utiliser les balises pour faciliter la gestion des instances Image Builder AppStream 2.0, des images, des flottes et des piles, ainsi que l'organisation des données, y compris celles de la facturation.

Vous pouvez :

• Regrouper de manière logique les ressources de différentes façons (par objectif, par propriétaire ou par environnement, par exemple).

  Cela est utile lorsque vous avez de nombreuses ressources du même type.

• Identifier rapidement une ressource en fonction des balises que vous lui avez attribuées.

• Identifier et contrôler les coûts AWS.

Par exemple, vous pouvez identifier et regrouper les flottes AppStream 2.0 se trouvant dans des environnements distincts (développement ou production, par exemple) ou attribués à des unités opérationnelles différentes (ressources humaines ou marketing, par exemple). Ensuite, vous pouvez suivre de façon détaillée les coûts AWS associés aux flottes. Pour ce faire, inscrivez-vous pour obtenir votre facture de compte Amazon Web Services avec les valeurs de clé de balise incluses. Pour plus d'informations sur la configuration d'un rapport de répartition des coûts avec les balises, consultez Rapport de répartition des coûts mensuels dans le Guide de l'utilisateur AWS Billing.

Principes de base du balisage

Les balises se composent d'une paire clé-valeur, similaire à celle des autres balises des services AWS. Pour baliser une ressource, associez une clé et une valeur à chaque balise. Une clé peut être une catégorie générale, telle que « projet », « propriétaire » ou « environnement », avec des valeurs associées spécifiques. Il est possible de partager une même clé et une même valeur sur plusieurs ressources. Vous pouvez baliser une ressource AppStream 2.0 immédiatement après sa création ou ultérieurement. Si vous supprimez une ressource, ses balises sont également supprimées. Cependant, les autres ressources AppStream 2.0 et AWS ayant la même clé de balise ne sont pas affectées.

Vous pouvez modifier les clés et les valeurs des balises ; de même, vous pouvez supprimer les balises d'une ressource à tout moment. Vous pouvez définir la valeur d'une balise avec une chaîne vide, mais vous ne pouvez pas définir son nom avec la valeur null. Si vous ajoutez une balise ayant la même clé qu'une balise existante sur la ressource, la nouvelle valeur remplace l'ancienne. Si vous supprimez une ressource, ses balises sont également supprimées.

Note

Si vous envisagez de configurer un rapport de répartition des coûts mensuels pour suivre les coûts AWS des ressources AppStream 2.0, n'oubliez pas que les balises ajoutées aux ressources AppStream 2.0 existantes apparaissent dans le rapport de répartition des coûts le premier du mois suivant pour les ressources renouvelées au cours du mois.

Restrictions liées aux balises

• Le nombre maximal de balises par ressource AppStream 2.0 est de 50.

• La longueur maximale de clé est de 128 caractères Unicode en UTF-8.

• La longueur maximale de valeur est de 256 caractères Unicode en UTF-8.

• Les clés et les valeurs des balises sont sensibles à la casse.

• N'utilisez pas le préfixe « aws: » dans les noms ou les valeurs des balises, car il s'agit d'une balise système réservée à AWS. Vous ne pouvez pas modifier ou supprimer les noms ou les valeurs de balise ayant ce préfixe. Les balises ayant ce préfixe ne sont pas comptabilisées en tant que telles dans le nombre limite de ressources.

• En général, les caractères autorisés sont les lettres, les chiffres et les espaces représentables en UTF-8, ainsi que les caractères spéciaux suivants : + - = . _ : / @.

• Bien que vous puissiez partager une même clé et une même valeur entre plusieurs ressources, vous ne pouvez pas dupliquer les clés sur une même ressource.

• Vous pouvez ajouter des balises à une ressource pendant sa création. Vous pouvez également ajouter, modifier et supprimer les balises de ressources déjà créées.

Ajout de balises pendant la création des ressources dans la console AppStream 2.0

Lorsque vous créez une ressource dans la console AppStream 2.0, vous pouvez ajouter une ou plusieurs balises pour la gérer. Pour plus d'informations, consultez les rubriques suivantes :

• Instances Image Builder – Lancer un Image Builder pour l'installation et la configuration d'applications de streaming, étape 4

• Images – Étape 6 : Terminer la création de l'image, étape 1

• Flottes – Création d'une flotte, étape 3

• Piles – Créez une pile, étape 2

Ajout, modification et suppression des balises de ressources existantes dans la console AppStream 2.0

Vous pouvez ajouter, modifier et supprimer les balises de ressources existantes à l'aide de la console AppStream 2.0.

Pour ajouter, modifier ou supprimer les balises d'une ressource AppStream 2.0 existante

1. Ouvrez la console AppStream 2.0 à l'adresse https://console.aws.amazon.com/appstream2.

2. Dans la barre de navigation, sélectionnez la région contenant la ressource pour laquelle vous voulez ajouter, modifier ou supprimer des balises.

3. Dans le volet de navigation, sélectionnez le type de ressource. Le type de ressource peut être une instance Image Builder, une image, une flotte ou une pile.

4. Sélectionnez la ressource dans la liste des ressources.

5. Choisissez Balises, Ajouter/modifier des balises, puis exécutez une ou plusieurs des actions suivantes :

   • Pour ajouter une balise, sélectionnez Ajouter une balise, puis tapez la clé et la valeur de chaque balise.

   • Pour modifier une balise, modifiez sa clé et sa valeur comme souhaité.

   • Pour supprimer une balise, choisissez l'icône de suppression (X) à côté de la balise.

6. Choisissez Enregistrer.

Gestion des balises à l'aide de l'API AppStream 2.0, d'un kit AWS SDK ou de l'interface de ligne de commande (CLI) AWS

Si vous utilisez l'API AppStream 2.0, un kit AWS SDK ou l'AWSinterface de ligne de commande (CLI) AWS, vous pouvez effectuer les opérations AppStream 2.0 suivantes avec le paramètre tags pour ajouter des balises lors de la création 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 l'interface de ligne de commande (CLI) AWS, utilisez « \s » (sans les guillemets).

Tâche	AWS CLI	Opération API
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 effectuer les opérations AppStream 2.0 suivantes pour ajouter, modifier, supprimer ou afficher des balises associées aux ressources existantes :

Tâche	AWS CLI	Opération API
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 l'API AppStream 2.0, un kit AWS SDK ou les actions de l'interface de ligne de commande (CLI) AWS pour ajouter, modifier, supprimer ou répertorier les balises d'une ressource AppStream 2.0 existante, indiquez cette dernière à l'aide de son Amazon Resource Name (ARN). Un ARN identifie de façon unique une ressource AWS et utilise la syntaxe générale suivante :

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

region

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

account

ID Compte AWS du compte sans trait d'union (123456789012, par exemple).

resourceType

Type de ressource. Vous pouvez baliser les types de ressources AppStream 2.0 suivants : image-builder, image, fleet et stack.

resourceName

Nom de la ressource.

Par exemple, vous pouvez obtenir l'ARN d'une flotte AppStream 2.0 en utilisant la commande describe-fleets de l'interface de ligne de commande (CLI) AWS. 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=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, la sortie JSON apparaît comme suit :

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