Ejemplos de Lambda utilizando AWS CLI

Para añadir permisos a una versión de capa

En el siguiente add-layer-version-permission ejemplo, se concede permiso a la cuenta especificada para utilizar la versión 1 de la capamy-layer.

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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para añadir permisos a una función Lambda existente

El siguiente add-permission ejemplo concede al SNS servicio de Amazon permiso para invocar una función denominadamy-function.

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

Salida:

{
    "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 obtener más información, consulte Uso de políticas basadas en recursos para Lambda AWS en la Guía para desarrolladores de AWS Lambda.

Creación de un alias para una función de Lambda

En el siguiente ejemplo de create-alias, se crea un alias llamado LIVE que apunta a la versión 1 de la función de Lambda my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Para crear un mapeo entre una fuente de eventos y una función AWS Lambda

El siguiente create-event-source-mapping ejemplo crea un mapeo entre una SQS cola y la función 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

Salida:

{
    "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 obtener más información, consulte Mapeo de fuentes de eventos de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para crear una función de Lambda

El siguiente ejemplo de create-function crea una función de Lambda con el nombre 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

Contenidos de my-function.zip:

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

Salida:

{
    "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 obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Eliminación de un alias de función de Lambda

En el siguiente ejemplo de delete-alias, se elimina el alias nombrado LIVE de la función de Lambda my-function.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Para eliminar el mapeo entre un origen de eventos y una función AWS Lambda

En el siguiente delete-event-source-mapping ejemplo, se elimina la asignación entre una SQS cola y la función Lambdamy-function.

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

Salida:

{
    "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 obtener más información, consulte Mapeo de fuentes de eventos de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Eliminación del límite de ejecución simultánea reservado de una función

En el siguiente ejemplo de delete-function-concurrency, se elimina el límite de ejecución simultánea reservado de la función my-function.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Reserva de simultaneidad para una función de Lambda en la Guía para desarrolladores de AWS Lambda.

Para eliminar una configuración de invocación asíncrona

En el siguiente delete-function-event-invoke-config ejemplo, se elimina la configuración de invocación asíncrona del alias de la función especificada. GREEN

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

Ejemplo 1: eliminar una función de Lambda con el nombre de la función

En el siguiente ejemplo de delete-function, se elimina la función de Lambda denominada my-function especificando el nombre de la función.

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

Este comando no genera ninguna salida.

Ejemplo 2: Para eliminar una función Lambda por función ARN

En el siguiente delete-function ejemplo, se elimina la función Lambda my-function denominada especificando la función. ARN

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

Este comando no genera ninguna salida.

Ejemplo 3: Para eliminar una función Lambda mediante una función parcial ARN

En el siguiente delete-function ejemplo, se elimina la función Lambda my-function denominada especificando el parcial de la función. ARN

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Para eliminar una versión de una capa Lambda

En el siguiente delete-layer-version ejemplo, se elimina la versión 2 de la capa denominada. my-layer

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Eliminación de la configuración de simultaneidad aprovisionada

En el siguiente ejemplo de delete-provisioned-concurrency-config, se elimina la configuración de simultaneidad aprovisionada para el alias GREEN de la función especificada.

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

Para recuperar los detalles de tu cuenta en una AWS región

En el siguiente ejemplo de get-account-settings, se muestran los límites de Lambda y la información de uso de su cuenta.

aws lambda get-account-settings

Salida:

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

Para obtener más información, consulte Límites de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Recuperación de detalles sobre el alias de una función

En el siguiente ejemplo de get-alias, se muestran detalles del alias nombrado LIVE de la función de Lambda my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Para recuperar detalles sobre el mapeo de la fuente de un evento

En el siguiente get-event-source-mapping ejemplo, se muestran los detalles del mapeo entre una SQS cola y la función my-function Lambda.

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

Salida:

{
    "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 obtener más información, consulte Mapeo de fuentes de eventos de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Visualización de la configuración de simultaneidad reservada para una función

En el siguiente ejemplo de get-function-concurrency, se recupera la configuración de simultaneidad reservada para la función especificada.

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

Salida:

{
    "ReservedConcurrentExecutions": 250
}

Recuperación de la configuración específica de la versión de una función de Lambda

En el siguiente ejemplo de get-function-configuration, se muestran los ajustes de la versión 2 de la función my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Para ver una configuración de invocación asíncrona

El siguiente get-function-event-invoke-config ejemplo recupera la configuración de invocación asíncrona para el alias de la función especificada. BLUE

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

Salida:

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

Cómo recuperar información sobre una función

En el siguiente ejemplo de get-function se muestra información sobre la función my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Para recuperar información sobre una versión de capa Lambda

En el siguiente get-layer-version-by-arn ejemplo, se muestra información sobre la versión de la capa con el nombre de recurso de Amazon (ARN) especificado.

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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para recuperar la política de permisos de una versión de capa Lambda

En el siguiente get-layer-version-policy ejemplo, se muestra información sobre la política sobre la versión 1 de la capa denominadamy-layer.

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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para recuperar información sobre una versión de capa Lambda

En el siguiente get-layer-version ejemplo, se muestra información sobre la versión 1 de la capa denominadamy-layer.

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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para recuperar la IAM política basada en recursos de una función, versión o alias

En el siguiente ejemplo de get-policy se muestra información de la política sobre la función de Lambda my-function.

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

Salida:

{
    "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 obtener más información, consulte Uso de políticas basadas en recursos para Lambda AWS en la Guía para desarrolladores de AWS Lambda.

Visualización de una configuración de simultaneidad aprovisionada

En el siguiente ejemplo de get-provisioned-concurrency-config se muestran detalles de la configuración de simultaneidad aprovisionada para el alias BLUE de la función especificada.

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

Salida:

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

Ejemplo 1: invocar una función de Lambda de forma sincrónica

En el siguiente ejemplo de invoke, se invoca la función my-function de forma sincrónica. La cli-binary-format opción es obligatoria si utiliza la AWS CLI versión 2. Para obtener más información, consulte las opciones de línea de comandos globales AWS CLI compatibles en la Guía del usuario de la interfaz de línea de AWS comandos.

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

Salida:

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

Para obtener más información, consulte Invocación sincrónica en la Guía para desarrolladores de Lambda de AWS .

Ejemplo 2: invocar una función de Lambda de forma asíncrona

En el siguiente ejemplo de invoke, se invoca la función my-function de forma asíncrona. La cli-binary-format opción es obligatoria si utiliza la AWS CLI versión 2. Para obtener más información, consulte las opciones de línea de comandos globales AWS CLI compatibles en la Guía del usuario de la interfaz de línea de AWS comandos.

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

Salida:

{
    "StatusCode": 202
}

Para obtener más información, consulte Invocación asíncrona en la Guía para desarrolladores de Lambda de AWS .

Para recuperar la lista de alias de una función Lambda

En el siguiente list-aliases ejemplo, se muestra una lista de los alias de la función my-function Lambda.

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

Salida:

{
    "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 obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Para enumerar las asignaciones de fuentes de eventos de una función

En el siguiente list-event-source-mappings ejemplo, se muestra una lista de las asignaciones de fuentes de eventos para la función Lambdamy-function.

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

Salida:

{
    "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 obtener más información, consulte Mapeo de fuentes de eventos de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para ver una lista de configuraciones de invocación asíncrona

En el siguiente list-function-event-invoke-configs ejemplo, se enumeran las configuraciones de invocación asíncrona de la función especificada.

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

Salida:

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

Cómo recuperar una lista de funciones de Lambda

En el siguiente ejemplo de list-functions, se muestra una lista de todas las funciones para el usuario actual:

aws lambda list-functions

Salida:

{
    "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 obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Para enumerar las versiones de una capa AWS Lambda

En el siguiente list-layers-versions ejemplo, se muestra información sobre las versiones de la capa denominadamy-layer.

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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Para ver una lista de las capas que son compatibles con el tiempo de ejecución de la función

El siguiente list-layers ejemplo muestra información sobre las capas que son compatibles con el motor de ejecución de Python 3.11.

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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Obtención de una lista de configuraciones de simultaneidad aprovisionada

En el siguiente ejemplo list-provisioned-concurrency-configs, se enumeran las configuraciones de simultaneidad aprovisionadas para la función especificada.

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

Salida:

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

Recuperación de la lista de etiquetas para una función de Lambda

En el siguiente ejemplo de list-tags, se muestran las etiquetas asociadas a la función de Lambda my-function.

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

Salida:

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

Para obtener más información, consulte Etiquetas de funciones de Lambda en la Guía para desarrolladores de AWS Lambda.

Recuperación de la lista de versiones de una función

En el siguiente ejemplo de list-versions-by-function, se muestra la lista de versiones de la función de Lambda my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Para crear una versión de capa Lambda

El siguiente publish-layer-version ejemplo crea una nueva versión de capa de biblioteca de Python. El comando recupera el contenido de la capa, un archivo denominado layer.zip en el bucket de 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

Salida:

{
    "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 obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Publicación de una nueva versión de la función de Lambda

En el siguiente ejemplo de publish-version, se publica una nueva versión de la función de Lambda my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Configuración de un límite de simultaneidad reservado para una función

En el siguiente ejemplo de put-function-concurrency, se configuran 100 ejecuciones simultáneas reservadas para la función my-function.

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

Salida:

{
    "ReservedConcurrentExecutions": 100
}

Para obtener más información, consulte Reserva de simultaneidad para una función de Lambda en la Guía para desarrolladores de AWS Lambda.

Para configurar la gestión de errores para la invocación asíncrona

En el siguiente put-function-event-invoke-config ejemplo, se establece una duración máxima del evento de una hora y se deshabilitan los reintentos para la función especificada.

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

Salida:

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

Asignación de simultaneidad aprovisionada

En el siguiente ejemplo de put-provisioned-concurrency-config, se asignan 100 simultaneidades aprovisionadas para el alias BLUE de la función especificada.

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

Salida:

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

Para eliminar los permisos de las versiones de capa

En el siguiente remove-layer-version-permission ejemplo, se elimina el permiso de una cuenta para configurar una versión de capa.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Capas AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Eliminación de permisos de una función de Lambda existente

En el siguiente ejemplo de remove-permission, se elimina el permiso para invocar una función denominada my-function.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Uso de políticas basadas en recursos para Lambda AWS en la Guía para desarrolladores de AWS Lambda.

Adición de etiquetas a una función de Lambda existente

En el siguiente ejemplo de tag-resource, se agrega una etiqueta con el nombre de clave DEPARTMENT y un valor de Department A a la función de Lambda especificada.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetas de funciones de Lambda en la Guía para desarrolladores de AWS Lambda.

Eliminación de etiquetas de una función de Lambda existente

En el siguiente ejemplo de untag-resource, se elimina la etiqueta con el nombre de clave DEPARTMENT de la función de Lambda my-function.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetas de funciones de Lambda en la Guía para desarrolladores de AWS Lambda.

Actualización del alias de una función

En el siguiente ejemplo de update-alias, se actualiza el alias nombrado LIVE para que apunte a la versión 3 de la función de Lambda my-function.

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

Salida:

{
    "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 obtener más información, consulte Configuración de alias de funciones de AWS Lambda en la Guía para desarrolladores de Lambda AWS .

Para actualizar el mapeo entre un origen de eventos y una función AWS Lambda

En el siguiente update-event-source-mapping ejemplo, se actualiza el tamaño del lote a 8 en la asignación especificada.

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

Salida:

{
    "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 obtener más información, consulte Mapeo de fuentes de eventos de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

Cómo actualizar el código de una función de Lambda

En el siguiente update-function-code ejemplo, se reemplaza el código de la versión no publicada ($LATEST) de la my-function función por el contenido del archivo zip especificado.

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

Salida:

{
    "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 obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Para modificar la configuración de una función

El siguiente update-function-configuration ejemplo modifica el tamaño de la memoria para que sea de 256 MB para la versión no publicada ($LATEST) de la my-function función.

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

Salida:

{
    "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 obtener más información, consulte Configuración las funciones de Lambda de AWS en la Guía para desarrolladores de Lambda de AWS .

Para actualizar una configuración de invocación asíncrona

El siguiente update-function-event-invoke-config ejemplo agrega un destino en caso de error a la configuración de invocación asíncrona existente para la función especificada.

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

Salida:

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