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
Utilisez les opérations d'identification suivantes pour ajouter, supprimer ou répertorier des identifications sur une ressource.
| « Hello, World! » | 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é. |
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 opérations CreateWorkGroup ou CreateDataCatalog API ou avec les create-data-catalog commandes AWS CLI create-work-group or.
Gérer les balises à l'aide d'actions d'API
Les exemples suivants montrent comment utiliser les actions de l'API 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 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();
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 : Create-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 format JSON.
{ "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
