Ajouter et supprimer des balises pour les EC2 ressources Amazon

Lorsque vous créez une EC2 ressource Amazon, telle qu'une EC2 instance Amazon, vous pouvez spécifier les balises à ajouter à la ressource. Vous pouvez également utiliser la EC2 console Amazon pour afficher les balises d'une EC2 ressource Amazon spécifique. Vous pouvez également ajouter ou supprimer des balises dans une EC2 ressource Amazon existante.

Vous pouvez utiliser l'éditeur de balises de la AWS Resource Groups console pour afficher, ajouter ou supprimer des balises pour toutes vos AWS ressources dans toutes les régions. Vous pouvez appliquer ou supprimer des balises à plusieurs types de ressources en même temps. Pour plus d'informations, consultez le Guide de l'utilisateur AWS des ressources de balisage.

Ajouter des tags à l'aide de la console

Vous pouvez ajouter des balises à une ressource existante directement à partir de la page correspondante.

Pour ajouter des balises à une ressource existante

1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/.

2. Dans la barre de navigation, sélectionnez la région où se trouve la ressource.

3. Dans le panneau de navigation, sélectionnez un type de ressource (par exemple, Instances).

4. Sélectionnez la ressource depuis la liste.

5. Depuis l'onglet Balises, choisissez Gérer les balises.

6. Choisissez Ajouter une nouvelle balise et entrez une clé et une valeur pour la balise.

7. Choisissez Enregistrer.

Ajoutez des balises à l'aide du AWS CLI

Vous pouvez ajouter des balises lorsque vous créez une ressource ou à une ressource existante.

Pour ajouter un tag lors de la création d'une ressource

Utilisez -tag-specifications cette option pour étiqueter une ressource lors de sa création. Une spécification de balise nécessite le type de ressource à étiqueter, la clé de balise et la valeur de la balise. L'exemple suivant crée une balise et l'ajoute à une spécification de balise.

--tag-specifications 'ResourceType=instance,Tags=[{Key=stack,Value=production}]'

Pour ajouter un tag à une ressource existante

Les exemples suivants montrent comment ajouter des balises aux ressources existantes à l'aide de la commande create-tags.

Exemple : Ajout d’une balise à une ressource

La commande suivante ajoute la balise Stack=production à l'image spécifiée ou remplace une balise existante pour l'AMI où se trouve la clé de balise stack. Si la commande aboutit, aucune sortie n'est renvoyée.

aws ec2 create-tags \
    --resources ami-0abcdef1234567890 \
    --tags Key=stack,Value=production

Exemple : Ajout de balises à plusieurs ressources

Cet exemple ajoute (ou remplace) deux balises pour une AMI et une instance. L'une des balises ne contient qu'une clé (webserver), sans valeur (nous avons défini la valeur sur une chaîne vide). L'autre balise consiste en une clé (stack) et value (Production). Si la commande réussit, aucune sortie n’est renvoyée.

aws ec2 create-tags \
    --resources ami-0abcdef1234567890 i-1234567890abcdef0 \
    --tags Key=webserver,Value=  Key=stack,Value=Production

Exemple : Ajout de balises avec des caractères spéciaux

Cet exemple ajoute le tag [Group]=test à une instance. Les crochets ([ and ]) sont des caractères spéciaux auxquels il faut échapper.

Si vous utilisez Linux ou OS X, pour éviter les caractères spéciaux, placez l'élément par le caractère spécial entre guillemets ("), puis placez l'ensemble de la structure de clé et de valeur entre guillemets simples (').

aws ec2 create-tags \
    --resources i-1234567890abcdef0 \
    --tags 'Key="[Group]",Value=test'

Si vous utilisez Windows, pour échapper les caractères spéciaux, placez l’élément qui a des caractères spéciaux entre des guillemets doubles ("), puis faites précéder chaque guillemet double d’une barre oblique inverse (\), comme suit :

aws ec2 create-tags ^
    --resources i-1234567890abcdef0 ^
    --tags Key=\"[Group]\",Value=test

Si vous utilisez Windows PowerShell, pour éviter les caractères spéciaux, placez la valeur contenant des caractères spéciaux entre guillemets ("), faites précéder chaque guillemet d'une barre oblique inverse (\), puis placez l'ensemble de la structure des clés et des valeurs entre guillemets simples () comme suit : '

aws ec2 create-tags `
    --resources i-1234567890abcdef0 `
    --tags 'Key=\"[Group]\",Value=test'

Ajoutez des balises à l'aide de PowerShell

Vous pouvez ajouter des balises lorsque vous créez une ressource ou à une ressource existante.

Pour ajouter un tag lors de la création d'une ressource

Utilisez le -TagSpecification paramètre pour étiqueter une ressource lors de sa création. Une spécification de balise nécessite le type de ressource à étiqueter, la clé de balise et la valeur de la balise. L'exemple suivant crée une balise et l'ajoute à une spécification de balise.

$tag = @{Key="stack"; Value="production"}
$tagspec = new-object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance"
$tagspec.Tags.Add($tag)

L'exemple suivant indique cette balise dans le -TagSpecification paramètre.

-TagSpecification $tagspec

Pour ajouter un tag à une ressource existante

Utilisez l'New-EC2Tagapplet de commande. Vous devez spécifier la ressource, la clé de balise et la valeur de la balise.

New-EC2Tag `
    -Resource i-1234567890abcdef0 `
    -Tag @{Key="purpose"; Value="production"}

Ajoutez des balises à l'aide de CloudFormation

Avec les types de EC2 ressources Amazon, vous spécifiez des balises à l'aide de la TagSpecifications propriété a Tags ou.

Les exemples suivants ajoutent la balise Stack=Production à AWS::EC2::Instancel'aide de sa Tags propriété.

Exemple : Tags dans YAML

Tags:
  - Key: "Stack"
    Value: "Production"

Exemple : Tags dans JSON

"Tags": [
    {
        "Key": "Stack",
        "Value": "Production"
    }
]

Les exemples suivants ajoutent la balise Stack=Production à AWS::EC2::LaunchTemplate LaunchTemplateDatal'aide de sa TagSpecifications propriété.

Exemple : TagSpecifications en YAML

TagSpecifications:
  - ResourceType: "instance"
    Tags:
    - Key: "Stack"
      Value: "Production"

Exemple : TagSpecifications en JSON

"TagSpecifications": [
    {
        "ResourceType": "instance",
        "Tags": [
            {
                "Key": "Stack",
                "Value": "Production"
            }
        ]
    }
]