Obtenir des informations sur les tags associés à une ressource

Vous pouvez obtenir des informations sur les tags associés à une ressource.

Dans le cas d’une machine virtuelle (VM), vous pouvez aussi obtenir des informations sur les tags associés en consultant les metadata de la VM depuis la VM elle-même. Pour en savoir plus, voir Accéder aux metadata et user data d’une VM.

Obtenir des informations sur vos tags avec Cockpit v2

Cochez la case de la ressource dont vous souhaitez des informations sur les tags.
La ressource est sélectionnée.
Cliquez sur Modifier les tags.
La boîte de dialogue MODIFIER LES TAGS apparait avec tous les tags associés à la ressource sélectionnée.

Obtenir des informations sur vos tags avec OSC CLI

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

The ReadTags command lists one or more tags for your resources.

Request sample

$ osc-cli api ReadTags --profile "default" \
    --Filters '{
        "ResourceTypes": ["snapshot"],
        "Keys": ["key1"]
      }'

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.
Filters: (optional) One or more filters.
- Keys: (optional) The keys of the tags that are assigned to the resources. You can use this filter alongside the Values filter. In that case, you filter the resources corresponding to each tag, regardless of the other filter.
- ResourceIds: (optional) The IDs of the resources with which the tags are associated.
- ResourceTypes: (optional) The resource type (vm | image | volume | snapshot | public-ip | security-group | route-table | nic | net | subnet | net-peering | net-access-point | nat-service | internet-service | client-gateway | virtual-gateway | vpn-connection | dhcp-options | task).
- Values: (optional) The values of the tags that are assigned to the resources. You can use this filter alongside the TagKeys filter. In that case, you filter the resources corresponding to each tag, regardless of the other filter.
NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.
ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included). By default, 100.

The ReadTags command returns the following elements:

NextPageToken: The token to request the next page of results. Each token refers to a specific page.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.
Tags: Information about one or more tags.
- Key: The key of the tag, with a minimum of 1 character.
- ResourceId: The ID of the resource.
- ResourceType: The type of the resource.
- Value: The value of the tag, between 0 and 255 characters.

Result sample

{
  "Tags": [
    {
      "Value": "value1",
      "ResourceType": "snapshot",
      "ResourceId": "snap-12345678",
      "Key": "key1"
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Obtenir des informations sur vos tags avec oapi-cli

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

The ReadTags command lists one or more tags for your resources.

Request sample

$ oapi-cli --profile "default" ReadTags \
    --Filters '{
        "ResourceTypes": ["snapshot"],
        "Keys": ["key1"]
      }'

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.
Filters: (optional) One or more filters.
- Keys: (optional) The keys of the tags that are assigned to the resources. You can use this filter alongside the Values filter. In that case, you filter the resources corresponding to each tag, regardless of the other filter.
- ResourceIds: (optional) The IDs of the resources with which the tags are associated.
- ResourceTypes: (optional) The resource type (vm | image | volume | snapshot | public-ip | security-group | route-table | nic | net | subnet | net-peering | net-access-point | nat-service | internet-service | client-gateway | virtual-gateway | vpn-connection | dhcp-options | task).
- Values: (optional) The values of the tags that are assigned to the resources. You can use this filter alongside the TagKeys filter. In that case, you filter the resources corresponding to each tag, regardless of the other filter.
NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.
ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1 and 1000, both included). By default, 100.

The ReadTags command returns the following elements:

NextPageToken: The token to request the next page of results. Each token refers to a specific page.
ResponseContext: Information about the context of the response.
- RequestId: The ID of the request.
Tags: Information about one or more tags.
- Key: The key of the tag, with a minimum of 1 character.
- ResourceId: The ID of the resource.
- ResourceType: The type of the resource.
- Value: The value of the tag, between 0 and 255 characters.

Result sample

{
  "Tags": [
    {
      "Value": "value1",
      "ResourceType": "snapshot",
      "ResourceId": "snap-12345678",
      "Key": "key1"
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Obtenir des informations sur vos tags avec AWS CLI

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

Pour obtenir des informations sur les tags associés à vos ressources, utilisez la commande describe-tags en suivant cette syntaxe :

Exemple de requête

$ aws ec2 describe-tags \
    --profile YOUR_PROFILE \
    --filters Name=resource-id,Values=i-12345678 \
    --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.
(optionnel) filters : Un ou plusieurs filtres, au format "Name=X,Values=Y".

Vous pouvez spécifier plusieurs valeurs pour un même filtre en utilisant le format "Name=X,Values=Y, Z".

Les filtres suivants sont disponibles :
- key : La clé des tags.
- resource-id : L’ID de la ressource.
- resource-type : Le type de ressource (instance | image | volume | snapshot | public-ip | security-group | route-table | network-interface | vpc | subnet | network-link | vpc-endpoint | nat-gateway | internet-gateway | customer-gateway | vpn-gateway | vpn-connection | dhcp-options | task).
- value : La valeur des tags.
  
  Si vous utilisez ce filtre et spécifiez une chaîne de caractères vide, vous obtenez des informations sur l’ensemble des tags ayant pour valeur 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.

La commande describe-tags renvoie les éléments suivants :

Tags : Les tags associés à votre ressource.
- ResourceType : Le type de ressource.
- ResourceId : L’ID de la ressource.
- Value : La valeur du tag.
- Key : La clé du tag.

Exemple de résultat

{
    "Tags": [
        {
            "ResourceType": "image",
            "ResourceId": "ami-78a54011",
            "Value": "Test2",
            "Key": "Name"
        },
        {
            "ResourceType": "image",
            "ResourceId": "ami-3ac33653",
            "Value": "Test",
            "Key": "Name"
        }
    ]
}

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.