Uso dei tag sulle funzioni Lambda - 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à.

Uso dei tag sulle funzioni Lambda

Puoi etichettare le funzioni per organizzare e gestire le tue risorse. I tag sono coppie chiave-valore in formato libero associate alle risorse e supportate da tutti i servizi. AWS Per ulteriori informazioni sui casi d'uso dei tag, consulta Strategie comuni di tagging nella Tagging Resources and Tag Editor Guide AWS .

I tag si applicano a livello di funzione, non a versioni o alias. I tag non fanno parte della configurazione specifica della versione che AWS Lambda crea un'istantanea di quando si pubblica una versione. Puoi usare Lambda API per visualizzare e aggiornare i tag. Puoi anche visualizzare e aggiornare i tag mentre gestisci una funzione specifica 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 su create.

Per ulteriori informazioni, consulta Politiche basate sull'identità IAM per Lambda.

Utilizzo di tag con la console Lambda

Puoi utilizzare la console Lambda per creare funzioni che hanno tag, aggiungere tag a funzioni esistenti e filtrare le funzioni in base ai tag aggiunti.

Per aggiungere tag durante la creazione di una funzione
  1. Aprire la pagina Funzioni della console Lambda.

  2. Scegli Crea funzione.

  3. Scegliere Author from scratch (Crea da zero) o Container image (Immagine di container).

  4. In Informazioni di base, configura la tua funzione. Per ulteriori informazioni sulla configurazione delle funzioni, vedereConfigurazione delle funzioni AWS Lambda.

  5. Espandi Advanced settings (Impostazioni avanzate), quindi seleziona Enable tags (Abilita tag).

  6. Scegli Add new tag (Aggiungi nuovo tag) e completa i campi Key (Chiave) e facoltativamente Value (Valore). Ripetere questa fase per aggiungere altri tag.

  7. Scegli Crea funzione.

Per aggiungere tag a una funzione esistente
  1. Aprire la pagina Functions (Funzioni) della console Lambda.

  2. Scegliere il nome della funzione.

  3. Scegli Configuration (Configurazione), quindi Tags (Tag).

  4. In Tag, scegli Gestisci tag.

  5. Scegli Add new tag (Aggiungi nuovo tag) e completa i campi Key (Chiave) e facoltativamente Value (Valore). Ripetere questa fase per aggiungere altri tag.

  6. Seleziona Salva.

Per filtrare le funzioni con i tag
  1. Aprire la pagina Funzioni della console Lambda.

  2. Scegliete la casella di ricerca per visualizzare un elenco delle proprietà delle funzioni e dei tasti dei tag.

  3. Scegliete una chiave di tag per visualizzare un elenco di valori in uso nella AWS regione corrente.

  4. Seleziona Usa: «tag-name» per vedere tutte le funzioni etichettate con questo tasto, oppure scegli un operatore per filtrare ulteriormente in base al valore.

  5. Seleziona il valore del tag per filtrare in base a una combinazione di chiave e valore del tag.

La barra di ricerca supporta anche la ricerca di chiavi tag. Immetti tag per visualizzare solo un elenco di chiavi di tag oppure immetti il nome di una chiave per trovarla nell'elenco.

Utilizzo dei tag con AWS CLI

Puoi aggiungere e rimuovere tag su risorse Lambda esistenti, incluse le funzioni, con Lambda. API Puoi anche aggiungere tag durante la creazione di una funzione, il 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 TagResourceand UntagResourceAPI.

È possibile richiamare queste operazioni utilizzando. AWS CLI Per aggiungere tag a una risorsa esistente, utilizzare il tag-resource comando. 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

Aggiungere tag durante la creazione di una funzione

Per creare una nuova funzione Lambda con tag, usa l'CreateFunctionAPIoperazione. Specifica il parametro Tags. È possibile chiamare questa operazione con il create-function CLI comando e l'opzione --tags. Prima di utilizzare il parametro tags conCreateFunction, assicurati che il tuo ruolo disponga dell'autorizzazione a taggare le risorse oltre alle normali autorizzazioni necessarie per questa operazione. Per ulteriori informazioni sulle autorizzazioni per l'etichettatura, consulta. Autorizzazioni necessarie per lavorare con i tag Questo esempio aggiunge due tag, uno con la chiave Department e uno con la chiave CostCenter.

aws lambda create-function --function-name my-function --handler index.js --runtime nodejs20.x \ --role arn:aws:iam::123456789012:role/lambda-role \ --tags Department=Marketing,CostCenter=1234ABCD

Visualizzazione dei tag su una funzione

Per visualizzare i tag applicati a una risorsa Lambda specifica, usa l'ListTagsAPIoperazione. 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

È possibile visualizzare i tag applicati a una risorsa specifica con l'GetFunctionAPIoperazione. Funzionalità comparabili non sono disponibili per altri tipi di risorse.

È possibile richiamare questa operazione con il get-function CLI comando:

aws lambda get-function --function-name my-function

Filtrare le risorse per tag

È possibile utilizzare l' AWS Resource Groups Tagging API GetResourcesAPIoperazione per filtrare le 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 utilizzoget-resources, vedere get-resources nel AWS CLICommand Reference.