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 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, spazio e i seguenti caratteri: \_.:/= \+ - @
+ Chiavi e valori distinguono tra maiuscole e minuscole
+ 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 `tag-resource` Comando per pool di utenti**
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 `tag-resource` Comando per 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 `list-tags-for-resource Comando` per pool di utenti**
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 `list-tags-for-resource` Comando per 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 pool di utenti**
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 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}}
```
Key-value le coppie per i tag devono essere nel formato. `{{key}}={{value}}` Se aggiungi più tag, specificali in un elenco separato da virgole.
**Example `create-identity-pool` Comando 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}}
```
Key-value le coppie 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)
## CloudFormation autorizzazioni di etichettatura
Quando crei o aggiorni un pool di utenti o risorse del pool di identità di Amazon Cognito con AWS CloudFormation, CloudFormation puoi propagare tag a livello di stack e tag a livello di sistema alle tue risorse. Per consentire questa propagazione dei tag, il responsabile IAM che distribuisce lo stack deve disporre delle autorizzazioni di tagging oltre alle autorizzazioni per la creazione di risorse.
Ad esempio, per creare un pool di utenti con`cognito-idp:CreateUserPool`, il chiamante deve disporre anche delle seguenti autorizzazioni:
+ `cognito-idp:TagResource`
+ `cognito-idp:UntagResource`
+ `cognito-idp:ListTagsForResource`
Analogamente, per creare un pool di identità con`cognito-identity:CreateIdentityPool`, il chiamante deve disporre anche delle seguenti autorizzazioni:
+ `cognito-identity:TagResource`
+ `cognito-identity:UntagResource`
+ `cognito-identity:ListTagsForResource`
Senza queste autorizzazioni, la creazione o l'aggiornamento dello stack possono fallire quando si CloudFormation tenta di applicare tag alla risorsa. Se vedi un errore di accesso negato relativo al tagging durante un'operazione di stack, verifica che la tua policy IAM includa queste autorizzazioni.