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.
# Marquer les ressources de vos WorkSpaces applications Amazon
AWS vous permet d'attribuer des métadonnées à vos AWS ressources sous forme de balises. Vous pouvez utiliser ces balises pour gérer les générateurs d'images, les images, les flottes et les piles de vos WorkSpaces applications, ainsi que pour organiser les données, y compris les données de facturation.
Vous pouvez effectuer les actions suivantes :
+ 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 AWS les coûts
Par exemple, vous pouvez identifier et regrouper les flottes d' WorkSpaces applications qui se trouvent dans différents environnements (tels que le développement ou la production) ou qui sont attribuées à différentes unités commerciales (telles que les ressources humaines ou le marketing). Vous pouvez ensuite suivre les AWS coûts associés à ces flottes de manière détaillée. 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) dans le *Guide de l’utilisateur AWS Billing *.
**Topics**
+ [Principes de base du balisage](tagging-introduction.md)
+ [Restrictions liées aux balises](tag-restrictions.md)
+ [Ajouter des balises lors de la création de ressources](basic-tagging-resource-creation-console.md)
+ [Ajouter, modifier et supprimer des balises](basic-tagging-console.md)
+ [Utilisation de l'API, du SDK ou de la CLI](basic-tagging-API-SDK-CLI.md)
# Principes de base du balisage pour les applications Amazon WorkSpaces
Les balises se composent d'une paire clé-valeur, comme les autres balises de AWS services. 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 étiqueter une ressource WorkSpaces Applications immédiatement après l'avoir créée ou ultérieurement. Si vous supprimez une ressource, ses balises sont également supprimées. Toutefois, WorkSpaces les autres applications et AWS ressources qui ont 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 mensuel de répartition des AWS coûts pour suivre les coûts des ressources des WorkSpaces applications, n'oubliez pas que les balises ajoutées aux ressources des WorkSpaces applications existantes apparaissent dans votre rapport de répartition des coûts le premier du mois suivant pour les ressources renouvelées au cours du mois en question.
# Restrictions relatives aux balises pour les WorkSpaces applications Amazon
+ Le nombre maximum de balises par ressource WorkSpaces Applications est de 50.
+ La longueur maximale de la clé est de 128 caractères Unicode en UTF-8.
+ La longueur maximale de la 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 de vos balises, car il s'agit d'une balise système réservée à AWS l'usage. 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 : \$1 - = . \$1 : / @.
+ 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 lors de la création de ressources dans la console Amazon WorkSpaces Applications
Lorsque vous créez une ressource dans la console WorkSpaces Applications, vous pouvez ajouter une ou plusieurs balises pour gérer la ressource. 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](tutorial-image-builder-create.md), étape 4
+ Images – [Étape 6 : terminer la création de l’image](tutorial-image-builder.md#tutorial-image-builder-finish-create-image), étape 1
+ Flottes – [Création d'une flotte dans Amazon WorkSpaces Applications](set-up-stacks-fleets-create.md), étape 3
+ Piles – [Création d'une pile dans Amazon WorkSpaces Applications](set-up-stacks-fleets-install.md), étape 2
# Ajouter, modifier et supprimer des balises pour les ressources existantes dans Amazon WorkSpaces Applications Console
Vous pouvez ajouter, modifier et supprimer des balises pour les ressources existantes à l'aide de la console WorkSpaces Applications.
**Pour ajouter, modifier ou supprimer des balises pour une ressource d' WorkSpaces applications existante**
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Dans la barre de navigation, sélectionnez la région contenant la ressource pour laquelle vous voulez ajouter, modifier ou supprimer des balises.
1. 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.
1. Sélectionnez la ressource dans la liste des ressources.
1. 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.
1. Choisissez **Enregistrer**.
# Utilisation des balises à l'aide de l'API Amazon WorkSpaces Applications, d'un AWS SDK ou AWS d'une CLI
Si vous utilisez l'API WorkSpaces Applications, un AWS SDK ou l'interface de ligne de AWS commande (AWS CLI), vous pouvez utiliser les opérations d' WorkSpaces applications 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 « \$1 s » (sans les guillemets).
| Sous-tâche | AWS CLI | Opération API |
| --- | --- | --- |
| Ajouter une ou plusieurs balise(s) à une nouvelle flotte | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html) | [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags) |
| Ajouter une ou plusieurs balise(s) à une nouvelle instance Image Builder | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) | [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags) |
| Ajouter une ou plusieurs balise(s) à une nouvelle pile | [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html) | [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags) |
Vous pouvez utiliser les opérations d' WorkSpaces applications suivantes pour ajouter, modifier, supprimer ou répertorier les balises des ressources existantes :
| Sous-tâche | AWS CLI | Opération API |
| --- | --- | --- |
| Ajouter ou remplacer une ou plusieurs balise(s) pour une ressource | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) | [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html) |
| Supprimer une ou plusieurs balise(s) d’une ressource | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) | [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html) |
| Afficher une ou plusieurs balise(s) d’une ressource | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html) | [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html) |
Lorsque vous utilisez l'API WorkSpaces Applications, un AWS SDK ou des actions AWS CLI pour ajouter, modifier, supprimer ou répertorier des balises pour une ressource WorkSpaces Applications 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/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 d' WorkSpaces applications suivants : `image-builder``image`,`fleet`, et`stack`.
***resourceName***
Nom de la ressource.
Par exemple, vous pouvez obtenir l'ARN d'un parc d' WorkSpaces applications à l'aide de la AWS commande CLI [describe-fleets](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html). 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](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) :
```
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"
}
}
```