Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Usa le operazioni di API e AWS CLI tag
Utilizzare le seguenti operazioni relative ai tag per aggiungere, rimuovere o elencare tag su una risorsa.
| API | CLI | Descrizione dell'operazione |
|---|---|---|
TagResource |
tag-resource |
Aggiungere o sovrascrivere uno o più tag sulla risorsa con l'ARN specificato. |
UntagResource |
untag-resource |
Eliminare uno o più tag dalla risorsa con l'ARN specificato. |
ListTagsForResource |
list‑tags‑for‑resource |
Elencare uno o più tag per la risorsa con l'ARN specificato. |
Aggiungi tag quando crei una risorsa
Per aggiungere tag quando crei un gruppo di lavoro o un catalogo di dati, utilizza il tags parametro con le operazioni CreateWorkGroup o CreateDataCatalog API o con i create-data-catalog comandi AWS CLI create-work-group or.
Gestisci i tag utilizzando le azioni API
Gli esempi seguenti mostrano come utilizzare le azioni dell'API dei tag per gestire i tag nei gruppi di lavoro e nei cataloghi di dati. Gli esempi sono nel linguaggio di programmazione Java.
Nell'esempio seguente vengono aggiunti due tag al gruppo di lavoro 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);
Nell'esempio seguente vengono aggiunti due tag al catalogo dati 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);
Nota
Non aggiungere chiavi tag duplicate alla stessa risorsa. In caso contrario, Athena genera un messaggio di errore. Se aggiungi un tag a una risorsa usando una chiave di tag esistente in un'operazione TagResource separata, il nuovo valore di tag sovrascrive il valore precedente.
L'esempio seguente rimuove tagKey2 dal gruppo di lavoro 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'esempio seguente rimuove tagKey2 dal catalogo dati 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);
Nell'esempio seguente vengono elencati i tag per il gruppo di lavoro 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();
Nell'esempio seguente vengono elencati i tag per il catalogo dati 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();
Gestisci i tag utilizzando il AWS CLI
I seguenti esempi mostrano come utilizzare per creare e gestire i tag nei cataloghi di dati. AWS CLI
Il comando tag-resource aggiunge uno o più tag a una risorsa specificata
Sintassi
aws athena tag-resource --resource-arn
arn:aws:athena:region:account_id:datacatalog/catalog_name
--tags
Key=string,Value=string
Key=string,Value=string
Il parametro --resource-arn specifica la risorsa a cui vengono aggiunti i tag. Il parametro --tags specifica un elenco di coppie chiave-valore separate da spazi da aggiungere come tag alla risorsa.
Esempio
Nell'esempio seguente vengono aggiunti tag al catalogo dati 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
Per mostrare il risultato, utilizzare il comando list-tags-for-resource.
Per informazioni sull'aggiunta di tag durante l'utilizzo del comando create-data-catalog, consulta la sezione Registrazione di un catalogo: Create-data-catalog.
Il comando list-tags-for-resource elenca i tag per la risorsa specificata.
Sintassi
aws athena list-tags-for-resource --resource-arn
arn:aws:athena:region:account_id:datacatalog/catalog_name
Il parametro --resource-arn specifica la risorsa per la quale sono elencati i tag.
Nell'esempio seguente vengono elencati i tag per il catalogo dati mydatacatalog.
aws athena list-tags-for-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog
Il seguente risultato di esempio è in formato JSON.
{ "Tags": [ { "Key": "Time", "Value": "Now" }, { "Key": "Color", "Value": "Orange" } ] }
Il comando untag-resource rimuove le chiavi tag specificate e i relativi valori associati dalla risorsa specificata.
Sintassi
aws athena untag-resource --resource-arn
arn:aws:athena:
region:account_id:datacatalog/catalog_name
--tag-keys key_name
[key_name ...]
Il parametro --resource-arn specifica la risorsa da cui vengono rimossi i tag. Il parametro --tag-keys accetta un elenco separato da spazi di nomi di chiavi. Per ogni nome di chiave specificato, il comando untag-resource rimuove sia la chiave che il suo valore.
Nell'esempio seguente vengono rimosse le chiavi Color e Time nonché i relativi valori dalla risorsa del catalogo mydatacatalog.
aws athena untag-resource --resource-arn arn:aws:athena:us-east-1:111122223333:datacatalog/mydatacatalog --tag-keys Color Time
