Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Opérations d'utilisation API et de AWS CLI balisage

Mode de mise au point
Opérations d'utilisation API et de AWS CLI balisage - Amazon Athena

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.

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.

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

API CLI Description de l'action
TagResource tag-resource Ajoutez ou remplacez une ou plusieurs balises sur la ressource qui possède le paramètre spécifiéARN.
UntagResource untag-resource Supprimez une ou plusieurs balises de la ressource qui possède le tag spécifiéARN.
ListTagsForResource list‑tags‑for‑resource Répertoriez une ou plusieurs balises pour la ressource qui possède le paramètre spécifiéARN.
Ajoutez des balises lorsque vous créez 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 CreateDataCatalog API opérations CreateWorkGroup ou ou avec les create-data-catalog commandes AWS CLI create-work-group or.

Gérer les tags à l'aide d'APIactions

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

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.

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.

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);

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);

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();

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

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

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.

Exemple

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 : C reate-data-catalog.

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.

Exemple

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 : C reate-data-catalog.

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 JSON format.

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

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 JSON format.

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

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

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
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.