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 l'API e le operazioni di AWS CLI tag
<a name="tags-operations"></a>

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


****  

| "Hello, World\$1" | 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. | 

**Aggiunta di tag durante la creazione di 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.

## Gestire i tag utilizzando azioni API
<a name="tags-operations-examples-java"></a>

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

### Esempio: TagResource
<a name="tags-operations-examples-java-tag-resource"></a>

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
<a name="tags-operations-examples-java-untag-resource"></a>

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
<a name="tags-operations-examples-java-list-tags-for-resource"></a>

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
<a name="tags-operations-examples-cli"></a>

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
<a name="tags-operations-examples-cli-tag-resource"></a>

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. 

**Example**  
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](datastores-hive-cli.md#datastores-hive-cli-registering-a-catalog).

### Elenca i tag di una risorsa: list-tags-for-resource
<a name="tags-operations-examples-cli-list-tags-for-resource"></a>

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"
        }
    ]
}
```

### Rimuovere tag da una risorsa: untag-resource
<a name="tags-operations-examples-cli-untag-resource"></a>

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