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

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 operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare 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

Per aggiungere autorizzazioni a una versione di livello

L'add-layer-version-permissionesempio seguente concede all'account specificato l'autorizzazione a utilizzare la versione 1 del layer. 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareadd-permission.

AWS CLI

Per aggiungere autorizzazioni a una funzione Lambda esistente

L'add-permissionesempio seguente concede al SNS servizio Amazon l'autorizzazione a richiamare una 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 API dettagli, consulta Command Reference. AddPermissionAWS CLI

Il seguente esempio di codice mostra come utilizzarecreate-alias.

AWS CLI

Per creare un alias per una funzione Lambda

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

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 API dettagli, 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'create-event-source-mappingesempio seguente crea una mappatura tra una SQS coda e la funzione Lambdamy-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 AWS Lambda Event Source Mapping nella Lambda AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzarecreate-function.

AWS CLI

Per 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 nodejs18.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": "2023-10-14T22:26:11.234+0000", "Handler": "my-function.handler", "Runtime": "nodejs18.x", "Description": "" }

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

  • Per API i dettagli, vedere CreateFunctionin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-alias.

AWS CLI

Per eliminare un alias di una funzione Lambda

L'delete-aliasesempio seguente elimina l'alias denominato LIVE dalla funzione Lambdamy-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 API dettagli, 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'delete-event-source-mappingesempio seguente elimina la mappatura tra una SQS coda e la funzione my-function Lambda.

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 AWS Lambda Event Source Mapping nella Lambda AWS Developer Guide.

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

AWS CLI

Per rimuovere il limite di esecuzione simultanea riservato da una funzione

L'delete-function-concurrencyesempio 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 Reserved Concurrency for a Lambda Function nella Lambda Developer Guide.AWS

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

AWS CLI

Per eliminare una configurazione di chiamata asincrona

L'delete-function-event-invoke-configesempio seguente elimina la configurazione di chiamata asincrona per l'alias della funzione specificata. GREEN

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: eliminazione di 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: eliminare una funzione Lambda per funzione ARN

L'delete-functionesempio seguente elimina la funzione Lambda my-function denominata specificando quella della funzione. ARN

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

Questo comando non produce alcun output.

Esempio 3: eliminare una funzione Lambda tramite una funzione parziale ARN

L'delete-functionesempio seguente elimina la funzione Lambda my-function denominata specificando il parziale della funzione. ARN

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 .

  • Per API i dettagli, vedere DeleteFunctionin AWS CLI Command Reference.

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

AWS CLI

Per eliminare una versione di un layer Lambda

L'delete-layer-versionesempio seguente elimina la versione 2 del layer 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

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

AWS CLI

Per eliminare una configurazione di concorrenza assegnata

L'delete-provisioned-concurrency-configesempio seguente elimina la configurazione di concorrenza fornita per l'GREENalias 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'get-account-settingsesempio 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 AWS Lambda Limits nella Lambda Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareget-alias.

AWS CLI

Per recuperare dettagli su un alias di funzione

L'get-aliasesempio seguente visualizza i dettagli per l'alias denominato nella LIVE funzione my-function Lambda.

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 API dettagli, consulta GetAliasCommand Reference.AWS CLI

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

AWS CLI

Per recuperare i dettagli sulla mappatura della sorgente di un evento

L'get-event-source-mappingesempio seguente mostra i dettagli per la mappatura tra una SQS coda e la funzione Lambdamy-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 AWS Lambda Event Source Mapping nella Lambda AWS Developer Guide.

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

AWS CLI

Per visualizzare l'impostazione della concorrenza riservata per una funzione

L'get-function-concurrencyesempio seguente recupera l'impostazione della concorrenza 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

Per recuperare le impostazioni specifiche della versione di una funzione Lambda

L'get-function-configurationesempio 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 della funzione Lambda AWS nella Guida per gli sviluppatori di AWS .

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

AWS CLI

Per visualizzare una configurazione di chiamata asincrona

L'get-function-event-invoke-configesempio seguente recupera la configurazione di chiamata asincrona per l'alias della funzione specificata. BLUE

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

Per 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": "2019-09-24T18:20:35.054+0000", "Runtime": "nodejs10.x", "Description": "" } }

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

  • Per API i dettagli, vedere GetFunctionin AWS CLI Command Reference.

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

AWS CLI

Per recuperare informazioni su una versione del layer Lambda

L'get-layer-version-by-arnesempio seguente mostra informazioni sulla versione del layer con l'Amazon Resource Name specificato (ARN).

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 AWS Lambda Layers nella Lambda Developer AWS Guide.

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

AWS CLI

Per recuperare la politica di autorizzazione per una versione del layer Lambda

L'get-layer-version-policyesempio seguente visualizza le informazioni sulle politiche relative alla versione 1 per il layer 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

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

AWS CLI

Per recuperare informazioni su una versione del layer Lambda

L'get-layer-versionesempio seguente visualizza le informazioni per la versione 1 del layer 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareget-policy.

AWS CLI

Per recuperare la IAM politica basata sulle risorse per una funzione, una versione o un alias

L'get-policyesempio seguente visualizza le informazioni sulle politiche relative alla funzione my-function Lambda.

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 API dettagli, consulta Command Reference. GetPolicyAWS CLI

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

AWS CLI

Per visualizzare una configurazione di concorrenza assegnata

L'get-provisioned-concurrency-configesempio seguente visualizza i dettagli della configurazione di concorrenza fornita per l'BLUEalias 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 richiamare una funzione Lambda in modo sincrono

L'esempio di invoke seguente richiama la funzione my-function in modo sincrono. L'cli-binary-formatopzione è obbligatoria se si utilizza la AWS CLI versione 2. Per ulteriori informazioni, consulta le opzioni della riga di comando globali AWS CLI supportate nella Guida per l'utente dell'interfaccia a riga di AWS comando.

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 Chiamata sincrona nella Guida per gli sviluppatori di AWS Lambda.

Esempio 2: come richiamare una funzione Lambda in modo asincrono

L'esempio di invoke seguente richiama la funzione my-function in modo asincrono. L'cli-binary-formatopzione è obbligatoria se si utilizza la AWS CLI versione 2. Per ulteriori informazioni, consulta le opzioni della riga di comando globali AWS CLI supportate nella Guida per l'utente dell'interfaccia a riga di AWS comando.

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 Chiamata asincrona nella Guida per gli sviluppatori di AWS Lambda.

  • Per API i dettagli, consulta Invoke in AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-aliases.

AWS CLI

Per recuperare l'elenco degli alias per una funzione Lambda

L'list-aliasesesempio seguente visualizza un elenco degli alias per la funzione my-function Lambda.

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 API dettagli, consulta ListAliasesCommand Reference.AWS CLI

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

AWS CLI

Per elencare le mappature delle sorgenti degli eventi per una funzione

L'list-event-source-mappingsesempio seguente visualizza un elenco delle mappature delle sorgenti degli eventi per la funzione Lambdamy-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 AWS Lambda Event Source Mapping nella Lambda AWS Developer Guide.

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

AWS CLI

Per visualizzare un elenco di configurazioni di chiamata asincrona

L'list-function-event-invoke-configsesempio seguente elenca le configurazioni di chiamata 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": "2023-09-23T18:32:33.857+0000", "Runtime": "nodejs18.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": "2023-10-01T16:47:28.490+0000", "Runtime": "nodejs18.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": "2023-10-01T19:40:41.643+0000", "Runtime": "python3.11", "Description": "" } ] }

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

  • Per API i dettagli, vedere ListFunctionsin AWS CLI Command Reference.

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

AWS CLI

Per elencare le versioni di un layer AWS Lambda

L'list-layers-versionsesempio seguente visualizza informazioni sulle versioni del layer denominatomy-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 AWS Lambda Layers nella Lambda Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarelist-layers.

AWS CLI

Per elencare i livelli compatibili con il runtime della funzione

L'list-layersesempio seguente mostra 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

  • Per API i dettagli, consulta AWS CLI Command ListLayersReference.

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

AWS CLI

Per ottenere un elenco delle configurazioni di concorrenza assegnate

L'list-provisioned-concurrency-configsesempio seguente elenca le configurazioni di concorrenza assegnate 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

Per recuperare l'elenco dei tag per una funzione Lambda

L'list-tagsesempio seguente visualizza i tag associati alla funzione my-function Lambda.

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 Lambda Functions nella Lambda Developer AWS Guide.

  • Per API i dettagli, consulta Command ListTagsReference AWS CLI .

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

AWS CLI

Per recuperare un elenco di versioni di una funzione

L'list-versions-by-functionesempio seguente visualizza l'elenco delle versioni della funzione my-function Lambda.

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

Per creare una versione del layer Lambda

L'publish-layer-versionesempio 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarepublish-version.

AWS CLI

Per pubblicare una nuova versione di una funzione

L'publish-versionesempio seguente pubblica una nuova versione della funzione my-function Lambda.

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 API dettagli, consulta PublishVersionCommand Reference.AWS CLI

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

AWS CLI

Per configurare un limite di concorrenza riservato per una funzione

L'put-function-concurrencyesempio 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 Reserved Concurrency for a Lambda Function nella Lambda Developer Guide.AWS

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

AWS CLI

Per configurare la gestione degli errori per la chiamata asincrona

L'put-function-event-invoke-configesempio seguente imposta la durata massima degli eventi di un'ora e disabilita 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

Per allocare la concorrenza assegnata

L'put-provisioned-concurrency-configesempio seguente alloca 100 valute simultanee assegnate per l'alias della BLUE 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

Per eliminare le autorizzazioni relative alla versione di livello

L'remove-layer-version-permissionesempio seguente elimina l'autorizzazione di un account a configurare una versione di 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 AWS Lambda Layers nella Lambda Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareremove-permission.

AWS CLI

Per rimuovere le autorizzazioni da una funzione Lambda esistente

L'remove-permissionesempio seguente rimuove l'autorizzazione a richiamare 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

Per aggiungere tag a una funzione Lambda esistente

L'tag-resourceesempio 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 Lambda Developer AWS Guide.

  • Per API i dettagli, consulta Command TagResourceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una funzione Lambda esistente

L'untag-resourceesempio seguente rimuove il tag con il DEPARTMENT tag key name dalla funzione my-function Lambda.

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 Lambda Developer AWS Guide.

  • Per API i dettagli, consulta Command UntagResourceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareupdate-alias.

AWS CLI

Per aggiornare l'alias di una funzione

L'update-aliasesempio seguente aggiorna l'alias denominato in modo LIVE che punti alla versione 3 della funzione my-function Lambda.

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 API dettagli, 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'update-event-source-mappingesempio 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 AWS Lambda Event Source Mapping nella Lambda AWS Developer Guide.

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

AWS CLI

Come aggiornare il codice di una funzione Lambda

L'update-function-codeesempio seguente sostituisce il codice della versione non pubblicata ($LATEST) della my-function funzione con il contenuto 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 della funzione 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'update-function-configurationesempio seguente modifica la dimensione della memoria in 256 MB per la versione non pubblicata ($LATEST) della my-function funzione.

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 della funzione Lambda AWS nella Guida per gli sviluppatori di AWS .

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

AWS CLI

Per aggiornare una configurazione di chiamata asincrona

L'update-function-event-invoke-configesempio seguente aggiunge una destinazione in caso di errore alla configurazione di chiamata 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" } } }