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à.
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
