Exemplos de Lambda usando AWS CLI

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

O exemplo add-layer-version-permission a seguir concede permissão para a conta especificada usar a versão 1 da camada my-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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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

O exemplo add-permission a seguir concede permissão ao serviço do Amazon SNS para invocar uma função chamada my-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 exemplo create-event-source-mapping a seguir cria um mapeamento entre uma fila SQS e a função do 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

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 Mapeamento da origem do evento do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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 exemplo delete-event-source-mapping a seguir exclui um mapeamento entre uma fila SQS e a função do Lambda my-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 Mapeamento da origem do evento do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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 exemplo delete-function-event-invoke-config a seguir exclui a configuração de invocação assíncrona provisionada para o alias GREEN 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: excluir uma função do Lambda pelo ARN da função

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

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: excluir uma função do Lambda pelo ARN parcial da função

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

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 do Lambda

O exemplo delete-layer-version a seguir exclui a versão 2 da camada chamada my-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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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 da origem do evento

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

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 Mapeamento da origem do evento do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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.

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

O exemplo get-function-event-invoke-config a seguir recupera a configuração de invocação assíncrona provisionada para o alias BLUE 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 de camada do Lambda

O exemplo get-layer-version-by-arn a seguir exibe informações sobre a versão da camada com o nome do recurso da Amazon (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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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

O exemplo get-layer-version-policy a seguir exibe informações de política sobre a versão 1 da camada chamada my-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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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

O exemplo get-layer-version a seguir exibe informações sobre a versão 1 da camada chamada my-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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para recuperar a política do IAM 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 Opções de linha de comando globais compatíveis da AWS CLI no Guia do usuário da AWS Command Line Interface.

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
}

Consulte mais informações em Invocar uma função do Lambda de modo síncrono 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 Opções de linha de comando globais compatíveis da AWS CLI no Guia do usuário da AWS Command Line Interface.

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
}

Consulte mais informações em Invocar uma função do Lambda de modo assíncrono no Guia do desenvolvedor do AWS Lambda.

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

O seguinte exemplo de list-aliases mostra a lista de aliases da função do Lambda my-function.

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 da origem de eventos para uma função

O seguinte exemplo de list-event-source-mappings mostra a lista de mapeamentos da origem de eventos para a função do Lambda my-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 Mapeamento da origem do evento do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Como visualizar uma lista de configurações de invocação assíncrona

O exemplo list-function-event-invoke-configs a seguir lista as configurações de invocação assíncrona provisionadas 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 exemplo list-layers-versions a seguir exibe informações de política sobre as versões da camada chamada my-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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

Para listaras camadas compatíveis com o runtime de uma função.

O exemplo list-layers a seguir exibe informações sobre as camadas compatíveis com o runtime 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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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 do Lambda

O exemplo publish-layer-version 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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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.

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

O exemplo put-function-event-invoke-config a seguir define a duração máxima do evento para 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 da camada

O exemplo remove-layer-version-permission 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 Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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 exemplo update-event-source-mapping 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 Mapeamento da origem do evento do AWS Lambda no Guia do desenvolvedor do AWS Lambda.

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

O exemplo de update-function-code a seguir substitui o código da versão não publicada ($LATEST) da função my-function 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 exemplo de update-function-configuration a seguir modifica o tamanho da memória para 256 MB para a versão não publicada ($LATEST) da função my-function.

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 exemplo update-function-event-invoke-config 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"
        }
    }
}