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à.
# Assegnazione di tag alle risorse Amazon Cognito
Un *tag* è un'etichetta di metadati che tu o AWS assegni a una AWS risorsa. Ciascun tag è formato da una *chiave* e da un *valore*, Per i tag assegnati da te, puoi definire la chiave e il valore. Ad esempio, potresti definire la chiave come `stage`e il valore di una risorsa come `test`.
I tag consentono di:
+ Identifica e organizza le tue risorse. AWS Molti AWS servizi supportano l'etichettatura, in modo da poter assegnare lo stesso tag a risorse di servizi diversi. Questo ti aiuta a indicare quali risorse sono correlate. Ad esempio, puoi assegnare a un bacino d'utenza Amazon Cognito lo stesso tag che si assegna a una tabella Amazon DynamoDB.
+ Tieni traccia dei costi. AWS Puoi attivare questi tag sulla Gestione dei costi e fatturazione AWS dashboard. AWS utilizza i tag di allocazione dei costi per classificare i costi e fornirti un rapporto mensile sull'allocazione dei costi. Per ulteriori informazioni, consulta la pagina sull'[utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *AWS Billing Guida per l'utente*.
+ Controllare gli accessi alle risorse in base ai tag a loro assegnati. Puoi controllare gli accessi specificando chiavi e valori di tag nelle condizioni di una policy AWS Identity and Access Management (IAM). Ad esempio, puoi consentire a un utente di aggiornare un pool di utenti, ma solo se questo dispone di un tag `owner` con un valore del nome di tale utente. Per ulteriori informazioni, consulta [Controllo degli accessi tramite tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella *Guida per l'utente di IAM*.
Puoi utilizzare l'API Amazon Cognito AWS Command Line Interface o l'API Amazon Cognito per aggiungere, modificare o eliminare tag per pool di utenti e identità. In particolare per i bacini d'utenza, puoi anche gestire i tag utilizzando la console di Amazon Cognito.
Per suggerimenti sull'utilizzo dei tag, consulta il post [AWS strategie di assegnazione di tag](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/) nel blog *AWS Risposte*.
Nelle sezioni seguenti vengono fornite ulteriori informazioni sui tag per Amazon Cognito.
## Risorse supportate in Amazon Cognito
Le seguenti risorse in Amazon Cognito supportano l'assegnazione di tag:
+ Bacini d'utenza
+ Pool di identità
## Limitazioni applicate ai tag
Le seguenti restrizioni si applicano ai tag sulle risorse di Amazon Cognito:
+ Numero massimo di tag che è possibile assegnare a una risorsa: 50
+ Lunghezza massima della chiave: 128 caratteri Unicode
+ Lunghezza massima del valore: 256 caratteri Unicode
+ Caratteri validi per chiavi e valori: a-z, A-Z, 0-9, spazi e i seguenti caratteri: \$1 . : / = \$1 - e @
+ Le chiavi e i valori fanno distinzione tra lettere maiuscole
+ Non utilizzare `aws:` come prefisso per le chiavi; l’utilizzo di questo prefisso è riservato per AWS
## Gestione dei tag tramite la console di Amazon Cognito
Puoi utilizzare la console Amazon Cognito per gestire i tag assegnati ai tuoi bacini d'utenza.
**Per aggiungere tag a un bacino d'utenza**
1. Passa alla [console di Amazon Cognito](https://console.aws.amazon.com/cognito/home). Se richiesto, inserisci le tue AWS credenziali.
1. Scegli **User Pools** (Pool di utenti).
1. Scegli un bacino d'utenza esistente dall'elenco o [creane uno nuovo](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pool-as-user-directory.html).
1. Scegli il menu **Impostazioni** e individua la scheda **Tag**.
1. Scegli **Add tags** (Aggiungi tag) per aggiungere il primo tag. Se hai precedentemente assegnato tag a questo bacino d'utenza, in **Gestisci tag** seleziona **Aggiungi un altro**.
1. Specifica i valori per **Tag Key** (Chiave tag) e **Tag Value** (Valore tag).
1. Per ogni ulteriore tag che desideri aggiungere, seleziona **Add another** (Aggiungi un altro).
1. Una volta completata l'aggiunta di tag, scegli **Save changes** (Salva modifiche).
Per etichettare un pool di identità, vai al menu **Pool di identità** e seleziona o crea un pool di identità. Nella scheda delle **proprietà del pool di identità**, individua **Tag**. Seleziona **Aggiungi tag**.
## AWS CLI esempi
AWS CLI Fornisce comandi che ti aiutano a gestire i tag che assegni ai tuoi pool di utenti e pool di identità di Amazon Cognito.
### Assegnazione di tag
Utilizza i seguenti comandi per assegnare tag ai bacini d'utenza e di identità esistenti.
**Example Comando `tag-resource` per i bacini d'utenza**
Assegna tag a un bacino d'utenza utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/tag-resource.html) all'interno del set di comandi `cognito-idp`.
```
$ aws cognito-idp tag-resource \
> --resource-arn user-pool-arn \
> --tags Stage=Test
```
Questo comando include i seguenti parametri:
+ `resource-arn`: l'Amazon Resource Name (ARN) del bacino d'utenza a cui stai applicando i tag. Per trovare l'ARN, seleziona il bacino d'utenza nella console Amazon Cognito e visualizza il valore **ARN del pool** nella scheda **Impostazioni generali**.
+ `tags`: le coppie chiave-valore dei tag, nel formato `key=value`.
Per assegnare più tag in una sola volta, specificali in un elenco separato da virgole:
```
$ aws cognito-idp tag-resource \
> --resource-arn user-pool-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```
**Example Comando `tag-resource` per i pool di identità**
Assegna tag a un pool di identità utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/tag-resource.html) all'interno del set di comandi `cognito-identity`.
```
$ aws cognito-identity tag-resource \
> --resource-arn identity-pool-arn \
> --tags Stage=Test
```
Questo comando include i seguenti parametri:
+ `resource-arn`: l'Amazon Resource Name (ARN) del pool di identità a cui stai applicando i tag. Per cercare l'ARN, seleziona il pool di identità nella console Amazon Cognito e scegli **Modifica pool di identità**. Quindi, in **Identity pool ID** (ID pool di identità), seleziona **Show ARN** (Mostra ARN).
+ `tags`: le coppie chiave-valore dei tag, nel formato `key=value`.
Per assegnare più tag in una sola volta, specificali in un elenco separato da virgole:
```
$ aws cognito-identity tag-resource \
> --resource-arn identity-pool-arn \
> --tags Stage=Test,CostCenter=80432,Owner=SysEng
```
### Visualizzazione dei tag
Utilizza i seguenti comandi per visualizzare i tag che hai assegnato ai bacini d'utenza e di identità.
**Example Comando `list-tags-for-resource` per i bacini d'utenza**
Visualizza i tag assegnati a un bacino d'utenza utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/list-tags-for-resource.html) all'interno del set di comandi `cognito-idp`:
```
$ aws cognito-idp list-tags-for-resource --resource-arn user-pool-arn
```
**Example Comando `list-tags-for-resource` per i pool di identità**
Visualizza i tag assegnati a un pool di identità utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/list-tags-for-resource.html) all'interno del set di comandi `cognito-identity`.
```
$ aws cognito-identity list-tags-for-resource --resource-arn identity-pool-arn
```
### Rimozione dei tag
Utilizza i seguenti comandi per rimuovere tag dai bacini d'utenza e di identità.
**Example Comando `untag-resource` per i bacini d'utenza**
Rimuovi tag da un bacino d'utenza utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/untag-resource.html) all'interno del set di comandi `cognito-idp`:
```
$ aws cognito-idp untag-resource \
> --resource-arn user-pool-arn \
> --tag-keys Stage CostCenter Owner
```
Per il parametro `--tag-keys`, specifica una o più chiavi di tag. Non includere i valori di tag. Separa le chiavi con spazi.
**Example Comando `untag-resource` per i pool di identità**
Rimuovi tag da un pool di identità utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/untag-resource.html) all'interno del set di comandi `cognito-identity`:
```
$ aws cognito-identity untag-resource \
> --resource-arn identity-pool-arn \
> --tag-keys Stage CostCenter Owner
```
Per il parametro `--tag-keys`, specifica una o più chiavi di tag. Non includere i valori di tag.
**Importante**
Dopo aver eliminato un utente o un pool di identità, i tag correlati al pool eliminato possono ancora apparire nella console o nelle chiamate API fino a 30 giorni dopo l'eliminazione.
### Applicazione di tag durante la creazione delle risorse
Utilizza i seguenti comandi per assegnare tag al momento della creazione di un bacino d'utenza o un pool di identità.
**Example Comando `create-user-pool` con tag**
Quando crei un bacino d'utenza utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/create-user-pool.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-idp/create-user-pool.html), puoi specificare tag con il parametro `--user-pool-tags`:
```
$ aws cognito-idp create-user-pool \
> --pool-name user-pool-name \
> --user-pool-tags Stage=Test,CostCenter=80432,Owner=SysEng
```
Le coppie chiave-valore per i tag devono essere nel formato `key=value`. Se aggiungi più tag, specificali in un elenco separato da virgole.
**Example Comando `create-identity-pool` con tag**
Quando crei un pool di identità utilizzando il comando [https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/create-identity-pool.html](https://docs.aws.amazon.com/cli/latest/reference/cognito-identity/create-identity-pool.html), puoi specificare tag con il parametro `--identity-pool-tags`:
```
$ aws cognito-identity create-identity-pool \
> --identity-pool-name identity-pool-name \
> --allow-unauthenticated-identities \
> --identity-pool-tags Stage=Test,CostCenter=80432,Owner=SysEng
```
Le coppie chiave-valore per i tag devono essere nel formato `key=value`. Se aggiungi più tag, specificali in un elenco separato da virgole.
## Gestione dei tag tramite l'API di Amazon Cognito
Puoi utilizzare le seguenti operazioni nell'API di Amazon Cognito per gestire i tag dei bacini d'utenza e dei pool di identità.
### Operazioni API per i tag del bacino d'utenza
Utilizza le seguenti operazioni API per assegnare, visualizzare e rimuovere tag per i bacini d'utenza.
+ [TagResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UntagResource.html)
+ [CreateUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPool.html)
### Operazioni API per i tag del pool di identità
Utilizza le seguenti operazioni API per assegnare, visualizzare e rimuovere tag per i pool di identità.
+ [TagResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_TagResource.html)
+ [ListTagsForResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_ListTagsForResource.html)
+ [UntagResource](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_UntagResource.html)
+ [CreateIdentityPool](https://docs.aws.amazon.com/cognitoidentity/latest/APIReference/API_CreateIdentityPool.html)