Utilizzo di tag negli strumenti di mappatura dell'origine degli eventi - AWS Lambda

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 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 uno strumento di mappatura dell'origine degli eventi specifico nella console Lambda.

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 ha dei tag, concedi questa autorizzazione a chiunque abbia bisogno di richiamarlaListTags. 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, prendi in considerazione 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.

Utilizzo di tag con la console Lambda

Puoi utilizzare la console Lambda per creare strumenti di mappatura dell'origine degli eventi che hanno tag, aggiungere tag agli strumenti di mappatura dell'origine degli eventi esistenti e filtrare gli strumenti di mappatura dell'origine degli eventi per tag.

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. 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 della console Lambda.

  2. Scegli il nome della funzione .

  3. In Panoramica delle funzioni, scegliere Aggiungi trigger.

  4. In Configurazione trigger, nell'elenco a discesa, scegli il nome del servizio da cui proviene l'origine eventi.

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

  6. In Configurazione dello strumento di mappatura dell'origine degli eventi, scegli Impostazioni aggiuntive.

  7. In Tag, seleziona Aggiungi nuovo tag.

  8. 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 tag AWS .

  9. Scegli Aggiungi.

Per aggiungere tag a uno strumento di mappatura dell'origine degli eventi esistente
  1. Apri Strumenti di mappatura dell'origine degli eventi nella console Lambda.

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

  3. Dall'elenco delle schede sotto il riquadro di configurazione generale, scegli Tag.

  4. Scegliere Gestisci tag.

  5. Scegliere Aggiungi nuovo tag.

  6. 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 tag AWS .

  7. Seleziona Salva.

Per filtrare gli strumenti di mappatura dell'origine degli eventi per tag
  1. Apri Strumenti di mappatura dell'origine degli eventi nella console Lambda.

  2. Scegli la barra di ricerca.

  3. Dall'elenco a discesa, seleziona la chiave di tag sotto Tag.

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

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

Utilizzo dei tag con 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 TagResourcee UntagResourceAPI.

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

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

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'CreateEventSourceMappingoperazione API. Specifica il parametro Tags. È possibile richiamare questa operazione con il create-event-source-mapping AWS CLI comando e l'--tagsopzione. Per ulteriori informazioni sul comando CLI, vedere create-event-source-mappingnel 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.

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.

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 GetResourcesAPI 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 nella Riferimento ai comandi CLI di AWS .