Exemplos de Lambda usando AWS CLI

Para adicionar permissões a uma versão de camada

O add-layer-version-permission exemplo a seguir concede permissão para a conta especificada usar a versão 1 da camadamy-layer.

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

Saída:

{
    "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"
    }
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para adicionar permissões a uma função Lambda existente

O add-permission exemplo a seguir concede ao SNS serviço da Amazon permissão para invocar uma função chamadamy-function.

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

Saída:

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

Para obter mais informações, consulte Usando políticas baseadas em recursos para o Lambda AWS no Guia do desenvolvedor do AWS Lambda.

Para criar um alias para uma função do Lambda

O seguinte exemplo de create-alias cria um alias chamado LIVE que aponta para a versão 1 da função my-function do Lambda.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para criar um mapeamento entre uma fonte de eventos e uma função AWS Lambda

O create-event-source-mapping exemplo a seguir cria um mapeamento entre uma SQS fila e a função my-function Lambda.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte AWS Lambda Event Source Mapping no AWS Lambda Developer Guide.

Criar uma função do Lambda

O exemplo create-function a seguir cria uma função do Lambda denominada 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

Conteúdo de my-function.zip:

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

Saída:

{
    "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": ""
}

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para excluir um alias de uma função do Lambda

O seguinte exemplo de delete-alias exclui o alias chamado LIVE da função my-function do Lambda.

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

Este comando não produz saída.

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para excluir o mapeamento entre uma fonte de eventos e uma função AWS Lambda

O delete-event-source-mapping exemplo a seguir exclui o mapeamento entre uma SQS fila e a função Lambdamy-function.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte AWS Lambda Event Source Mapping no AWS Lambda Developer Guide.

Para remover o limite reservado de execução simultânea de uma função

O seguinte exemplo de delete-function-concurrency exclui o limite reservado de execução simultânea da função my-function.

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

Este comando não produz saída.

Para obter mais informações, consulte Como reservar simultaneidade para uma função do Lambda no Guia do desenvolvedor do AWS Lambda.

Para excluir uma configuração de invocação assíncrona

O delete-function-event-invoke-config exemplo a seguir exclui a configuração de invocação assíncrona para o GREEN alias da função especificada.

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

Exemplo 1: excluir uma função do Lambda pelo nome da função

O exemplo de delete-function a seguir exclui a função do Lambda denominada my-function ao especificar o nome da função.

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

Este comando não produz saída.

Exemplo 2: Para excluir uma função Lambda por função ARN

O delete-function exemplo a seguir exclui a função Lambda my-function nomeada especificando a função. ARN

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

Este comando não produz saída.

Exemplo 3: Para excluir uma função Lambda por meio de uma função parcial ARN

O delete-function exemplo a seguir exclui a função Lambda my-function nomeada especificando a parcial da função. ARN

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

Este comando não produz saída.

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para excluir uma versão de uma camada Lambda

O delete-layer-version exemplo a seguir exclui a versão 2 da camada chamadamy-layer.

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

Este comando não produz saída.

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para excluir uma configuração de simultaneidade provisionada

O seguinte exemplo de delete-provisioned-concurrency-config exclui a configuração de simultaneidade provisionada para o alias GREEN da função especificada.

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

Para recuperar detalhes sobre sua conta em uma região AWS

O seguinte exemplo de get-account-settings mostra os limites do Lambda e as informações de uso da sua conta.

aws lambda get-account-settings

Saída:

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

Para obter mais informações, consulte Limites do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para recuperar detalhes sobre um alias de função

O seguinte exemplo de get-alias mostra os detalhes do alias chamado LIVE na função my-function do Lambda.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para recuperar detalhes sobre um mapeamento de origem de eventos

O get-event-source-mapping exemplo a seguir exibe os detalhes do mapeamento entre uma SQS fila e a função my-function Lambda.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte AWS Lambda Event Source Mapping no AWS Lambda Developer Guide.

Para visualizar a configuração de simultaneidade reservada para uma função

O seguinte exemplo de get-function-concurrency recupera a configuração de simultaneidade reservada para a função especificada.

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

Saída:

{
    "ReservedConcurrentExecutions": 250
}

Para recuperar as configurações específicas da versão de uma função do Lambda

O seguinte exemplo de get-function-configuration mostra as configurações da versão 2 da função my-function.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para visualizar uma configuração de invocação assíncrona

O get-function-event-invoke-config exemplo a seguir recupera a configuração de invocação assíncrona para o BLUE alias da função especificada.

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

Saída:

{
    "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"
        }
    }
}

Recuperar informações sobre uma função

O exemplo get-function a seguir mostra informações sobre a função my-function.

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

Saída:

{
    "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": ""
    }
}

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para recuperar informações sobre uma versão da camada Lambda

O get-layer-version-by-arn exemplo a seguir exibe informações sobre a versão da camada com o Amazon Resource Name (ARN) especificado.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para recuperar a política de permissões para uma versão da camada Lambda

O get-layer-version-policy exemplo a seguir exibe informações de política sobre a versão 1 para a camada chamadamy-layer.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para recuperar informações sobre uma versão da camada Lambda

O get-layer-version exemplo a seguir exibe informações para a versão 1 da camada chamadamy-layer.

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

Saída:

{
    "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"
    ]
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para recuperar a IAM política baseada em recursos para uma função, versão ou alias

O seguinte exemplo de get-policy mostra informações de política sobre a função my-function do Lambda.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Usando políticas baseadas em recursos para o Lambda AWS no Guia do desenvolvedor do AWS Lambda.

Para visualizar uma configuração de simultaneidade provisionada

O seguinte exemplo de get-provisioned-concurrency-config mostra detalhes da configuração de simultaneidade provisionada para o alias BLUE da função especificada.

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

Saída:

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

Exemplo 1: invocar uma função do Lambda de forma síncrona

O exemplo de invoke a seguir invoca a função my-function de forma síncrona. A cli-binary-format opção é necessária se você estiver usando a AWS CLI versão 2. Para obter mais informações, consulte as opções globais de linha de comando AWS CLI suportadas no Guia do usuário da interface de linha de AWS comando.

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

Saída:

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

Para obter mais informações, consulte Invocação síncrona no Guia do desenvolvedor do AWS Lambda.

Exemplo 2: invocar uma função do Lambda de forma assíncrona

O exemplo invoke a seguir invoca a função my-function de forma assíncrona. A cli-binary-format opção é necessária se você estiver usando a AWS CLI versão 2. Para obter mais informações, consulte as opções globais de linha de comando AWS CLI suportadas no Guia do usuário da interface de linha de AWS comando.

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

Saída:

{
    "StatusCode": 202
}

Para obter mais informações, consulte Invocação assíncrona no Guia do desenvolvedor do AWS Lambda.

Para recuperar a lista de aliases para uma função Lambda

O list-aliases exemplo a seguir exibe uma lista dos aliases da função my-function Lambda.

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

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para listar os mapeamentos de origem de eventos para uma função

O list-event-source-mappings exemplo a seguir exibe uma lista dos mapeamentos de origem de eventos para a função Lambdamy-function.

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

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte AWS Lambda Event Source Mapping no AWS Lambda Developer Guide.

Para ver uma lista de configurações de invocação assíncrona

O list-function-event-invoke-configs exemplo a seguir lista as configurações de invocação assíncrona para a função especificada.

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

Saída:

{
    "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
        }
    ]
}

Recuperar uma lista de funções do Lambda

O exemplo de list-functions a seguir exibe uma lista de todas as funções do usuário atual.

aws lambda list-functions

Saída:

{
    "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": ""
        }
    ]
}

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para listar as versões de uma camada AWS Lambda

O list-layers-versions exemplo a seguir exibe informações sobre as versões da camada chamadamy-layer.

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

Saída:

{
    "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"
            ]
        }
    ]
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para listar as camadas que são compatíveis com o tempo de execução da sua função

O list-layers exemplo a seguir exibe informações sobre camadas que são compatíveis com o tempo de execução do Python 3.11.

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

Saída:

{
    "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"
                ]
            }
        }
    ]
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para obter uma lista de configurações de simultaneidade provisionada

O seguinte exemplo de list-provisioned-concurrency-configs lista as configurações de simultaneidade provisionada para a função especificada.

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

Saída:

{
    "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"
        }
    ]
}

Para recuperar a lista de tags para uma função do Lambda

O seguinte exemplo de list-tags mostra as tags anexadas à função my-function do Lambda.

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

Saída:

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

Para obter mais informações, consulte Como marcar funções do Lambda no Guia do desenvolvedor do AWS Lambda.

Para recuperar uma lista de versões de uma função

O seguinte exemplo de list-versions-by-function mostra a lista de versões da função my-function do Lambda.

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

Saída:

{
    "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"
        }
    ]
}

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para criar uma versão da camada Lambda

O publish-layer-version exemplo a seguir cria uma nova versão da camada da biblioteca Python. O comando recupera o conteúdo da camada de um arquivo chamado layer.zip no bucket S3 especificado.

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

Saída:

{
    "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"
    ]
}

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para publicar uma nova versão de uma função

O seguinte exemplo de publish-version publica uma nova versão da função my-function do Lambda.

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

Saída:

{
    "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": ""
}

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para configurar um limite de simultaneidade reservado para uma função

O seguinte exemplo de put-function-concurrency configura 100 execuções simultâneas reservadas para a função my-function.

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

Saída:

{
    "ReservedConcurrentExecutions": 100
}

Para obter mais informações, consulte Como reservar simultaneidade para uma função do Lambda no Guia do desenvolvedor do AWS Lambda.

Para configurar o tratamento de erros para invocação assíncrona

O put-function-event-invoke-config exemplo a seguir define a duração máxima do evento de uma hora e desativa as novas tentativas para a função especificada.

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

Saída:

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

Para alocar a simultaneidade provisionada

O seguinte exemplo de put-provisioned-concurrency-config aloca 100 simultaneidades provisionadas para o alias BLUE da função especificada.

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

Saída:

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

Para excluir permissões de versão de camada

O remove-layer-version-permission exemplo a seguir exclui a permissão de uma conta para configurar uma versão de camada.

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

Este comando não produz saída.

Para obter mais informações, consulte AWS Lambda Layers no Lambda Developer AWS Guide.

Para remover permissões de uma função do Lambda existente

O seguinte exemplo de remove-permission remove permissão para invocar uma função chamada my-function.

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

Este comando não produz saída.

Para obter mais informações, consulte Usando políticas baseadas em recursos para o Lambda AWS no Guia do desenvolvedor do AWS Lambda.

Para adicionar tags a uma função do Lambda existente

O seguinte exemplo de tag-resource adiciona uma tag com o nome de chave DEPARTMENT e um valor de Department A à função do Lambda especificada.

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

Este comando não produz saída.

Para obter mais informações, consulte Como marcar funções do Lambda no Guia do desenvolvedor do AWS Lambda.

Para remover tags de uma função do Lambda existente

O seguinte exemplo de untag-resource remove a tag com o nome de chave DEPARTMENT da função my-function do Lambda.

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

Este comando não produz saída.

Para obter mais informações, consulte Como marcar funções do Lambda no Guia do desenvolvedor do AWS Lambda.

Para atualizar um alias de função

O seguinte exemplo de update-alias atualiza um alias chamado LIVE que aponta para a versão 3 da função my-function do Lambda.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Configurando aliases de funções do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para atualizar o mapeamento entre uma fonte de eventos e uma função AWS Lambda

O update-event-source-mapping exemplo a seguir atualiza o tamanho do lote para 8 no mapeamento especificado.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte AWS Lambda Event Source Mapping no AWS Lambda Developer Guide.

Atualizar o código de uma função do Lambda

O update-function-code exemplo a seguir substitui o código da versão não publicada ($LATEST) da my-function função pelo conteúdo do arquivo zip especificado.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Modificar a configuração de uma função

O update-function-configuration exemplo a seguir modifica o tamanho da memória para 256 MB para a versão não publicada ($LATEST) da my-function função.

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

Saída:

{
    "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"
}

Para obter mais informações, consulte Configurar opções da função do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para atualizar uma configuração de invocação assíncrona

O update-function-event-invoke-config exemplo a seguir adiciona um destino em caso de falha à configuração de invocação assíncrona existente para a função especificada.

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

Saída:

{
    "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"
        }
    }
}