Esempi di Lambda con AWS CLI - AWS Command Line Interface
Operazioni

Esempi di Lambda con AWS CLI

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

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

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare add-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare add-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 AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta AddPermission in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta CreateAlias in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-event-source-mapping.

AWS CLI

Come creare una mappatura tra un’origine eventi e una funzione di 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 AWS Lambda Event Source Mapping nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare create-function.

AWS CLI

Come creare una funzione Lambda

L’esempio 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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta CreateFunction in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta DeleteAlias in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-event-source-mapping.

AWS CLI

Come eliminare la mappatura tra un’origine eventi e una funzione di 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 AWS Lambda Event Source Mapping nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare delete-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 Reserving Concurrency for a Lambda Function nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare delete-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

L’esempio di codice seguente mostra come utilizzare delete-function.

AWS CLI

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

L’esempio 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 in base all’ARN della funzione

L’esempio 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: eliminare una funzione Lambda in base all’ARN parziale della funzione

L’esempio 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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta DeleteFunction in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta DeleteLayerVersion in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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

L’esempio di codice seguente mostra come utilizzare get-account-settings.

AWS CLI

Come recuperare i dettagli dell’account in una Regione AWS

L’esempio get-account-settings seguente mostra i limiti Lambda e le informazioni sull’utilizzo per l’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 Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta GetAccountSettings in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta GetAlias in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 AWS Lambda Event Source Mapping nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare get-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
}

L’esempio di codice seguente mostra come utilizzare get-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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare get-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"
        }
    }
}

L’esempio di codice seguente mostra come utilizzare get-function.

AWS CLI

Come recuperare le informazioni relative a una funzione

Nell’esempio 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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta GetFunction in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta GetLayerVersionByArn in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare get-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta GetLayerVersion in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 relative alla 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 AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta GetPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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"
}

L’esempio di codice seguente mostra come utilizzare invoke.

AWS CLI

Esempio 1: invocare una funzione Lambda in modo sincrono

L’esempio invoke seguente invoca la funzione my-function in modo sincrono. L’opzione cli-binary-format è necessaria se utilizzi la versione 2 di AWS CLI. Per ulteriori informazioni, consulta AWS CLI supported global command line options 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 Invoke a Lambda function synchronously nella Guida per gli sviluppatori di AWS Lambda.

Esempio 2: invocare una funzione Lambda in modo asincrono

L’esempio invoke seguente invoca la funzione my-function in modo asincrono. L’opzione cli-binary-format è necessaria se utilizzi la versione 2 di AWS CLI. Per ulteriori informazioni, consulta AWS CLI supported global command line options 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 Invoking a Lambda function asynchronously nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta Invoke in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta ListAliases in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 AWS Lambda Event Source Mapping nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare list-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
        }
    ]
}

L’esempio di codice seguente mostra come utilizzare list-functions.

AWS CLI

Come recuperare un elenco di funzioni Lambda

L’esempio 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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta ListFunctions in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-layer-versions.

AWS CLI

Come elencare le versioni di un livello di 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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta ListLayerVersions in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta ListLayers in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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"
        }
    ]
}

L’esempio di codice seguente mostra come utilizzare list-tags.

AWS CLI

Come recuperare l’elenco di tag per una funzione Lambda

L’esempio list-tags seguente visualizza i tag associati 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 Lambda Functions nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta ListTags in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-versions-by-function.

AWS CLI

Come recuperare un elenco delle versioni di una funzione

L’esempio list-versions-by-function seguente visualizza l’elenco delle 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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare publish-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta PublishLayerVersion in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare publish-version.

AWS CLI

Come pubblicare una nuova versione di una funzione

L’esempio publish-version seguente pubblica 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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta PublishVersion in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-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.

L’esempio di codice seguente mostra come utilizzare put-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": {}
    }
}

L’esempio di codice seguente mostra come utilizzare put-provisioned-concurrency-config.

AWS CLI

Come allocare la simultaneità fornita

L’esempio put-provisioned-concurrency-config seguente alloca 100 unità di 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"
}

L’esempio di codice seguente mostra come utilizzare remove-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 AWS Lambda Layers nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare remove-permission.

AWS CLI

Come rimuovere le autorizzazioni da una funzione Lambda esistente

L’esempio remove-permission seguente rimuove l’autorizzazione a 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 AWS Lambda nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta RemovePermission in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-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.

  • Per informazioni dettagliate sull’API, consulta TagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-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.

  • Per informazioni dettagliate sull’API, consulta UntagResource in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-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 Configuring AWS Lambda Function Aliases nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta UpdateAlias in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-event-source-mapping.

AWS CLI

Come aggiornare la mappatura tra un’origine eventi e una funzione di 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 AWS Lambda Event Source Mapping nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare update-function-code.

AWS CLI

Come aggiornare il codice di una funzione Lambda

L’esempio 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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

  • Per informazioni dettagliate sull’API, consulta UpdateFunctionCode in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-function-configuration.

AWS CLI

Come modificare la configurazione di una funzione

L’esempio 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 AWS Lambda Function Configuration nella Guida per gli sviluppatori di AWS Lambda.

L’esempio di codice seguente mostra come utilizzare update-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"
        }
    }
}