Balisage de vos ressources AWS Batch

Pour vous aider à gérer vos ressources AWS Batch, vous pouvez attribuer vos propres métadonnées à chaque ressource sous la forme de balises. Cette rubrique décrit les balises et vous explique comment les créer.

Principes de base des balises

Une balise est une étiquette que vous affectez à une ressource AWS. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.

Les balises vous permettent de classer vos ressources AWS par catégorie, objectif, propriétaire ou environnement, par exemple. 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 services AWS Batch afin de vous aider à 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 pas de signification sémantique pour 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 gérer les balises à l'aide de la AWS Management Console, de l'AWS CLI et de l'API AWS Batch.

Si vous utilisez AWS Identity and Access Management (IAM), vous pouvez contrôler quels utilisateurs de votre compte AWS sont autorisés à créer, modifier ou supprimer des étiquettes.

Balisage de 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 console AWS Batch, vous pouvez appliquer des balises aux nouvelles ressources au moment de leur création ou aux ressources existantes à l'aide de l'onglet Tags (Balises) de la page de ressources correspondante à tout moment.

Si vous utilisez l'API AWS Batch, l'AWS CLI ou un kit AWS SDK, vous pouvez appliquer les balises aux nouvelles ressources à l'aide du paramètre tags sur l'action d'API correspondante ou utiliser l'action d'API TagResource. Pour plus d'informations, consultez TagResource.

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 ressources AWS Batch qui peuvent porter des balises, et les ressources qui peuvent porter des balises dès la création.

Prise en charge du balisage pour les ressources AWS Batch
Ressource	Prend en charge les étiquettes	Prend en charge la propagation des étiquettes	Prend en charge le balisage au moment de la création (API AWS Batch, AWS CLI, kit AWS SDK)
AWS Batchenvironnements 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'CreateComputeEnvironmentAPI.	Oui
AWS Batch tâches	Oui	Oui	Oui
AWS Batchdéfinitions de poste	Oui	Non	Oui
Files d'attente de tâches AWS Batch	Oui	Non	Oui
AWS Batchpolitiques 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 services et ressources AWS, n'oubliez pas que d'autres services peuvent avoir des restrictions concernant les 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 : + - = . _ : / @.

• Les clés et valeurs de balise sont sensibles à la casse.

• N'utilisez pas aws:, AWS:, ou n'importe quelle combinaison de majuscules ou minuscules comme préfixe pour des clés ou des valeurs, car il est réservé à 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.

Gestion des étiquettes à 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.

Ajout de balises sur une ressource individuelle lors de la 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.

Ajout et suppression de balises sur une ressource individuelle

AWS Batch permet d'ajouter ou de supprimer des balises associées à vos clusters directement à partir de 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/.

2. Dans la barre de navigation, choisissez la région à utiliser.

3. Dans le volet de navigation, choisissez un type de ressource (par exemple, Job Queues).

4. Choisissez une ressource spécifique, puis choisissez Modifier les balises.

5. Ajoutez ou supprimez vos tags si nécessaire.

   • 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, cliquez sur le bouton situé à côté du tag.

6. Répétez cette procédure pour chaque balise que vous souhaitez ajouter ou supprimer, puis choisissez Modifier les balises pour terminer.

Gestion des balises à l'aide de la CLI ou de l'API

Utilisez les commandes AWS CLI suivantes ou les opérations d'API AWS Batch pour ajouter, mettre à jour, répertorier et supprimer les balises de vos ressources.

Prise en charge du balisage pour les ressources AWS Batch
Tâche	Action d’API	AWS CLI	AWS Tools for Windows PowerShell
Ajouter ou remplacer une ou plusieurs étiquettes.	TagResource	tag-resource	Ajouter un chauve-souris ResourceTag
Supprimer une ou plusieurs étiquettes.	UntagResource	untag-resource	Supprimer le chauve-souris ResourceTag
Répertorie les balises d'une ressource.	ListTagsForResource	list-tags-for-resource	Get-bat ResourceTag

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	create-compute-environment	Nouvelle chauve-souris ComputeEnvironment
Création d'une file d'attente de tâches	CreateJobQueue	create-job-queue	Nouvelle chauve-souris JobQueue
Création d'une politique de planification	CreateSchedulingPolicy	create-scheduling-policy	Nouvelle chauve-souris SchedulingPolicy
Enregistrer une définition de tâche	RegisterJobDefinition	register-job-definition	Enregistrer un BAT JobDefinition
Envoi d’une tâche	SubmitJob	soumet-job	Soumets-BatJob