Operazioni di utilizzo API e tag AWS CLI

Utilizzare le seguenti operazioni relative ai tag per aggiungere, rimuovere o elencare tag su una risorsa.

API	CLI	Descrizione dell'operazione
TagResource	tag-resource	Aggiungi o sovrascrivi uno o più tag sulla risorsa che ha il valore specificatoARN.
UntagResource	untag-resource	Elimina uno o più tag dalla risorsa che ha il valore specificatoARN.
ListTagsForResource	list‑tags‑for‑resource	Elenca uno o più tag per la risorsa che ha quanto specificatoARN.

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 CreateDataCatalog API operazioni CreateWorkGroup o o con i create-data-catalog comandi AWS CLI create-work-group o.

Gestisci i tag utilizzando le API azioni

Gli esempi seguenti mostrano come utilizzare API le azioni dei tag per gestire i tag nei gruppi di lavoro e nei cataloghi di dati. Gli esempi sono nel linguaggio di programmazione Java.

Esempio: TagResource

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.

Esempio — UntagResource

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

Esempio — ListTagsForResource

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

Aggiungere tag a una risorsa: tag-resource

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

Elenca i tag per una risorsa: list-tags-for-resource

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

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

Rimuovi tag da una risorsa: untag-resource

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