

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

# Tagging delle risorse
<a name="tagging"></a>

Un tag è una coppia chiave-valore che puoi aggiungere a una risorsa Amazon Comprehend come metadati. **Puoi utilizzare i tag nei **job di analisi**, nei modelli di **classificazione personalizzati**, nei modelli di **riconoscimento delle entità personalizzati** e negli endpoint.** I tag hanno due funzioni principali: organizzare le risorse e fornire un controllo degli accessi basato sui tag.

Per organizzare le risorse con i tag, puoi aggiungere la chiave di tag «Dipartimento» e i valori dei tag «Vendite» o «Legale». Puoi quindi cercare e filtrare le risorse pertinenti all'ufficio legale della tua azienda.

Per fornire un controllo degli accessi basato sui tag, crea policy IAM con autorizzazioni basate sui tag. Una policy può consentire o impedire un'operazione in base ai tag forniti nella richiesta (request-tags) o ai tag associati alla risorsa che stai chiamando (resource-tags). *Per ulteriori informazioni sull'utilizzo dei tag con IAM, consulta [Controlling access using](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) tags nella IAM User Guide.*

Considerazioni sull'utilizzo dei tag con Amazon Comprehend:
+ Puoi aggiungere fino a 50 tag per risorsa e i tag possono essere aggiunti al momento della creazione della risorsa o retroattivamente.
+  Una *chiave* di tag è un campo obbligatorio, ma un *valore* di tag è facoltativo.
+ I tag non devono essere univoci tra le risorse, ma una determinata risorsa non può avere chiavi di tag duplicate.
+ I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
+ Una chiave tag può contenere un massimo di 127 caratteri; un valore di tag può avere un massimo di 255 caratteri.
+ Il prefisso `aws:` '' è riservato AWS all'uso; non è possibile aggiungere, modificare o eliminare tag la cui chiave inizia con`aws:`. Questi tag non vengono conteggiati ai fini del tags-per-resource limite di 50.

**Nota**  
Se prevedi di utilizzare lo schema di tagging su più AWS servizi e risorse, ricorda che altri servizi potrebbero avere requisiti diversi per i caratteri consentiti.

**Topics**
+ [Taggare una nuova risorsa](tagging-newtags.md)
+ [Visualizzazione, modifica ed eliminazione dei tag associati a una risorsa](tagging-existingtags.md)

# Taggare una nuova risorsa
<a name="tagging-newtags"></a>

Puoi aggiungere tag a un **processo di analisi**, un modello di **classificazione personalizzato**, un modello di **riconoscimento delle entità personalizzato** o agli **endpoint**.

1. Accedi Console di gestione AWS e apri la console Amazon Comprehend all'indirizzo [https://console.aws.amazon.com/comprehend/](https://console.aws.amazon.com/comprehend/)

1. Seleziona la risorsa (Job di analisi, Classificazione personalizzata o Riconoscimento personalizzato delle entità) che desideri creare dal riquadro di navigazione a sinistra.

1. Fai clic su **Crea lavoro** (o **Crea nuovo modello**). Verrai indirizzato alla pagina principale di «creazione» della tua risorsa. Nella parte inferiore di questa pagina, vedrai il pannello «**Tag -** *opzionale*».  
![\[Visualizzazione da console del pannello dei tag vuoto.\]](http://docs.aws.amazon.com/it_it/comprehend/latest/dg/images/add-tags-2.png)

   Inserisci una chiave di tag e un valore di tag opzionale. Scegli **Aggiungi tag** per aggiungere un altro tag alla risorsa. Ripeti questo processo fino all'aggiunta di tutti i tag. Tieni presente che le chiavi dei tag devono essere uniche per risorsa.

1. Seleziona il pulsante **Crea** o **Crea lavoro** per continuare a creare la tua risorsa.

Puoi anche aggiungere tag utilizzando la AWS CLI. Questo esempio mostra come aggiungere tag con il [start-entities-detection-job](https://docs.aws.amazon.com/cli/latest/reference/comprehend/start-entities-detection-job.html)comando.

```
aws comprehend start-entities-detection-job \
--language-code "en" \
--input-data-config "{\"S3Uri\": \"s3://test-input/TEST.csv\"}" \
--output-data-config "{\"S3Uri\": \"s3://test-output\"}" \
--data-access-role-arn arn:aws:iam::123456789012:role/test \
--tags "[{\"Key\": \"color\",\"Value\": \"orange\"}]"
```

# Visualizzazione, modifica ed eliminazione dei tag associati a una risorsa
<a name="tagging-existingtags"></a>

È possibile visualizzare i tag associati a un **processo di analisi**, un modello di **classificazione personalizzato** o un modello di **riconoscimento delle entità personalizzato**.

1. Accedi Console di gestione AWS e apri la console Amazon Comprehend all'indirizzo [https://console.aws.amazon.com/comprehend/](https://console.aws.amazon.com/comprehend/)

1. Seleziona la risorsa (Analysis job, Custom classification o Custom Entity Recognition) che contiene il file con i tag che desideri visualizzare, modificare o eliminare. Viene visualizzato l'elenco dei file esistenti per la risorsa selezionata.  
![\[Pagina dei lavori di analisi di Amazon Comprehend, che mostra i tuoi processi di analisi.\]](http://docs.aws.amazon.com/it_it/comprehend/latest/dg/images/modify-tags-1.png)

1. Fai clic sul nome del file (o modello) di cui desideri visualizzare, modificare o eliminare i tag. Verrà visualizzata la pagina dei dettagli del file (o modello). Scorri verso il basso fino a visualizzare la casella **Tag**. Qui puoi vedere tutti i tag associati al file (o modello) selezionato.  
![\[Il pannello Tag mostra i tag correnti associati alla risorsa selezionata.\]](http://docs.aws.amazon.com/it_it/comprehend/latest/dg/images/modify-tags-2.png)

   Seleziona **Gestisci tag** per modificare o rimuovere i tag dalla tua risorsa.

1. Fai clic sul testo che desideri modificare, quindi modifica il tag. Puoi anche rimuovere il tag selezionando **Rimuovi tag**. Per aggiungere un nuovo tag, seleziona **Aggiungi tag**, quindi inserisci il testo desiderato nei campi vuoti.  
![\[Il pannello Tag mostra le chiavi e i valori correnti. È possibile modificare i tag, eliminare i tag o aggiungere un tag.\]](http://docs.aws.amazon.com/it_it/comprehend/latest/dg/images/modify-tags-3.png)

   Quando hai finito di modificare i tag, seleziona **Salva**.