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 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 : 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 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