Esempi di utilizzo di Lambda AWS CLI - AWS Command Line Interface

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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

Esempi di utilizzo di Lambda AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Lambda.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareadd-layer-version-permission.

AWS CLI

Come aggiungere autorizzazioni a una versione del livello

L’esempio add-layer-version-permission seguente concede all’account specificato l’autorizzazione a utilizzare la versione 1 del livello my-layer.

aws lambda add-layer-version-permission \ --layer-name my-layer \ --statement-id xaccount \ --action lambda:GetLayerVersion \ --principal 123456789012 \ --version-number 1

Output:

{ "RevisionId": "35d87451-f796-4a3f-a618-95a3671b0a0c", "Statement": { "Sid":"xaccount", "Effect":"Allow", "Principal":{ "AWS":"arn:aws:iam::210987654321:root" }, "Action":"lambda:GetLayerVersion", "Resource":"arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1" } }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareadd-permission.

AWS CLI

Come aggiungere le autorizzazioni a una funzione Lambda esistente

Il comando add-permission seguente concede al servizio Amazon SNS l’autorizzazione a invocare la funzione denominata my-function.

aws lambda add-permission \ --function-name my-function \ --action lambda:InvokeFunction \ --statement-id sns \ --principal sns.amazonaws.com

Output:

{ "Statement": { "Sid":"sns", "Effect":"Allow", "Principal":{ "Service":"sns.amazonaws.com" }, "Action":"lambda:InvokeFunction", "Resource":"arn:aws:lambda:us-east-2:123456789012:function:my-function" } }

Per ulteriori informazioni, consulta Using Resource-based Policies for Lambda nella AWS Lambda Developer Guide.AWS

  • Per i dettagli sull'API, consulta Command Reference. AddPermissionAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-alias.

AWS CLI

Come creare un alias per una funzione Lambda

L’esempio create-alias seguente crea un alias denominato LIVE che punta alla versione 1 della funzione Lambda my-function.

aws lambda create-alias \ --function-name my-function \ --description "alias for live version of function" \ --function-version 1 \ --name LIVE

Output:

{ "FunctionVersion": "1", "Name": "LIVE", "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6", "Description": "alias for live version of function" }

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

  • Per i dettagli sull'API, consulta CreateAliasCommand Reference.AWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-event-source-mapping.

AWS CLI

Per creare una mappatura tra un'origine di eventi e una funzione AWS Lambda

L’esempio create-event-source-mapping seguente crea una mappatura tra una coda SQS e la funzione Lambda my-function.

aws lambda create-event-source-mapping \ --function-name my-function \ --batch-size 5 \ --event-source-arn arn:aws:sqs:us-west-2:123456789012:mySQSqueue

Output:

{ "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 5, "State": "Creating", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" }

Per ulteriori informazioni, consulta Strumento di mappatura dell’origine degli eventi AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzarecreate-function.

AWS CLI

Come creare una funzione Lambda

L’esempio di create-function seguente crea una funzione Lambda denominata my-function.

aws lambda create-function \ --function-name my-function \ --runtime nodejs22.x \ --zip-file fileb://my-function.zip \ --handler my-function.handler \ --role arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-tges6bf4

Contenuto di my-function.zip:

This file is a deployment package that contains your function code and any dependencies.

Output:

{ "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=", "FunctionName": "my-function", "CodeSize": 308, "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6", "MemorySize": 128, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Version": "$LATEST", "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4", "Timeout": 3, "LastModified": "2025-10-14T22:26:11.234+0000", "Handler": "my-function.handler", "Runtime": "nodejs22.x", "Description": "" }

Per ulteriori informazioni, consulta Configurazione della memoria della funzione Lambda nella Guida per gli sviluppatori Lambda AWS .

Il seguente esempio di codice mostra come utilizzaredelete-alias.

AWS CLI

Come eliminare un alias di una funzione Lambda

L’esempio delete-alias seguente elimina l’alias denominato LIVE dalla funzione Lambda my-function.

aws lambda delete-alias \ --function-name my-function \ --name LIVE

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

  • Per i dettagli sull'API, consulta DeleteAliasCommand Reference.AWS CLI

Il seguente esempio di codice mostra come utilizzaredelete-event-source-mapping.

AWS CLI

Per eliminare la mappatura tra un'origine di eventi e una funzione AWS Lambda

L’esempio delete-event-source-mapping seguente elimina la mappatura tra una coda SQS e la funzione Lambda my-function.

aws lambda delete-event-source-mapping \ --uuid a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

Output:

{ "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569285870.271, "BatchSize": 5, "State": "Deleting", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" }

Per ulteriori informazioni, consulta Strumento di mappatura dell’origine degli eventi AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzaredelete-function-concurrency.

AWS CLI

Come rimuovere il limite di esecuzione simultanea riservato da una funzione

L’esempio delete-function-concurrency seguente elimina il limite di esecuzione simultanea riservato dalla funzione my-function.

aws lambda delete-function-concurrency \ --function-name my-function

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Prenotazione della simultaneità per una funzione Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzaredelete-function-event-invoke-config.

AWS CLI

Come eliminare una configurazione di invocazione asincrona

L’esempio delete-function-event-invoke-config seguente elimina la configurazione di invocazione asincrona per l’alias GREEN della funzione specificata.

aws lambda delete-function-event-invoke-config --function-name my-function:GREEN

Il seguente esempio di codice mostra come utilizzaredelete-function.

AWS CLI

Esempio 1: come eliminare una funzione Lambda in base al nome della funzione

L’esempio di delete-function seguente elimina la funzione Lambda denominata my-function specificandone il nome.

aws lambda delete-function \ --function-name my-function

Questo comando non produce alcun output.

Esempio 2: eliminazione di una funzione Lambda in base all’ARN della funzione

L’esempio di delete-function seguente elimina la funzione Lambda denominata my-function specificando l’ARN della funzione.

aws lambda delete-function \ --function-name arn:aws:lambda:us-west-2:123456789012:function:my-function

Questo comando non produce alcun output.

Esempio 3: eliminazione di una funzione Lambda in base all’ARN parziale della funzione

L’esempio di delete-function seguente elimina la funzione Lambda denominata my-function specificando l’ARN parziale della funzione.

aws lambda delete-function \ --function-name 123456789012:function:my-function

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Configurazione delle funzioni Lambda AWS nella Guida per gli sviluppatori di AWS .

Il seguente esempio di codice mostra come utilizzaredelete-layer-version.

AWS CLI

Come eliminare la versione di un livello Lambda

L’esempio delete-layer-version seguente elimina la versione 2 del livello denominato my-layer.

aws lambda delete-layer-version \ --layer-name my-layer \ --version-number 2

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzaredelete-provisioned-concurrency-config.

AWS CLI

Come eliminare una configurazione della simultaneità fornita

L’esempio delete-provisioned-concurrency-config seguente elimina la configurazione di simultaneità fornita per l’alias GREEN della funzione specificata.

aws lambda delete-provisioned-concurrency-config \ --function-name my-function \ --qualifier GREEN

Il seguente esempio di codice mostra come utilizzareget-account-settings.

AWS CLI

Per recuperare i dettagli sul tuo account in una regione AWS

L’esempio get-account-settings seguente mostra i limiti Lambda e le informazioni sull’utilizzo per il tuo account.

aws lambda get-account-settings

Output:

{ "AccountLimit": { "CodeSizeUnzipped": 262144000, "UnreservedConcurrentExecutions": 1000, "ConcurrentExecutions": 1000, "CodeSizeZipped": 52428800, "TotalCodeSize": 80530636800 }, "AccountUsage": { "FunctionCount": 4, "TotalCodeSize": 9426 } }

Per ulteriori informazioni, consulta Limiti di AWS Lambda nella Guida per gli sviluppatori di AWS .

Il seguente esempio di codice mostra come utilizzareget-alias.

AWS CLI

Come recuperare i dettagli dell’alias di una funzione

L’esempio get-alias seguente visualizza i dettagli per l’alias denominato LIVE dalla funzione Lambda my-function.

aws lambda get-alias \ --function-name my-function \ --name LIVE

Output:

{ "FunctionVersion": "3", "Name": "LIVE", "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93", "Description": "alias for live version of function" }

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

  • Per i dettagli sull'API, consulta GetAliasCommand Reference.AWS CLI

Il seguente esempio di codice mostra come utilizzareget-event-source-mapping.

AWS CLI

Come recuperare i dettagli relativi a uno strumento di mappatura dell’origine degli eventi

L’esempio get-event-source-mapping seguente mostra i dettagli per la mappatura tra una coda SQS e la funzione Lambda my-function.

aws lambda get-event-source-mapping \ --uuid "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Output:

{ "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 5, "State": "Enabled", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" }

Per ulteriori informazioni, consulta Strumento di mappatura dell’origine degli eventi AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareget-function-concurrency.

AWS CLI

Come visualizzare l’impostazione di simultaneità riservata per una funzione

L’esempio get-function-concurrency seguente recupera l’impostazione della simultaneità riservata per la funzione specificata.

aws lambda get-function-concurrency \ --function-name my-function

Output:

{ "ReservedConcurrentExecutions": 250 }

Il seguente esempio di codice mostra come utilizzareget-function-configuration.

AWS CLI

Come recuperare le impostazioni specifiche della versione di una funzione Lambda

L’esempio get-function-configuration seguente visualizza le impostazioni per la versione 2 della funzione my-function.

aws lambda get-function-configuration \ --function-name my-function:2

Output:

{ "FunctionName": "my-function", "LastModified": "2019-09-26T20:28:40.438+0000", "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d", "MemorySize": 256, "Version": "2", "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq", "Timeout": 3, "Runtime": "nodejs10.x", "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=", "Description": "", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2", "Handler": "index.handler" }

Per ulteriori informazioni, consulta Configurazione delle funzioni Lambda AWS nella Guida per gli sviluppatori di AWS .

Il seguente esempio di codice mostra come utilizzareget-function-event-invoke-config.

AWS CLI

Come visualizzare una configurazione di invocazione asincrona

L’esempio get-function-event-invoke-config seguente recupera la configurazione di invocazione asincrona per l’alias BLUE della funzione specificata.

aws lambda get-function-event-invoke-config \ --function-name my-function:BLUE

Output:

{ "LastModified": 1577824396.653, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600, "DestinationConfig": { "OnSuccess": {}, "OnFailure": { "Destination": "arn:aws:sqs:us-east-2:123456789012:failed-invocations" } } }

Il seguente esempio di codice mostra come utilizzareget-function.

AWS CLI

Come recuperare le informazioni relative a una funzione

Nell’esempio di get-function seguente vengono visualizzate informazioni sulla funzione my-function.

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

Output:

{ "Concurrency": { "ReservedConcurrentExecutions": 100 }, "Code": { "RepositoryType": "S3", "Location": "https://awslambda-us-west-2-tasks.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-function..." }, "Configuration": { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 128, "RevisionId": "28f0fb31-5c5c-43d3-8955-03e76c5c1075", "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2025-09-24T18:20:35.054+0000", "Runtime": "nodejs22.x", "Description": "" } }

Per ulteriori informazioni, consulta Configurazione della memoria della funzione Lambda nella Guida per gli sviluppatori Lambda AWS .

Il seguente esempio di codice mostra come utilizzareget-layer-version-by-arn.

AWS CLI

Come recuperare informazioni su una versione del livello Lambda

L’esempio get-layer-version-by-arn seguente visualizza informazioni sulla versione del livello con il nome della risorsa Amazon (ARN) specificato.

aws lambda get-layer-version-by-arn \ --arn "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2"

Output:

{ "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2", "Description": "AWS Lambda SciPy layer for Python 3.11 (scipy-1.1.0, numpy-1.15.4) https://github.com/scipy/scipy/releases/tag/v1.1.0 https://github.com/numpy/numpy/releases/tag/v1.15.4", "CreatedDate": "2023-10-12T10:09:38.398+0000", "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x", "Content": { "CodeSize": 41784542, "CodeSha256": "GGmv8ocUw4cly0T8HL0Vx/f5V4RmSCGNjDIslY4VskM=", "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/..." }, "Version": 2, "CompatibleRuntimes": [ "python3.11" ], "LicenseInfo": "SciPy: https://github.com/scipy/scipy/blob/main/LICENSE.txt, NumPy: https://github.com/numpy/numpy/blob/main/LICENSE.txt" }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareget-layer-version-policy.

AWS CLI

Come recuperare la policy delle autorizzazioni per una versione del livello Lambda

L’esempio get-layer-version-policy seguente visualizza le informazioni sulla policy relative alla versione 1 per il livello denominato my-layer.

aws lambda get-layer-version-policy \ --layer-name my-layer \ --version-number 1

Output:

{ "Policy": { "Version":"2012-10-17", "Id":"default", "Statement": [ { "Sid":"xaccount", "Effect":"Allow", "Principal": {"AWS":"arn:aws:iam::123456789012:root"}, "Action":"lambda:GetLayerVersion", "Resource":"arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1" } ] }, "RevisionId": "c68f21d2-cbf0-4026-90f6-1375ee465cd0" }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareget-layer-version.

AWS CLI

Come recuperare informazioni su una versione del livello Lambda

L’esempio get-layer-version seguente visualizza informazioni sulla versione 1 del livello denominato my-layer.

aws lambda get-layer-version \ --layer-name my-layer \ --version-number 1

Output:

{ "Content": { "Location": "https://awslambda-us-east-2-layers.s3.us-east-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...", "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=", "CodeSize": 169 }, "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer", "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1", "Description": "My Python layer", "CreatedDate": "2018-11-14T23:03:52.894+0000", "Version": 1, "LicenseInfo": "MIT", "CompatibleRuntimes": [ "python3.10", "python3.11" ] }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareget-policy.

AWS CLI

Come recuperare la policy IAM basata sulle risorse per una funzione, una versione o un alias

L’esempio get-policy seguente mostra le informazioni sulla policy sulla funzione Lambda my-function.

aws lambda get-policy \ --function-name my-function

Output:

{ "Policy": { "Version":"2012-10-17", "Id":"default", "Statement": [ { "Sid":"iot-events", "Effect":"Allow", "Principal": {"Service":"iotevents.amazonaws.com"}, "Action":"lambda:InvokeFunction", "Resource":"arn:aws:lambda:us-west-2:123456789012:function:my-function" } ] }, "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668" }

Per ulteriori informazioni, consulta Using Resource-based Policies for Lambda nella AWS Lambda Developer Guide.AWS

  • Per i dettagli sull'API, consulta Command Reference. GetPolicyAWS CLI

Il seguente esempio di codice mostra come utilizzareget-provisioned-concurrency-config.

AWS CLI

Come visualizzare una configurazione della simultaneità fornita

L’esempio get-provisioned-concurrency-config seguente visualizza i dettagli della configurazione di simultaneità fornita per l’alias BLUE della funzione specificata.

aws lambda get-provisioned-concurrency-config \ --function-name my-function \ --qualifier BLUE

Output:

{ "RequestedProvisionedConcurrentExecutions": 100, "AvailableProvisionedConcurrentExecutions": 100, "AllocatedProvisionedConcurrentExecutions": 100, "Status": "READY", "LastModified": "2019-12-31T20:28:49+0000" }

Il seguente esempio di codice mostra come utilizzareinvoke.

AWS CLI

Esempio 1: come invocare una funzione Lambda in modo sincrono

L’esempio di invoke seguente invoca la funzione my-function in modo sincrono. L'cli-binary-formatopzione è obbligatoria se utilizzi la versione 2 della AWS CLI. Per ulteriori informazioni, consulta Opzioni della riga di comando globali supportate da AWS CLI nella Guida per l’utente dell’Interfaccia della linea di comando AWS .

aws lambda invoke \ --function-name my-function \ --cli-binary-format raw-in-base64-out \ --payload '{ "name": "Bob" }' \ response.json

Output:

{ "ExecutedVersion": "$LATEST", "StatusCode": 200 }

Per ulteriori informazioni, consulta Invocare una funzione Lambda in modo sincrono nella Guida per gli sviluppatori di AWS Lambda.

Esempio 2: come invocare una funzione Lambda in modo asincrono

L’esempio di invoke seguente invoca la funzione my-function in modo asincrono. L'cli-binary-formatopzione è obbligatoria se utilizzi la versione 2 della AWS CLI. Per ulteriori informazioni, consulta Opzioni della riga di comando globali supportate da AWS CLI nella Guida per l’utente dell’Interfaccia della linea di comando AWS .

aws lambda invoke \ --function-name my-function \ --invocation-type Event \ --cli-binary-format raw-in-base64-out \ --payload '{ "name": "Bob" }' \ response.json

Output:

{ "StatusCode": 202 }

Per ulteriori informazioni, consulta Invocare una funzione Lambda in modo asincrono nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta Invoke nella documentazione di riferimento dei comandi della AWS CLI .

Il seguente esempio di codice mostra come usarelist-aliases.

AWS CLI

Come recuperare l’elenco di alias per una funzione Lambda

L’esempio list-aliases seguente visualizza un elenco degli alias per la funzione Lambda my-function.

aws lambda list-aliases \ --function-name my-function

Output:

{ "Aliases": [ { "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:BETA", "RevisionId": "a410117f-ab16-494e-8035-7e204bb7933b", "FunctionVersion": "2", "Name": "BETA", "Description": "alias for beta version of function" }, { "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "21d40116-f8b1-40ba-9360-3ea284da1bb5", "FunctionVersion": "1", "Name": "LIVE", "Description": "alias for live version of function" } ] }

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

  • Per i dettagli sull'API, consulta ListAliasesCommand Reference.AWS CLI

Il seguente esempio di codice mostra come utilizzarelist-event-source-mappings.

AWS CLI

Come elencare gli strumenti di mappatura dell’origine degli eventi per una funzione

L’esempio list-event-source-mappings seguente visualizza un elenco degli strumenti di mappatura dell’origine degli eventi per la funzione Lambda my-function.

aws lambda list-event-source-mappings \ --function-name my-function

Output:

{ "EventSourceMappings": [ { "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 5, "State": "Enabled", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" } ] }

Per ulteriori informazioni, consulta Strumento di mappatura dell’origine degli eventi AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzarelist-function-event-invoke-configs.

AWS CLI

Come visualizzare un elenco di configurazioni di invocazione asincrona

L’esempio list-function-event-invoke-configs seguente elenca le configurazioni di invocazione asincrona per la funzione specificata.

aws lambda list-function-event-invoke-configs \ --function-name my-function

Output:

{ "FunctionEventInvokeConfigs": [ { "LastModified": 1577824406.719, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN", "MaximumRetryAttempts": 2, "MaximumEventAgeInSeconds": 1800 }, { "LastModified": 1577824396.653, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600 } ] }

Il seguente esempio di codice mostra come utilizzarelist-functions.

AWS CLI

Come recuperare un elenco di funzioni Lambda

L’esempio di list-functions seguente visualizza un elenco di tutte le funzioni per l’utente attuale.

aws lambda list-functions

Output:

{ "Functions": [ { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=", "FunctionName": "helloworld", "MemorySize": 128, "RevisionId": "1718e831-badf-4253-9518-d0644210af7b", "CodeSize": 294, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:helloworld", "Handler": "helloworld.handler", "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4", "Timeout": 3, "LastModified": "2025-09-23T18:32:33.857+0000", "Runtime": "nodejs22.x", "Description": "" }, { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668", "CodeSize": 266, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2025-10-01T16:47:28.490+0000", "Runtime": "nodejs22.x", "Description": "" }, { "Layers": [ { "CodeSize": 41784542, "Arn": "arn:aws:lambda:us-west-2:420165488524:layer:AWSLambda-Python37-SciPy1x:2" }, { "CodeSize": 4121, "Arn": "arn:aws:lambda:us-west-2:123456789012:layer:pythonLayer:1" } ], "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "ZQukCqxtkqFgyF2cU41Avj99TKQ/hNihPtDtRcc08mI=", "FunctionName": "my-python-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 128, "RevisionId": "80b4eabc-acf7-4ea8-919a-e874c213707d", "CodeSize": 299, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-python-function", "Handler": "lambda_function.lambda_handler", "Role": "arn:aws:iam::123456789012:role/service-role/my-python-function-role-z5g7dr6n", "Timeout": 3, "LastModified": "2025-10-01T19:40:41.643+0000", "Runtime": "python3.11", "Description": "" } ] }

Per ulteriori informazioni, consulta Configurazione della memoria della funzione Lambda nella Guida per gli sviluppatori Lambda AWS .

Il seguente esempio di codice mostra come utilizzarelist-layer-versions.

AWS CLI

Per elencare le versioni di un layer AWS Lambda

L’esempio list-layers-versions seguente visualizza informazioni sulle versioni del livello denominato my-layer.

aws lambda list-layer-versions \ --layer-name my-layer

Output:

{ "Layers": [ { "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2", "Version": 2, "Description": "My layer", "CreatedDate": "2023-11-15T00:37:46.592+0000", "CompatibleRuntimes": [ "python3.10", "python3.11" ] } ] }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzarelist-layers.

AWS CLI

Come elencare i livelli compatibili con il runtime della funzione

L’esempio list-layers seguente visualizza informazioni sui livelli compatibili con il runtime di Python 3.11.

aws lambda list-layers \ --compatible-runtime python3.11

Output:

{ "Layers": [ { "LayerName": "my-layer", "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer", "LatestMatchingVersion": { "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2", "Version": 2, "Description": "My layer", "CreatedDate": "2023-11-15T00:37:46.592+0000", "CompatibleRuntimes": [ "python3.10", "python3.11" ] } } ] }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzarelist-provisioned-concurrency-configs.

AWS CLI

Come ottenere un elenco di configurazioni di simultaneità fornita

L’esempio list-provisioned-concurrency-configs seguente elenca le configurazioni di simultaneità fornita per la funzione specificata.

aws lambda list-provisioned-concurrency-configs \ --function-name my-function

Output:

{ "ProvisionedConcurrencyConfigs": [ { "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN", "RequestedProvisionedConcurrentExecutions": 100, "AvailableProvisionedConcurrentExecutions": 100, "AllocatedProvisionedConcurrentExecutions": 100, "Status": "READY", "LastModified": "2019-12-31T20:29:00+0000" }, { "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE", "RequestedProvisionedConcurrentExecutions": 100, "AvailableProvisionedConcurrentExecutions": 100, "AllocatedProvisionedConcurrentExecutions": 100, "Status": "READY", "LastModified": "2019-12-31T20:28:49+0000" } ] }

Il seguente esempio di codice mostra come utilizzarelist-tags.

AWS CLI

Come recuperare l’elenco di tag per una funzione Lambda

L’esempio list-tags seguente visualizza i tag collegati alla funzione Lambda my-function.

aws lambda list-tags \ --resource arn:aws:lambda:us-west-2:123456789012:function:my-function

Output:

{ "Tags": { "Category": "Web Tools", "Department": "Sales" } }

Per ulteriori informazioni, consulta Tagging delle funzioni Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzarelist-versions-by-function.

AWS CLI

Come recuperare un elenco delle versioni di una funzione

L’esempio list-versions-by-function seguente visualizza l’elenco di versioni per la funzione Lambda my-function.

aws lambda list-versions-by-function \ --function-name my-function

Output:

{ "Versions": [ { "TracingConfig": { "Mode": "PassThrough" }, "Version": "$LATEST", "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668", "CodeSize": 266, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:$LATEST", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2019-10-01T16:47:28.490+0000", "Runtime": "nodejs10.x", "Description": "" }, { "TracingConfig": { "Mode": "PassThrough" }, "Version": "1", "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "949c8914-012e-4795-998c-e467121951b1", "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:1", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2019-09-26T20:28:40.438+0000", "Runtime": "nodejs10.x", "Description": "new version" }, { "TracingConfig": { "Mode": "PassThrough" }, "Version": "2", "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=", "FunctionName": "my-function", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "MemorySize": 256, "RevisionId": "cd669f21-0f3d-4e1c-9566-948837f2e2ea", "CodeSize": 266, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2", "Handler": "index.handler", "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq", "Timeout": 3, "LastModified": "2019-10-01T16:47:28.490+0000", "Runtime": "nodejs10.x", "Description": "newer version" } ] }

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

Il seguente esempio di codice mostra come utilizzarepublish-layer-version.

AWS CLI

Come creare una versione del livello Lambda

L’esempio publish-layer-version seguente crea una nuova versione del livello di libreria Python. Il comando recupera il contenuto del livello in un file denominato layer.zip nel bucket S3 specificato.

aws lambda publish-layer-version \ --layer-name my-layer \ --description "My Python layer" \ --license-info "MIT" \ --content S3Bucket=lambda-layers-us-west-2-123456789012,S3Key=layer.zip \ --compatible-runtimes python3.10 python3.11

Output:

{ "Content": { "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...", "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=", "CodeSize": 169 }, "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer", "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1", "Description": "My Python layer", "CreatedDate": "2023-11-14T23:03:52.894+0000", "Version": 1, "LicenseInfo": "MIT", "CompatibleRuntimes": [ "python3.10", "python3.11" ] }

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzarepublish-version.

AWS CLI

Come pubblicare una nuova versione di una funzione

L’esempio publish-version seguente illustra la pubblicazione di una nuova versione della funzione Lambda my-function.

aws lambda publish-version \ --function-name my-function

Output:

{ "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=", "FunctionName": "my-function", "CodeSize": 294, "RevisionId": "f31d3d39-cc63-4520-97d4-43cd44c94c20", "MemorySize": 128, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:3", "Version": "2", "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4", "Timeout": 3, "LastModified": "2019-09-23T18:32:33.857+0000", "Handler": "my-function.handler", "Runtime": "nodejs10.x", "Description": "" }

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

  • Per i dettagli sull'API, consulta PublishVersionCommand Reference.AWS CLI

Il seguente esempio di codice mostra come utilizzareput-function-concurrency.

AWS CLI

Come configurare un limite di simultaneità riservata per una funzione

L’esempio put-function-concurrency seguente configura 100 esecuzioni simultanee riservate per la funzione my-function.

aws lambda put-function-concurrency \ --function-name my-function \ --reserved-concurrent-executions 100

Output:

{ "ReservedConcurrentExecutions": 100 }

Per ulteriori informazioni, consulta Reserving Concurrency for a Lambda Function nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareput-function-event-invoke-config.

AWS CLI

Come configurare la gestione degli errori per l’invocazione asincrona

L’esempio put-function-event-invoke-config seguente imposta una durata massima degli eventi pari a un’ora e disattiva i nuovi tentativi per la funzione specificata.

aws lambda put-function-event-invoke-config \ --function-name my-function \ --maximum-event-age-in-seconds 3600 \ --maximum-retry-attempts 0

Output:

{ "LastModified": 1573686021.479, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600, "DestinationConfig": { "OnSuccess": {}, "OnFailure": {} } }

Il seguente esempio di codice mostra come utilizzareput-provisioned-concurrency-config.

AWS CLI

Come allocare la simultaneità fornita

L’esempio put-provisioned-concurrency-config seguente alloca 100 simultaneità fornita per l’alias BLUE della funzione specificata.

aws lambda put-provisioned-concurrency-config \ --function-name my-function \ --qualifier BLUE \ --provisioned-concurrent-executions 100

Output:

{ "Requested ProvisionedConcurrentExecutions": 100, "Allocated ProvisionedConcurrentExecutions": 0, "Status": "IN_PROGRESS", "LastModified": "2019-11-21T19:32:12+0000" }

Il seguente esempio di codice mostra come utilizzareremove-layer-version-permission.

AWS CLI

Come eliminare le autorizzazioni relative alla versione del livello

L’esempio remove-layer-version-permission seguente elimina l’autorizzazione concessa a un account per configurare una versione del livello.

aws lambda remove-layer-version-permission \ --layer-name my-layer \ --statement-id xaccount \ --version-number 1

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Livelli di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareremove-permission.

AWS CLI

Come rimuovere le autorizzazioni da una funzione Lambda esistente

L’esempio remove-permission seguente concede rimuove l’autorizzazione per invocare una funzione denominata my-function.

aws lambda remove-permission \ --function-name my-function \ --statement-id sns

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Using Resource-based Policies for Lambda nella AWS Lambda Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come aggiungere tag a una funzione Lambda esistente

L’esempio tag-resource seguente aggiunge un tag con il nome della chiave DEPARTMENT e un valore di Department A alla funzione Lambda specificata.

aws lambda tag-resource \ --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \ --tags "DEPARTMENT=Department A"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging Lambda Functions nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere i tag da una funzione Lambda esistente

L’esempio untag-resource seguente rimuove il tag con il tag DEPARTMENT per il nome della chiave dalla funzione Lambda my-function.

aws lambda untag-resource \ --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \ --tag-keys DEPARTMENT

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging Lambda Functions nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareupdate-alias.

AWS CLI

Come aggiornare l’alias di una funzione

L’esempio update-alias seguente aggiorna l’alias denominato LIVE che punti alla versione 3 della funzione Lambda my-function.

aws lambda update-alias \ --function-name my-function \ --function-version 3 \ --name LIVE

Output:

{ "FunctionVersion": "3", "Name": "LIVE", "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE", "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93", "Description": "alias for live version of function" }

Per ulteriori informazioni, consulta Configurazione degli alias delle funzioni AWS Lambda nella AWS Lambda Developer Guide.

  • Per i dettagli sull'API, consulta UpdateAliasCommand Reference.AWS CLI

Il seguente esempio di codice mostra come utilizzareupdate-event-source-mapping.

AWS CLI

Per aggiornare la mappatura tra un'origine di eventi e una funzione AWS Lambda

L’esempio update-event-source-mapping seguente aggiorna la dimensione del batch a 8 nella mappatura specificata.

aws lambda update-event-source-mapping \ --uuid "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ --batch-size 8

Output:

{ "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "StateTransitionReason": "USER_INITIATED", "LastModified": 1569284520.333, "BatchSize": 8, "State": "Updating", "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue" }

Per ulteriori informazioni, consulta Strumento di mappatura dell’origine degli eventi AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

Il seguente esempio di codice mostra come utilizzareupdate-function-code.

AWS CLI

Come aggiornare il codice di una funzione Lambda

L’esempio di update-function-code seguente sostituisce il codice della versione ($LATEST) non pubblicata della funzione my-function con i contenuti del file zip specificato.

aws lambda update-function-code \ --function-name my-function \ --zip-file fileb://my-function.zip

Output:

{ "FunctionName": "my-function", "LastModified": "2019-09-26T20:28:40.438+0000", "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d", "MemorySize": 256, "Version": "$LATEST", "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq", "Timeout": 3, "Runtime": "nodejs10.x", "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=", "Description": "", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler" }

Per ulteriori informazioni, consulta Configurazione delle funzioni Lambda AWS nella Guida per gli sviluppatori di AWS .

Il seguente esempio di codice mostra come utilizzareupdate-function-configuration.

AWS CLI

Come modificare la configurazione di una funzione

L’esempio di update-function-configuration seguente modifica la dimensione della memoria in 256 MB per la versione non pubblicata ($LATEST) della funzione my-function.

aws lambda update-function-configuration \ --function-name my-function \ --memory-size 256

Output:

{ "FunctionName": "my-function", "LastModified": "2019-09-26T20:28:40.438+0000", "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d", "MemorySize": 256, "Version": "$LATEST", "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq", "Timeout": 3, "Runtime": "nodejs10.x", "TracingConfig": { "Mode": "PassThrough" }, "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=", "Description": "", "VpcConfig": { "SubnetIds": [], "VpcId": "", "SecurityGroupIds": [] }, "CodeSize": 304, "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function", "Handler": "index.handler" }

Per ulteriori informazioni, consulta Configurazione delle funzioni Lambda AWS nella Guida per gli sviluppatori di AWS .

Il seguente esempio di codice mostra come utilizzareupdate-function-event-invoke-config.

AWS CLI

Come aggiornare una configurazione di invocazione asincrona

L’esempio update-function-event-invoke-config seguente aggiunge una destinazione on-failure alla configurazione di invocazione asincrona esistente per la funzione specificata.

aws lambda update-function-event-invoke-config \ --function-name my-function \ --destination-config '{"OnFailure":{"Destination": "arn:aws:sqs:us-east-2:123456789012:destination"}}'

Output:

{ "LastModified": 1573687896.493, "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST", "MaximumRetryAttempts": 0, "MaximumEventAgeInSeconds": 3600, "DestinationConfig": { "OnSuccess": {}, "OnFailure": { "Destination": "arn:aws:sqs:us-east-2:123456789012:destination" } } }