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.
# Marquez vos AWS Batch ressources
Pour vous aider à gérer vos AWS Batch ressources, vous pouvez attribuer vos propres métadonnées à chaque ressource sous forme de *balises*. Cette rubrique décrit les identifications et explique comment les créer.
**Topics**
+ [Principes de base des étiquettes](tag-basics.md)
+ [Baliser vos ressources](tag-resources.md)
+ [Restrictions liées aux étiquettes](tag-restrictions.md)
+ [Tutoriel : Gérer les tags à l'aide de la console](tag-resources-console.md)
+ [Gérez les balises à l'aide de la CLI ou de l'API](tag-resources-api-sdk.md)
# Principes de base des étiquettes
Une étiquette est une étiquette que vous attribuez à une AWS ressource. Chaque balise est constituée d’une *clé* et d’une *valeur* facultative que vous définissez.
Les balises vous permettent de classer vos AWS ressources en fonction, par exemple, de leur objectif, de leur propriétaire ou de leur environnement. Lorsque vous avez de nombreuses ressources de même type, vous pouvez rapidement identifier une ressource spécifique en fonction des balises que vous lui avez attribuées. Par exemple, vous pouvez définir un ensemble de balises pour vos AWS Batch services afin de suivre le propriétaire et le niveau de pile de chaque service. Nous vous recommandons de concevoir un ensemble cohérent de clés de balise pour chaque type de ressource.
Les balises ne sont pas automatiquement affectées à vos ressources. Une fois que vous avez ajouté une balise, vous pouvez modifier les clés et valeurs de balise ou supprimer les balises d'une ressource à tout moment. Si vous supprimez une ressource, ses balises sont également supprimées.
Les balises n'ont aucune signification sémantique AWS Batch et sont interprétées strictement comme des chaînes de caractères. Vous pouvez définir la valeur d’une balise sur une chaîne vide, mais vous ne pouvez pas définir la valeur d’une balise sur null. Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur.
Vous pouvez travailler avec des balises à l'aide de l'API AWS Management Console AWS CLI, du et de l' AWS Batch API.
Si vous utilisez Gestion des identités et des accès AWS (IAM), vous pouvez contrôler quels utilisateurs de votre AWS compte sont autorisés à créer, modifier ou supprimer des tags.
# Baliser vos ressources
Vous pouvez étiqueter des environnements AWS Batch informatiques, des tâches, des définitions de tâches, des files d'attente de tâches et des politiques de planification nouveaux ou existants.
Si vous utilisez la AWS Batch console, vous pouvez appliquer des balises aux nouvelles ressources lors de leur création ou aux ressources existantes à tout moment à l'aide de l'onglet **Tags** de la page de ressources correspondante.
Si vous utilisez l' AWS Batch API, le ou un AWS SDK AWS CLI, vous pouvez appliquer des balises aux nouvelles ressources à l'aide du `tags` paramètre de l'action d'API correspondante ou aux ressources existantes à l'aide de l'action d'`TagResource`API. Pour de plus amples informations, veuillez consulter [TagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html).
En outre, certaines actions de création de ressources vous permettent de spécifier des balises pour une ressource lors de la création de cette dernière. Si des balises ne peuvent pas être appliquées au cours de la création de ressources, le processus de création de ressources échoue. Cela garantit que les ressources que vous vouliez baliser lors de la création sont créées avec des balises spécifiées ou ne sont pas créées du tout. Si vous balisez des ressources au moment de la création, vous n'avez pas besoin d'exécuter de scripts de balisage personnalisés après la création des ressources.
Le tableau suivant décrit les AWS Batch ressources qui peuvent être balisées et les ressources qui peuvent être balisées lors de leur création.
**Tag : support pour les AWS Batch ressources**
| Ressource | Prend en charge les étiquettes | Prend en charge la propagation des étiquettes | Supporte le balisage lors de la création (AWS Batch API AWS CLI, AWS SDK) |
| --- | --- | --- | --- |
| AWS Batch environnements informatiques | Oui | Non. Les balises d'environnement de calcul ne se propagent à aucune autre ressource. Les balises des ressources sont spécifiées dans les balises membres de l'objet ComputerResources transmises lors de l'opération d'[CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html)API. | Oui |
| AWS Batch emplois | Oui | Oui | Oui |
| AWS Batch définitions de poste | Oui | Non | Oui |
| AWS Batch files d'attente pour les emplois | Oui | Non | Oui |
| AWS Batch politiques de planification | Oui | Non | Oui |
# Restrictions liées aux étiquettes
Les restrictions de base suivantes s’appliquent aux balises :
+ Nombre maximal de balises par ressource : 50
+ Pour chaque ressource, chaque clé de balise doit être unique, et chaque clé de balise peut avoir une seule valeur.
+ Longueur de clé maximale : 128 caractères Unicode en UTF-8
+ Longueur de valeur maximale : 256 caractères Unicode en UTF-8
+ Si votre schéma de balisage est utilisé pour plusieurs AWS services et ressources, n'oubliez pas que d'autres services peuvent imposer des restrictions quant aux caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres et les espaces représentables en UTF-8, ainsi que les caractères suivants : \$1 - = . \$1 : / @.
+ Les clés et valeurs de balise sont sensibles à la casse.
+ N'utilisez pas `aws:``AWS:`, ni aucune combinaison majuscules ou minuscules, comme un préfixe pour les clés ou les valeurs, car il est réservé à l'usage. AWS Vous ne pouvez pas modifier ni supprimer des clés ou valeurs d’étiquette ayant ce préfixe. Les balises comportant ce préfixe ne sont pas prises en compte dans votre tags-per-resource limite.
# Tutoriel : Gérer les tags à l'aide de la console
À l'aide de la AWS Batch console, vous pouvez gérer les balises associées aux environnements informatiques, aux tâches, aux définitions de tâches et aux files d'attente de tâches nouveaux ou existants.
## Ajouter des balises sur une ressource individuelle lors de sa création
Vous pouvez ajouter des balises aux environnements AWS Batch informatiques, aux tâches, aux définitions de tâches, aux files d'attente de tâches et aux politiques de planification lorsque vous les créez.
## Ajouter et supprimer des balises pour une ressource individuelle
AWS Batch vous permet d'ajouter ou de supprimer des balises associées à vos clusters directement depuis la page de la ressource.
**Pour ajouter ou supprimer une balise sur une ressource individuelle**
1. Ouvrez la AWS Batch console à l'adresse [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. Dans la barre de navigation, choisissez la région à utiliser.
1. Dans le volet de navigation, choisissez un type de ressource (par exemple, **Job Queues**).
1. Choisissez une ressource spécifique, puis choisissez **Modifier les balises**.
1. Ajoutez ou supprimez vos balises selon vos besoins.
+ Pour ajouter une balise, spécifiez la clé et la valeur dans les zones de texte vides à la fin de la liste.
+ Pour supprimer un tag, ![\[\]](http://docs.aws.amazon.com/fr_fr/batch/latest/userguide/images/DeleteIcon.png) cliquez sur le bouton situé à côté du tag.
1. Répétez cette procédure pour chaque balise que vous souhaitez ajouter ou supprimer, puis choisissez **Modifier les balises** pour terminer.
# Gérez les balises à l'aide de la CLI ou de l'API
Utilisez les AWS CLI commandes ou opérations d' AWS Batch API suivantes pour ajouter, mettre à jour, répertorier et supprimer les balises de vos ressources.
**Tag : support pour les AWS Batch ressources**
| Tâche | Action d’API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Ajouter ou remplacer une ou plusieurs étiquettes. | [TagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/tag-resource.html) | [Ajouter une BATResource étiquette](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-BATResourceTag.html) |
| Supprimer une ou plusieurs étiquettes. | [UntagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/untag-resource.html) | [Supprimer- BATResource Tag](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-BATResourceTag.html) |
| Répertorie les balises d'une ressource. | [ListTagsForResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/list-tags-for-resource.html) | [Obtenir le BATResource tag](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-BATResourceTag.html) |
Les exemples suivants montrent comment ajouter ou supprimer les étiquettes d'une ressource à l'aide de l' AWS CLI.
**Exemple 1 : Baliser une ressource existante**
La commande suivante permet de baliser une ressource existante.
```
aws batch tag-resource --resource-arn resource_ARN --tags team=devs
```
**Exemple 2 : Supprimer la balise d'une ressource existante**
La commande suivante permet de supprimer une balise d'une ressource existante.
```
aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**Exemple 3 : Afficher la liste des balises d'une ressource**
La commande suivante permet de répertorier l'ensemble des étiquettes associées à une ressource existante.
```
aws batch list-tags-for-resource --resource-arn resource_ARN
```
Certaines actions de création de ressources vous permettent de spécifier des étiquettes lorsque vous créez la ressource. Les actions suivantes prennent en charge l'identification lors de la création.
| Tâche | Action d’API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Création d'un environnement informatique | [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) | [create-compute-environment](https://docs.aws.amazon.com/cli/latest/reference/batch/create-compute-environment.html) | [Nouvel BATCompute environnement](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATComputeEnvironment.html) |
| Création d'une file d'attente de tâches | [CreateJobQueue](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateJobQueue.html) | [create-job-queue](https://docs.aws.amazon.com/cli/latest/reference/batch/create-job-queue.html) | [Nouveau- BATJob File d'attente](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATJobQueue.html) |
| Création d'une politique de planification | [CreateSchedulingPolicy](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateSchedulingPolicy.html) | [create-scheduling-policy](https://docs.aws.amazon.com/cli/latest/reference/batch/create-scheduling-policy.html) | [Nouveau- BATScheduling Politique](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATSchedulingPolicy.html) |
| Enregistrer une définition de tâche | [RegisterJobDefinition](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html) | [register-job-definition](https://docs.aws.amazon.com/cli/latest/reference/batch/register-job-definition.html) | [S'inscrire - BATJob Définition](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-BATJobDefinition.html) |
| Envoi d’une tâche | [SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html) | [soumet-job](https://docs.aws.amazon.com/cli/latest/reference/batch/submit-job.html) | [Soumettre- BATJob](https://docs.aws.amazon.com/powershell/latest/reference/items/Submit-BATJob.html) |
| Création d'une ressource consommable | [CreateConsumableResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateConsumableResource.html) | [create-consumable-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/create-consumable-resource.html) | [Créer une BATConsumable ressource](https://docs.aws.amazon.com/powershell/latest/reference/items/Create-BATConsumableResource.html) |