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.

# Utiliser les opérations d'API et de AWS CLI balises
<a name="tags-operations"></a>

Utilisez les opérations d'identification suivantes pour ajouter, supprimer ou répertorier des identifications sur une ressource.


****  

| API | INTERFACE DE LIGNE DE COMMANDE (CLI) | Description de l'action | 
| --- | --- | --- | 
| TagResource | tag-resource | Ajoutez ou remplacez une ou plusieurs identifications sur la ressource où l'ARN est spécifié. | 
| UntagResource | untag-resource | Supprimez une ou plusieurs identifications de la ressource ayant l'ARN spécifié. | 
| ListTagsForResource | list‑tags‑for‑resource | Répertorie une ou plusieurs identifications pour la ressource qui a l'ARN spécifié. | 

**Ajout de balises lors de la création d’une ressource**  
Pour ajouter des balises lorsque vous créez un groupe de travail ou un catalogue de données, utilisez le `tags` paramètre avec les opérations `CreateWorkGroup` ou `CreateDataCatalog` API ou avec les `create-data-catalog` commandes AWS CLI `create-work-group` or.

## Gestion des balises à l’aide d’actions d’API
<a name="tags-operations-examples-java"></a>

Les exemples suivants montrent comment utiliser les actions d’API de balisage pour gérer les balises sur les groupes de travail et les catalogues de données. Les exemples sont dans le langage de programmation Java.

### Exemple — TagResource
<a name="tags-operations-examples-java-tag-resource"></a>

L'exemple suivant ajoute deux identifications au groupe de travail   `workgroupA`:

```
List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey({{"tagKey1"}}).withValue({{"tagValue1"}}));
tags.add(new Tag().withKey({{"tagKey2"}}).withValue({{"tagValue2"}}));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN({{"arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA"}})
    .withTags(tags);

client.tagResource(request);
```

L'exemple suivant ajoute deux identifications au catalogue de données   `datacatalogA`:

```
List<Tag> tags = new ArrayList<>();
tags.add(new Tag().withKey("{{tagKey1}}").withValue("{{tagValue1}}"));
tags.add(new Tag().withKey("{{tagKey2}}").withValue("{{tagValue2}}"));

TagResourceRequest request = new TagResourceRequest()
    .withResourceARN("{{arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA}}")
    .withTags(tags);

client.tagResource(request);
```

**Note**  
N'ajoutez pas de clés d'identification en double à la même ressource. Dans ce cas, Athena envoie un message d'erreur. Si vous identifiez une ressource à l'aide d'une clé d'identification existante en exécutant une action `TagResource` distincte, la nouvelle valeur d'identification remplace l'ancienne.

### Exemple — UntagResource
<a name="tags-operations-examples-java-untag-resource"></a>

L'exemple suivant supprime `tagKey2` du groupe de travail `workgroupA` :

```
List<String> tagKeys = new ArrayList<>();
tagKeys.add("{{tagKey2}}");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("{{arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA"}})
    .withTagKeys(tagKeys);

client.untagResource(request);
```

L'exemple suivant supprime `tagKey2` du catalogue de données `datacatalogA` :

```
List<String> tagKeys = new ArrayList<>();
tagKeys.add("{{tagKey2}}");

UntagResourceRequest request = new UntagResourceRequest()
    .withResourceARN("{{arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA}}")
    .withTagKeys(tagKeys);

client.untagResource(request);
```

### Exemple — ListTagsForResource
<a name="tags-operations-examples-java-list-tags-for-resource"></a>

L'exemple suivant répertorie les identifications du groupe de travail   `workgroupA`:

```
ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN({{"arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA"}});

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();
```

L'exemple suivant répertorie les identifications du catalogue de données   `datacatalogA`:

```
ListTagsForResourceRequest request = new ListTagsForResourceRequest()
    .withResourceARN("{{arn:aws:athena:us-east-1:123456789012:datacatalog/datacatalogA}}");

ListTagsForResourceResult result = client.listTagsForResource(request);

List<Tag> resultTags = result.getTags();
```

## Gérez les balises à l'aide du AWS CLI
<a name="tags-operations-examples-cli"></a>

Les exemples suivants montrent comment utiliser le pour AWS CLI créer et gérer des balises dans des catalogues de données.

### Ajout de balises à une ressource : tag-resource
<a name="tags-operations-examples-cli-tag-resource"></a>

La commande `tag-resource` ajoute une ou plusieurs identifications à une ressource spécifiée.

**Syntaxe**  
`aws athena tag-resource --resource-arn arn:aws:athena:{{region}}:{{account_id}}:datacatalog/{{catalog_name}} --tags Key={{string}},Value={{string}} Key={{string}},Value={{string}}`

Le paramètre `--resource-arn` spécifie la ressource à laquelle les identifications sont ajoutées. Le paramètre `--tags` spécifie une liste de paires clé-valeur séparées par des espaces à ajouter en tant qu’identifications à la ressource. 

**Example**  
L'exemple suivant ajoute des identifications au catalogue de données `mydatacatalog`.  

```
aws athena tag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tags Key=Color,Value=Orange Key=Time,Value=Now
```
Pour afficher le résultat, utilisez la commande `list-tags-for-resource`.   
Pour plus d'informations sur l'ajout de balises lors de l'utilisation de la commande `create-data-catalog`, consultez [Enregistrement d'un catalogue : Create-data-catalog](datastores-hive-cli.md#datastores-hive-cli-registering-a-catalog).

### Répertoriez les balises d'une ressource : list-tags-for-resource
<a name="tags-operations-examples-cli-list-tags-for-resource"></a>

La commande `list-tags-for-resource` répertorie les identifications de la ressource spécifiée.

**Syntaxe**  
`aws athena list-tags-for-resource --resource-arn arn:aws:athena:{{region}}:{{account_id}}:datacatalog/{{catalog_name}}`

Le paramètre `--resource-arn` spécifie la ressource pour laquelle les identifications sont répertoriées. 

L'exemple suivant répertorie les identifications du catalogue de données `mydatacatalog`.

```
aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog
```

L'exemple de résultat suivant est au format JSON.

```
{
    "Tags": [
        {
            "Key": "Time",
            "Value": "Now"
        },
        {
            "Key": "Color",
            "Value": "Orange"
        }
    ]
}
```

### Suppression des balises d’une ressource. : untag-resource
<a name="tags-operations-examples-cli-untag-resource"></a>

La commande `untag-resource` supprime les clés d'identification spécifiées et leurs valeurs associées provenant de la ressource spécifiée.

**Syntaxe**  
`aws athena untag-resource --resource-arn arn:aws:athena:{{region}}:{{account_id}}:datacatalog/{{catalog_name}} --tag-keys {{key_name}} [{{key_name}} ...]` 

Le paramètre `--resource-arn` spécifie la ressource à partir de laquelle les identifications sont supprimées. Le paramètre `--tag-keys` prend une liste de noms de clés séparés par des espaces. Pour chaque nom de clé spécifié, la commande `untag-resource` supprime à la fois la clé et sa valeur.

L'exemple suivant supprime les clés `Color` et `Time`, et leurs valeurs issues de la ressource de catalogue `mydatacatalog`.

```
aws athena untag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tag-keys Color Time
```