Ajouter ou retirer des tags

Vous pouvez ajouter des tags à vos ressources déjà existantes pour les identifier et les classer. Les tags vous permettent d’inventorier vos ressources.

Un tag est la combinaison d’une clé et d’une valeur. Si un tag avec la même clé existe déjà pour la ressource spécifiée, aucun nouveau tag n’est créé : la valeur du tag existant est mise à jour.

Vous pouvez également ajouter des tags à des machines virtuelles (VM) ou à des snapshots lors de leur création. Pour en savoir plus, voir Créer des VM et Créer un snapshot d’un volume.

Pour ajouter des tags à vos load balancers, voir Ajouter ou retirer des tags à vos load balancers.

Ajouter ou retirer des tags avec Cockpit v2

Cochez la case de la ressource dont vous voulez modifier les tags.
La ressource est sélectionnée.
Cliquez sur Modifier les tags.
La boîte de dialogue MODIFIER LES TAGS apparaît.
(optionnel) Pour ajouter un tag à la ressource, cliquez sur Ajouter un nouveau tag et entrez une clé et une valeur.

La valeur est optionnelle. Vous pouvez ajouter un tag en spécifiant une clé uniquement.

La valeur du tag doit contenir 255 caractères maximum. Cependant, la clé du tag n’est pas limitée en longueur.
(optionnel) Pour retirer un tag, cliquez sur .
Cliquez sur Mettre à jour les tags.
Les tags sont ajoutés à ou retirés de la ressource sélectionnée.

Vous pouvez également mettre à jour la clé ou la valeur des tags existants à tout moment dans la boîte de dialogue MODIFIER LES TAGS.

Ajouter ou retirer des tags avec OSC CLI

Ajouter des tags

À ce jour, cette section est disponible en anglais uniquement.

The CreateTags command adds one or more tags to the specified resources.
If a tag with the same key already exists for the resource, the tag value is replaced.
You can tag the following resources using their IDs:

Virtual machines (VMs) (i-xxxxxxxx)
OMIs (ami-xxxxxxxx)
Volumes (vol-xxxxxxxx)
Snapshots (snap-xxxxxxxx)
Public IPs (eipalloc-xxxxxxxx)
Security groups (sg-xxxxxxxx)
Route tables (rtb-xxxxxxxx)
Network interface cards (NIC) (eni-xxxxxxxx)
Nets (vpc-xxxxxxxx)
Subnets (subnet-xxxxxxxx)
Net peerings (vpcx-xxxxxxxx)
Net endpoints (vpce-xxxxxxxx)
NAT services (nat-xxxxxxxx)
Internet services (igw-xxxxxxxx)
Client gateways (cgw-xxxxxxxx)
Virtual gateways (vgw-xxxxxxxx)
VPN connections (vpn-xxxxxxxx)
DHCP options (dopt-xxxxxxxx)
OMI export tasks (image-export-xxxxxxxx)
Snapshot export tasks (snap-export-xxxxxxxx)

For more information, see About Tags.

Request sample

$ osc-cli api CreateTags --profile "default" \
    --ResourceIds '["i-12345678"]' \
    --Tags '[
        {
          "Key": "key1",
          "Value": "value1"
        }
      ]'

This command contains the following attributes that you need to specify:

DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
ResourceIds: One or more resource IDs.
Tags: One or more tags to add to the specified resources.
- Key: (optional) The key of the tag, with a minimum of 1 character.
- Value: (optional) The value of the tag, between 0 and 255 characters.

The CreateTags command returns the following elements:

ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Retirer des tags

À ce jour, cette section est disponible en anglais uniquement.

The DeleteTags command deletes one or more tags from the specified resources.

Request sample

$ osc-cli api DeleteTags --profile "default" \
    --ResourceIds '["i-12345678"]' \
    --Tags '[
        {
          "Key": "key1",
          "Value": "value1"
        }
      ]'

This command contains the following attributes that you need to specify:

DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
ResourceIds: One or more resource IDs.
Tags: One or more tags to delete (if you set a tag value, only the tags matching exactly this value are deleted).
- Key: (optional) The key of the tag, with a minimum of 1 character.
- Value: (optional) The value of the tag, between 0 and 255 characters.

The DeleteTags command returns the following elements:

ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Ajouter ou retirer des tags avec oapi-cli

Ajouter des tags

À ce jour, cette section est disponible en anglais uniquement.

Virtual machines (VMs) (i-xxxxxxxx)
OMIs (ami-xxxxxxxx)
Volumes (vol-xxxxxxxx)
Snapshots (snap-xxxxxxxx)
Public IPs (eipalloc-xxxxxxxx)
Security groups (sg-xxxxxxxx)
Route tables (rtb-xxxxxxxx)
Network interface cards (NIC) (eni-xxxxxxxx)
Nets (vpc-xxxxxxxx)
Subnets (subnet-xxxxxxxx)
Net peerings (vpcx-xxxxxxxx)
Net endpoints (vpce-xxxxxxxx)
NAT services (nat-xxxxxxxx)
Internet services (igw-xxxxxxxx)
Client gateways (cgw-xxxxxxxx)
Virtual gateways (vgw-xxxxxxxx)
VPN connections (vpn-xxxxxxxx)
DHCP options (dopt-xxxxxxxx)
OMI export tasks (image-export-xxxxxxxx)
Snapshot export tasks (snap-export-xxxxxxxx)

For more information, see About Tags.

Request sample

$ oapi-cli --profile "default" CreateTags \
    --ResourceIds '["i-12345678"]' \
    --Tags '[
        {
          "Key": "key1",
          "Value": "value1"
        }
      ]'

This command contains the following attributes that you need to specify:

DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
ResourceIds: One or more resource IDs.
Tags: One or more tags to add to the specified resources.
- Key: (optional) The key of the tag, with a minimum of 1 character.
- Value: (optional) The value of the tag, between 0 and 255 characters.

The CreateTags command returns the following elements:

ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Retirer des tags

À ce jour, cette section est disponible en anglais uniquement.

The DeleteTags command deletes one or more tags from the specified resources.

Request sample

$ oapi-cli --profile "default" DeleteTags \
    --ResourceIds '["i-12345678"]' \
    --Tags '[
        {
          "Key": "key1",
          "Value": "value1"
        }
      ]'

This command contains the following attributes that you need to specify:

DryRun: (optional) If true, checks whether you have the required permissions to perform the action.
ResourceIds: One or more resource IDs.
Tags: One or more tags to delete (if you set a tag value, only the tags matching exactly this value are deleted).
- Key: (optional) The key of the tag, with a minimum of 1 character.
- Value: (optional) The value of the tag, between 0 and 255 characters.

The DeleteTags command returns the following elements:

ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.

Result sample

{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Ajouter ou retirer des tags avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Ajouter des tags

Pour ajouter un ou plusieurs tags, utilisez la commande create-tags en suivant cette syntaxe :

Exemple de requête

$ aws ec2 create-tags \
    --profile YOUR_PROFILE \
    --resources sg-12345678 i-12345678\
    --tags Key=Name,Value=SG1 Key=Name2,Value=I1 \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
resources : L’ID d’une ou plusieurs ressources auxquelles vous voulez ajouter un tag. Pour en savoir plus, voir À propos des ressources > Types de ressources.

Si vous spécifiez plusieurs ressources, chaque tag est ajouté à chacune d’entre elles.
tags : Les tags que vous voulez ajouter à une ressource spécifique. Ces attributs contiennent les éléments suivants que vous devez spécifier pour chaque tag :
- key : La clé du tag.
- value : La valeur du tag.
  
  Si vous souhaitez spécifier une clé uniquement, vous pouvez spécifier une chaîne de caractères vide pour l’élément value.
  
  La valeur du tag doit contenir 255 caractères maximum. Cependant, la clé du tag n’est pas limitée en longueur.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

Les tags sont ajoutés aux ressources spécifiées.

Retirer des tags

Pour retirer un ou plusieurs tags, utilisez la commande delete-tags en suivant cette syntaxe :

Exemple de requête

$ aws ec2 delete-tags \
    --profile YOUR_PROFILE \
    --resources sg-12345678 i-12345678 \
    --tags Key=Name,Value=SG1 Key=Name2,Value=I1 \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
resources : L’ID d’une ou plusieurs ressources desquelles vous voulez retirer les tags spécifiés.

Si vous spécifiez plusieurs ressources, les tags sont retirés de chacune d’entre elles.

tags : Les tags que vous voulez retirer des ressources spécifiées. Cet attribut contient les éléments suivants que vous devez spécifier pour chaque tag :

key : La clé du tag.

(optionnel) value : La valeur du tag.

Si vous ne spécifiez aucune valeur, tous les tags qui ont la même clé sont retirés.
Si vous spécifiez une chaîne de caractères vide pour la valeur, le tag est retiré seulement si sa valeur est une chaîne de caractères vide.

endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

Les tags sont retirés des ressources spécifiées.

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.