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à.
# Utilizzo di tag negli strumenti di mappatura dell'origine degli eventi
Puoi taggare gli strumenti di mappatura dell'origine degli eventi per organizzare e gestire le risorse. I tag sono coppie chiave-valore a forma libera associate alle risorse supportate su Servizi AWS. Per ulteriori informazioni sui casi d'uso dei tag, consulta [Strategie di tagging comuni nella Guida AWS](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#tag-strategies) *alle risorse di etichettatura e all'editor di tag*.
Gli strumenti di mappatura dell'origine degli eventi sono associati a funzioni che possono avere i propri tag. Gli strumenti di mappatura dell'origine degli eventi non ereditano automaticamente i tag dalle funzioni. Puoi utilizzare l' AWS Lambda API per visualizzare e aggiornare i tag. Puoi anche visualizzare e aggiornare i tag mentre gestisci una mappatura specifica dell'origine degli eventi nella console Lambda, compresi quelli che utilizzano la modalità Provisioned per Amazon SQS.
## Autorizzazioni necessarie per lavorare con i tag
Per consentire a un'identità AWS Identity and Access Management (IAM) (utente, gruppo o ruolo) di leggere o impostare tag su una risorsa, concedile le autorizzazioni corrispondenti:
+ **lambda: ListTags** —Quando una risorsa contiene dei tag, concedi questa autorizzazione a chiunque debba richiamarla. `ListTags` Per le funzioni con tag, questa autorizzazione è necessaria anche per `GetFunction`.
+ **lambda: TagResource** —Concedi questa autorizzazione a chiunque abbia bisogno di chiamare `TagResource` o eseguire un tag durante la creazione.
Facoltativamente, valuta la possibilità di concedere anche l'UntagResourceautorizzazione **lambda:** per consentire `UntagResource` le chiamate alla risorsa.
Per ulteriori informazioni, consulta [Policy IAM basate sull'identità per Lambda](access-control-identity-based.md).
## Utilizzo di tag con la console Lambda
Puoi utilizzare la console Lambda per creare mappature delle sorgenti di eventi con tag, aggiungere tag alle mappature delle sorgenti di eventi esistenti e filtrare le mappature delle sorgenti degli eventi per tag, comprese quelle configurate in modalità Provisioned per Amazon SQS.
Quando aggiungi un trigger per i servizi basati su flussi e code supportati tramite la console Lambda, Lambda crea automaticamente uno strumento di mappatura dell'origine degli eventi. Per ulteriori informazioni su queste origini eventi, consulta [In che modo Lambda elabora i record provenienti da origini eventi basate su flussi e code](invocation-eventsourcemapping.md). Per creare uno strumento di mappatura dell'origine degli eventi nella console, sono necessari i prerequisiti seguenti:
+ Una funzione .
+ Un'origine eventi proveniente da un servizio interessato.
È possibile aggiungere i tag come parte della stessa interfaccia utente utilizzata per creare o aggiornare i trigger.
**Per aggiungere un tag durante la creazione di uno strumento di mappatura dell'origine degli eventi**
1. Aprire la pagina [Funzioni](https://console.aws.amazon.com/lambda/home#/functions) della console Lambda.
1. Scegli il nome della funzione .
1. In **Panoramica delle funzioni**, scegliere **Aggiungi trigger**.
1. In **Configurazione trigger**, nell'elenco a discesa, scegli il nome del servizio da cui proviene l'origine eventi.
1. Fornisci la configurazione di base per la tua origine eventi. Per ulteriori informazioni sulla configurazione dell'origine eventi, consulta la sezione per il servizio correlato in [Richiamare Lambda con eventi di altri servizi AWS](lambda-services.md).
1. In **Configurazione dello strumento di mappatura dell'origine degli eventi**, scegli **Impostazioni aggiuntive**.
1. In **Tag**, seleziona **Aggiungi nuovo tag**.
1. Nel campo **Chiave**, inserisci la chiave del tag. *Per informazioni sulle restrizioni relative ai tag, consulta [Limiti e requisiti di denominazione dei tag nella Guida alle risorse di etichettatura e all'editor di](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) tag. AWS *
1. Scegliere **Aggiungi**.
**Per aggiungere tag a uno strumento di mappatura dell'origine degli eventi esistente**
1. Apri [Strumenti di mappatura dell'origine degli eventi](https://console.aws.amazon.com/lambda/home#/event-source-mappings) nella console Lambda.
1. Dall'elenco delle risorse, scegli l'**UUID** per lo strumento di mappatura dell'origine degli eventi corrispondente alla **funzione** e all'**ARN dell'origine eventi**.
1. Dall'elenco delle schede sotto il **riquadro di configurazione generale**, scegli **Tag**.
1. Scegliere **Gestisci tag**.
1. Scegliere **Aggiungi nuovo tag**.
1. Nel campo **Chiave**, inserisci la chiave del tag. Per informazioni sulle restrizioni relative ai tag, consulta [Limiti e requisiti di denominazione dei tag nella Guida alle risorse di etichettatura e](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) all'editor di *tag AWS *.
1. Scegli **Save** (Salva).
**Per filtrare gli strumenti di mappatura dell'origine degli eventi per tag**
1. Apri [Strumenti di mappatura dell'origine degli eventi](https://console.aws.amazon.com/lambda/home#/event-source-mappings) nella console Lambda.
1. Scegli la barra di ricerca.
1. Dall'elenco a discesa, seleziona la chiave di tag sotto **Tag**.
1. Seleziona **Usa: "nome-tag"** per vedere tutti gli strumenti di mappatura dell'origine degli eventi etichettati con questa chiave, oppure scegli un **operatore** per filtrare ulteriormente in base al valore.
1. Seleziona il valore del tag da filtrare in base a una combinazione di chiave e valore del tag.
La barra di ricerca supporta anche la ricerca di chiavi di tag. Immetti il nome di una chiave per trovarla nell'elenco.
## Usare i tag con il AWS CLI
Puoi aggiungere e rimuovere tag sulle risorse Lambda esistenti, inclusi gli strumenti di mappatura dell'origine degli eventi, con l'API Lambda. Puoi aggiungere i tag anche quando crei uno strumento di mappatura dell'origine degli eventi, che ti consente di mantenere etichettata una risorsa per tutto il suo ciclo di vita.
### Aggiornamento dei tag con il tag Lambda APIs
Puoi aggiungere e rimuovere tag per le risorse Lambda supportate tramite le operazioni [TagResource](https://docs.aws.amazon.com/lambda/latest/api/API_TagResource.html)e [UntagResource](https://docs.aws.amazon.com/lambda/latest/api/API_UntagResource.html)API.
Puoi chiamare queste operazioni tramite la AWS CLI. Per aggiungere i tag a una risorsa esistente, utilizza il comando `tag-resource`. Questo esempio aggiunge due tag, uno con la chiave *Department* e uno con la chiave*CostCenter*.
```
aws lambda tag-resource \
--resource arn:aws:lambda:us-east-2:123456789012:resource-type:my-resource \
--tags Department=Marketing,CostCenter=1234ABCD
```
Pr rimuovere i tag, utilizza il comando `untag-resource`. Questo esempio rimuove il tag con la chiave*Department*.
```
aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier \
--tag-keys Department
```
### Aggiunta di tag durante la creazione di uno strumento di mappatura dell'origine degli eventi
Per creare una nuova mappatura delle sorgenti di eventi Lambda con tag, utilizza l'[CreateEventSourceMapping](https://docs.aws.amazon.com/lambda/latest/api/API_CreateEventSourceMapping.html)operazione API. Specifica il parametro `Tags`. È possibile richiamare questa operazione con il `create-event-source-mapping` AWS CLI comando e l'`--tags`opzione. *Per ulteriori informazioni sul comando CLI, vedere [create-event-source-mapping](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/create-event-source-mapping.html)nel Command Reference AWS CLI .*
Prima di utilizzare il parametro `Tags` con `CreateEventSourceMapping`, assicurati che il tuo ruolo disponga dell'autorizzazione per etichettare le risorse oltre alle normali autorizzazioni necessarie per questa operazione. Per ulteriori informazioni sulle autorizzazioni per il tagging, consulta [Autorizzazioni necessarie per lavorare con i tag](#esm-tags-required-permissions).
### Visualizzazione dei tag con il tag Lambda APIs
Per visualizzare i tag applicati a una risorsa Lambda specifica, utilizza l'operazione API `ListTags`. Per ulteriori informazioni, consulta [ListTags](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html).
Puoi richiamare questa operazione con il `list-tags` AWS CLI comando fornendo un ARN (Amazon Resource Name).
```
aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier
```
### Filtro delle risorse per tag
Puoi utilizzare l'operazione AWS Resource Groups Tagging API [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)API per filtrare le tue risorse in base ai tag. L'operazione `GetResources` riceve fino a 10 filtri, ognuno dei quali contenente una chiave di tag e un massimo di 10 valori di tag. Fornisci `GetResources` con un `ResourceType` per filtrare in base a tipi di risorse specifiche.
È possibile richiamare questa operazione utilizzando il `get-resources` AWS CLI comando. Per esempi di utilizzo di `get-resources`, consulta [get-resources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html#examples) nella *Riferimento ai comandi CLI di AWS *.