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 et classer les ressources du cluster Amazon EMR
Il peut être pratique de classer vos AWS ressources de différentes manières, par exemple par objectif, propriétaire ou environnement. Vous pouvez effectuer cela dans Amazon EMR en affectant des métadonnées personnalisées pour vos clusters Amazon EMR à l'aide de balises. Une identification est constituée d’une clé et d’une valeur que vous définissez. Pour Amazon EMR, le cluster est le niveau de ressource que vous pouvez baliser. Par exemple, vous pouvez définir un ensemble de balises pour les clusters de votre compte, afin de suivre le propriétaire de chaque cluster ou d'identifier un cluster de production par rapport à un cluster de test. Nous vous recommandons de créer un ensemble de balises cohérent pour répondre aux exigences de votre organisation.
Lorsque vous ajoutez une balise à un cluster Amazon EMR, la balise est également propagée à chaque instance Amazon EC2 active associée au cluster. De même, lorsque vous supprimez une balise d'un cluster Amazon EMR, cette balise est supprimée de chaque instance Amazon EC2 active associée.
**Important**
Utilisez la console ou l'interface de ligne de commande Amazon EMR pour gérer les balises sur les instances Amazon EC2 qui font partie d'un cluster plutôt que la console ou l'interface de ligne de commande Amazon EC2, car les modifications que vous effectuez dans Amazon EC2 ne sont pas synchronisées dans le système de balisage Amazon EMR.
Vous pouvez identifier une instance Amazon EC2 faisant partie d'un cluster Amazon EMR en recherchant les balises système suivantes. Dans cet exemple, *CORE* il s'agit de la valeur du rôle du groupe d'instances et *j-12345678* d'un exemple de valeur d'identifiant de flux de travail (cluster) :
+ aws:elasticmapreduce : = instance-group-role *CORE*
+ aws:elasticmapreduce : = job-flow-id *j-12345678*
**Note**
Amazon EMR et Amazon EC2 interprètent vos balises comme une chaîne de caractères sans signification sémantique.
Vous pouvez travailler avec des balises à l' AWS Management Console aide de la CLI et de l'API.
Vous pouvez ajouter des balises lors de la création d'un cluster Amazon EMR et vous pouvez ajouter, modifier ou supprimer des balises d'un cluster Amazon EMR en cours d'exécution. Le concept de modification d'une balise s'applique à la console Amazon EMR. En revanche, si vous utilisez l'interface de ligne de commande et l'API, la modification consiste à supprimer l'ancienne balise et en ajouter une nouvelle. Vous pouvez modifier les clés et valeurs de balise, et vous pouvez supprimer des balises d'une ressource à tout moment pendant l'exécution d'un cluster. Cependant, vous ne pouvez pas ajouter, modifier ou supprimer des balises à partir d'un cluster hors service ou d'instances hors service qui étaient précédemment associées à un cluster qui est toujours actif. Vous pouvez également 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 utilisez Gestion des identités et des accès AWS (IAM) avec vos instances Amazon EC2 pour obtenir des autorisations basées sur les ressources par balise, vos politiques IAM sont appliquées aux balises qu'Amazon EMR propage aux instances Amazon EC2 d'un cluster. Pour que les balises Amazon EMR puissent se propager à vos instances Amazon EC2, votre politique IAM pour Amazon EC2 doit autoriser les appels à Amazon EC2 et aux API. CreateTags DeleteTags En outre, les balises propagées peuvent avoir une incidence sur les autorisations basées sur les ressources d'Amazon EC2. Les balises propagées vers Amazon EC2 peuvent être lues en tant que conditions dans votre politique IAM, tout comme les autres balises Amazon EC2. Gardez votre politique IAM à l'esprit lorsque vous ajoutez des balises à vos clusters Amazon EMR afin d'éviter qu'un utilisateur ne dispose d'autorisations incorrectes pour un cluster. Pour éviter les problèmes, assurez-vous que vos politiques IAM n'incluent pas de conditions sur les balises que vous prévoyez également d'utiliser sur vos clusters Amazon EMR. Pour plus d'informations, consultez [Contrôle de l'accès aux ressources Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UsingIAM.html).
# Restrictions applicables au balisage des ressources dans Amazon EMR
Les restrictions de base suivantes s’appliquent aux balises :
+ Les restrictions qui s'appliquent aux ressources Amazon EC2 s'appliquent également à Amazon EMR. Pour de plus amples informations, veuillez consulter [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions).
+ N'utilisez pas le `aws:` préfixe dans les noms et les valeurs des balises, car il est réservé à AWS l'usage. De même, vous ne pouvez pas modifier ni supprimer des noms ou valeurs de balise ayant ce préfixe.
+ Vous ne pouvez pas changer ou modifier les balises d'un cluster arrêté.
+ Une valeur de balise peut être une chaîne vide, mais pas null. En outre, une clé de balise ne peut pas être une chaîne vide.
+ Les clés et les valeurs peuvent contenir tout caractère alphabétique dans n'importe quelle langue, tout caractère numérique, espace blanc, séparateur invisible et les symboles suivants : \$1 . : / = \$1 - @
Pour plus d'informations sur le balisage à l'aide du AWS Management Console, consultez la section [Utilisation des balises dans la console](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_Console) dans le guide de l'*utilisateur Amazon EC2*. Pour plus d'informations sur le balisage à l'aide de l' EC2API ou de la ligne de commande Amazon, consultez la [présentation de l'API et de la CLI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) dans le guide de l'*utilisateur Amazon EC2*.
# Étiquetez les ressources Amazon EMR pour la facturation
Vous pouvez utiliser des balises pour organiser votre AWS facture afin de refléter votre propre structure de coûts. Pour ce faire, inscrivez-vous pour obtenir la facture de votre AWS compte avec les valeurs clés du tag incluses. Vous pouvez organiser vos informations de facturation par valeurs de clé de balise pour voir le coût de vos ressources combinées. Bien qu'Amazon EMR et Amazon EC2 aient des relevés de facturation différents, les balises sur chaque cluster sont également placées sur chaque instance associée afin que vous puissiez utiliser des balises pour lier les coûts Amazon EMR et Amazon EC2 associés.
Par exemple, vous pouvez baliser plusieurs ressources avec un nom d’application spécifique, puis organiser vos informations de facturation pour afficher le coût total de cette application dans plusieurs services. Pour plus d'informations, consultez la section [Allocation des coûts et balisage](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation.html) dans le *Guide de l'utilisateur de AWS Billing *.
# Ajouter des balises à un cluster Amazon EMR
Vous pouvez ajouter des balises à un cluster lorsque vous le créez.
------
#### [ Console ]
**Pour ajouter des balises lorsque vous créez un cluster avec la nouvelle console.**
1. [Connectez-vous au et ouvrez la AWS Management Console console Amazon EMR à l'adresse /emr. https://console.aws.amazon.com](https://console.aws.amazon.com/emr)
1. Sous **EMR sur EC2** dans le volet de navigation de gauche, choisissez **Clusters**, puis **Créer un cluster**.
1. Sous **Balises**, choisissez **Ajouter une nouvelle balise**. Spécifiez une balise dans le champ **Clé**. Vous pouvez également spécifier une balise dans le champ **Valeur**.
1. Choisissez toutes les autres options qui s'appliquent à votre cluster.
1. Pour lancer cluster, choisissez **Créer un cluster**.
------
#### [ AWS CLI ]
**Pour ajouter des balises lorsque vous créez un cluster avec le AWS CLI**
L'exemple suivant montre comment ajouter une balise à un nouveau cluster à l'aide de l' AWS CLI. Pour ajouter des balises lors de la création d'un cluster, saisissez la sous-commande `create-cluster` avec le paramètre `--tags`.
+ Pour ajouter une balise nommée *costCenter* avec une valeur clé *marketing* lorsque vous créez un cluster, tapez la commande suivante et remplacez-la *myKey* par le nom de votre paire de clés EC2.
```
aws emr create-cluster --name "Test cluster" --release-label emr-4.0.0 --applications Name=Hadoop Name=Hive Name=Pig --tags "costCenter=marketing" --use-default-roles --ec2-attributes KeyName=myKey --instance-type m5.xlarge --instance-count 3
```
Lorsque vous spécifiez le nombre d'instances sans utiliser le paramètre `--instance-groups`, un seul nœud principal est lancé et les instances restantes sont lancées en tant que nœuds principaux. Tous les nœuds utiliseront le type d'instance spécifié dans la commande.
**Note**
Si vous n'avez pas encore créé le rôle de service EMR par défaut et le profil d'instance EC2, tapez aws `emr create-default-roles` pour les créer avant de taper la sous-commande `create-cluster`.
Pour plus d'informations sur l'utilisation des commandes Amazon EMR dans le AWS CLI, consultez. [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)
------
Vous pouvez également ajouter des balises à un cluster existant.
------
#### [ Console ]
**Pour ajouter des balises à un cluster existant avec la nouvelle console**
1. [Connectez-vous au et ouvrez la AWS Management Console console Amazon EMR à l'adresse /emr. https://console.aws.amazon.com](https://console.aws.amazon.com/emr)
1. Sous **EMR sur EC2**, dans le volet de navigation de gauche, choisissez **Clusters**, puis sélectionnez le cluster que vous souhaitez mettre à jour.
1. Dans l'onglet **Balises** de la page de détails du cluster, sélectionnez **Gérer les balises**. Spécifiez une balise dans le champ **Clé**. Vous pouvez également spécifier une balise dans le champ **Valeur**.
1. Cliquez sur **Enregistrer les modifications**. L'onglet **Balises** est mis à jour avec le nouveau nombre de balises que vous avez sur votre cluster. Par exemple, si vous avez maintenant deux balises, la balise de votre onglet est **Balises (2)**.
------
#### [ AWS CLI ]
**Pour ajouter des balises à un cluster en cours d'exécution à l'aide du AWS CLI**
+ Entrez la sous-commande `add-tags` avec le paramètre `--tag` pour attribuer des balises à l'ID du cluster. Vous pouvez trouver l'ID du cluster en utilisant la console ou la commande `list-clusters`. Actuellement, la sous-commande `add-tags` n'accepte qu'un ID de ressource.
Par exemple, pour ajouter deux balises à un cluster en cours d'exécution, l'une avec une clé nommée *costCenter* avec la valeur de *marketing* et l'autre *other* avec une valeur de*accounting*, entrez la commande suivante et remplacez-la par *j-KT4XXXXXXXX1NM* votre ID de cluster.
```
aws emr add-tags --resource-id j-KT4XXXXXXXX1NM --tag "costCenter=marketing" --tag "other=accounting"
```
Notez que lorsque des balises sont ajoutées à l'aide de la AWS CLI, la commande ne produit aucun résultat. Pour plus d'informations sur l'utilisation des commandes Amazon EMR dans le AWS CLI, consultez. [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)
------
# Afficher les balises sur un cluster Amazon EMR
Si vous voulez voir toutes les balises associées à un cluster, vous pouvez les afficher avec la console ou l' AWS CLI.
------
#### [ Console ]
**Pour afficher les balises d'un cluster avec la nouvelle console**
1. [Connectez-vous au et ouvrez la AWS Management Console console Amazon EMR à l'adresse /emr. https://console.aws.amazon.com](https://console.aws.amazon.com/emr)
1. Sous **EMR sur EC2**, dans le volet de navigation de gauche, choisissez **Clusters**, puis sélectionnez le cluster que vous souhaitez mettre à jour.
1. Pour afficher tous vos balises, sélectionnez l'onglet **Balises** sur la page des détails du cluster.
------
#### [ AWS CLI ]
**Pour afficher les balises d'un cluster avec AWS CLI**
Pour afficher les balises d'un cluster à l'aide de AWS CLI, tapez la `describe-cluster` sous-commande avec le `--query` paramètre.
+ Pour afficher les balises d'un cluster, tapez la commande suivante et remplacez-la *j-KT4XXXXXXXX1NM* par votre ID de cluster.
```
1. aws emr describe-cluster --cluster-id j-KT4XXXXXX1NM --query Cluster.Tags
```
La sortie affiche toutes les informations de balises sur le cluster, sous une forme similaire à celle-ci :
```
Value: accounting Value: marketing
Key: other Key: costCenter
```
Pour plus d'informations sur l'utilisation des commandes Amazon EMR dans le AWS CLI, consultez. [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)
------
# Supprimer des balises d'un cluster Amazon EMR
Si vous n'avez plus besoin une balise, vous pouvez la supprimer du cluster.
------
#### [ Console ]
**Pour supprimer les balises d'un cluster avec la nouvelle console**
1. [Connectez-vous au et ouvrez la AWS Management Console console Amazon EMR à l'adresse /emr. https://console.aws.amazon.com](https://console.aws.amazon.com/emr)
1. Sous **EMR sur EC2**, dans le volet de navigation de gauche, choisissez **Clusters**, puis sélectionnez le cluster que vous souhaitez mettre à jour.
1. Dans l'onglet **Balises** de la page de détails du cluster, sélectionnez **Gérer les balises**.
1. Choisissez **Supprimer** pour chaque paire clé-valeur que vous souhaitez supprimer.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ AWS CLI ]
**Pour supprimer des balises sur un cluster à l'aide du AWS CLI**
Tapez la sous-commande `remove-tags` avec le paramètre `--tag-keys`. Lorsque vous supprimez une balise, seul le nom de la clé est requis.
+ Pour supprimer une balise d'un cluster, tapez la commande suivante et remplacez-la *j-KT4XXXXXXXX1NM* par votre ID de cluster.
```
aws emr remove-tags --resource-id j-KT4XXXXXX1NM --tag-keys "costCenter"
```
**Note**
Actuellement, vous ne pouvez pas supprimer plusieurs balises à l'aide d'une seule commande.
Pour plus d'informations sur l'utilisation des commandes Amazon EMR dans le AWS CLI, consultez. [https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr)
------