

**Cette documentation concerne AWS CLI uniquement la version 1.**

Nous avons annoncé la fin prochaine du support pour la AWS CLI version 1. La AWS CLI version 1 est désormais en mode maintenance. Nous vous recommandons de migrer vers la AWS CLI version 2. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, consultez l'[annonce](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Pour la documentation relative à la version 2 du AWS CLI, consultez le [guide de l'utilisateur de la version 2](https://docs.aws.amazon.com/cli/latest/userguide/).

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.

# Exemples d'API de balisage Resource Groups utilisant AWS CLI
<a name="cli_resource-groups-tagging-api_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l'API AWS Command Line Interface with Resource Groups Tagging.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `obtenir des ressources`
<a name="resource-groups-tagging-api_GetResources_cli_topic"></a>

L’exemple de code suivant montre comment utiliser `get-resources`.

**AWS CLI**  
**Pour obtenir une liste de ressources balisées**  
L’exemple `get-resources` suivant affiche une liste des ressources du compte qui sont balisées avec le nom et la valeur de clé spécifiés.  

```
aws resourcegroupstaggingapi get-resources \
    --tag-filters {{Key=Environment,Values=Production}} \
    --tags-per-page {{100}}
```
Sortie :  

```
{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}
```
Pour plus d'informations, consultez le [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)manuel *Resource Groups Tagging API Reference*.  
+  Pour plus de détails sur l'API, reportez-vous [GetResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html)à la section *Référence des AWS CLI commandes*. 

### `get-tag-keys`
<a name="resource-groups-tagging-api_GetTagKeys_cli_topic"></a>

L’exemple de code suivant montre comment utiliser `get-tag-keys`.

**AWS CLI**  
**Pour obtenir la liste de toutes les clés de balises**  
L’exemple `get-tag-keys` suivant récupère la liste de tous les noms de clé de balise utilisés par les ressources du compte.  

```
aws resourcegroupstaggingapi get-tag-keys
```
Sortie :  

```
{
    "TagKeys": [
        "Environment",
        "CostCenter",
        "Department"
    ]
}
```
Pour plus d'informations, consultez le [GetTagKeys](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetTagKeys.html)manuel *Resource Groups Tagging API Reference*.  
+  Pour plus de détails sur l'API, reportez-vous [GetTagKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-keys.html)à la section *Référence des AWS CLI commandes*. 

### `get-tag-values`
<a name="resource-groups-tagging-api_GetTagValues_cli_topic"></a>

L’exemple de code suivant montre comment utiliser `get-tag-values`.

**AWS CLI**  
**Pour obtenir la liste de toutes les valeurs de balises**  
L’exemple `get-tag-values` suivant affiche toutes les valeurs utilisées pour la clé spécifiée pour toutes les ressources.  

```
aws resourcegroupstaggingapi get-tag-values \
    --key=Environment
```
Sortie :  

```
{
    "TagValues": [
        "Alpha",
        "Gamma",
        "Production"
    ]
}
```
Pour plus d'informations, consultez le [GetTagValues](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetTagValues.html)manuel *Resource Groups Tagging API Reference*.  
+  Pour plus de détails sur l'API, reportez-vous [GetTagValues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-values.html)à la section *Référence des AWS CLI commandes*. 

### `ressources de balises`
<a name="resource-groups-tagging-api_TagResources_cli_topic"></a>

L’exemple de code suivant montre comment utiliser `tag-resources`.

**AWS CLI**  
**Pour attacher une balise à une ressource**  
L’exemple `tag-resources` suivant balise la ressource spécifiée avec un nom et une valeur de clé.  

```
aws resourcegroupstaggingapi tag-resources \
    --resource-arn-list {{arn:aws:s3:::MyProductionBucket}} \
    --tags {{Environment=Production,CostCenter=1234}}
```
Sortie :  

```
{
    "FailedResourcesMap": {}
}
```
Pour plus d'informations, consultez le [TagResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_TagResources.html)manuel *Resource Groups Tagging API Reference*.  
+  Pour plus de détails sur l'API, reportez-vous [TagResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/tag-resources.html)à la section *Référence des AWS CLI commandes*. 

### `untag-resources`
<a name="resource-groups-tagging-api_UntagResources_cli_topic"></a>

L’exemple de code suivant montre comment utiliser `untag-resources`.

**AWS CLI**  
**Pour supprimer une balise d’une ressource**  
L’exemple `untag-resources` suivant supprime les clés de balise spécifiées et leurs valeurs associées provenant de la ressource spécifiée.  

```
aws resourcegroupstaggingapi untag-resources \
    --resource-arn-list {{arn:aws:s3:::amzn-s3-demo-bucket}} \
    --tag-keys {{Environment}} {{CostCenter}}
```
Sortie :  

```
{
    "FailedResourcesMap": {}
}
```
Pour plus d'informations, consultez le [UntagResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_UntagResources.html)manuel *Resource Groups Tagging API Reference*.  
+  Pour plus de détails sur l'API, reportez-vous [UntagResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/untag-resources.html)à la section *Référence des AWS CLI commandes*. 