Ejemplos de Lambda que utilizan la AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Ejemplos de Lambda que utilizan la AWS CLI

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Lambda.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar add-layer-version-permission.

AWS CLI

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

En el siguiente ejemplo de add-layer-version-permission, se concede permiso a la cuenta especificada para utilizar la versión 1 de la capa my-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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

En el siguiente ejemplo de código, se muestra cómo utilizar add-permission.

AWS CLI

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

El siguiente ejemplo de add-permission concede permiso al servicio de Amazon SNS para invocar una función llamada my-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 AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener más información sobre la API, consulte AddPermission en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-alias.

AWS CLI

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para ver los detalles de la API, consulte CreateAlias en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-event-source-mapping.

AWS CLI

Para crear una asignación entre un origen de eventos y una función de AWS Lambda

En el siguiente ejemplo de create-event-source-mapping se crea una asignación entre una cola de SQS y la función de 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

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 sobre los eventos en Lambda, consulte Mapeos de origen de eventos AWS en la Guía para desarrolladores de AWS.

En el siguiente ejemplo de código, se muestra cómo utilizar create-function.

AWS CLI

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

Contenido 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.

  • Para obtener información de la API, consulte CreateFunction en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-alias.

AWS CLI

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para ver los detalles de la API, consulte DeleteTopic en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-event-source-mapping.

AWS CLI

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

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

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 sobre los eventos en Lambda, consulte Mapeos de origen de eventos AWS en la Guía para desarrolladores de AWS.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-function-concurrency.

AWS CLI

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.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-function-event-invoke-config.

AWS CLI

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

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

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

En el siguiente ejemplo de código, se muestra cómo utilizar delete-function.

AWS CLI

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: eliminar una función de Lambda con el ARN de la función

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

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

Este comando no genera ninguna salida.

Ejemplo 3: eliminar una función de Lambda con el ARN parcial de la función

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

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 obtener información de la API, consulte DeleteFunction en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-layer-version.

AWS CLI

Para eliminar una versión de una capa de Lambda

En el siguiente ejemplo de delete-layer-version, se elimina la versión 2 de la capa llamada 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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte DeleteLayerVersion en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-provisioned-concurrency-config.

AWS CLI

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

En el siguiente ejemplo de código, se muestra cómo utilizar get-account-settings.

AWS CLI

Recuperación de detalles de su cuenta en una región de AWS

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.

  • Para obtener información sobre la API, consulte GetAccountSettings en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-alias.

AWS CLI

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para ver los detalles de la API, consulte GetAlias en la Referencia de comandos de AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-event-source-mapping.

AWS CLI

Para recuperar detalles sobre una asignación de orígenes de eventos

En el siguiente ejemplo de get-event-source-mapping se muestran los detalles de la asignación entre una cola de SQS y la función de 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 sobre los eventos en Lambda, consulte Mapeos de origen de eventos AWS en la Guía para desarrolladores de AWS.

  • Para obtener información sobre la API, consulte GetEventSourceMapping en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-function-concurrency.

AWS CLI

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
}

  • Para obtener información sobre la APl, consulte GetFunctionConcurrency en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-function-configuration.

AWS CLI

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.

En el siguiente ejemplo de código, se muestra cómo utilizar get-function-event-invoke-config.

AWS CLI

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

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

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

En el siguiente ejemplo de código, se muestra cómo utilizar get-function.

AWS CLI

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 obtener información sobre la API, consulte GetFunction en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-layer-version-by-arn.

AWS CLI

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

En el siguiente ejemplo de get-layer-version-by-arn se muestra información sobre la versión de 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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte GetLayerVersionByArn en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-layer-version-policy.

AWS CLI

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

En el siguiente ejemplo de get-layer-version-policy, se muestra información sobre la política de la versión 1 de la capa llamada my-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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte GetLayerVersionPolicy en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-layer-version.

AWS CLI

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

En el siguiente ejemplo de get-layer-version, se muestra información sobre la versión 1 de la capa llamada my-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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte GetLayerVersion en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-policy.

AWS CLI

Recuperación de la política de IAM basada en recursos para una función, una versión o un 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 AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte GetPolicy en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-provisioned-concurrency-config.

AWS CLI

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

En el siguiente ejemplo de código, se muestra cómo utilizar invoke.

AWS CLI

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 opción cli-binary-format es obligatoria si va a utilizar la versión 2 de la CLI de AWS. Para obtener más información, consulte las opciones globales de la línea de comandos admitidas en la CLI de AWS en la Guía del usuario de la interfaz de línea de comandos de AWS.

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 opción cli-binary-format es obligatoria si va a utilizar la versión 2 de la CLI de AWS. Para obtener más información, consulte las opciones globales de la línea de comandos admitidas en la CLI de AWS en la Guía del usuario de la interfaz de línea de comandos de AWS.

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 obtener información sobre la API, consulte Invocar en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-aliases.

AWS CLI

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

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

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para ver los detalles de la API, consulte ListAliases en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-event-source-mappings.

AWS CLI

Para mostrar las asignaciones de orígenes de eventos de una función

En el siguiente ejemplo de list-event-source-mappings se muestra una lista de asignaciones de orígenes de eventos de la función de Lambda my-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 sobre los eventos en Lambda, consulte Mapeos de origen de eventos AWS en la Guía para desarrolladores de AWS.

  • Para obtener información sobre la API, consulte ListEventSourceMappings en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-function-event-invoke-configs.

AWS CLI

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

En el siguiente ejemplo de list-function-event-invoke-configs se enumeran las configuraciones de invocación asíncrona para 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
        }
    ]
}

En el siguiente ejemplo de código, se muestra cómo utilizar list-functions.

AWS CLI

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 obtener información sobre la API, consulte ListFunctions en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-layer-versions.

AWS CLI

Para mostrar las versiones de una capa de AWS Lambda

En el siguiente ejemplo de list-layers-versions se muestra información sobre las versiones de la capa llamada my-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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte ListLayerVersions en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-layers.

AWS CLI

Para mostrar capas que sean compatibles con el tiempo de ejecución de una función

En el siguiente ejemplo de list-layers se muestra información sobre las capas que son compatibles con el tiempo 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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte ListLayers en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-provisioned-concurrency-configs.

AWS CLI

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

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags.

AWS CLI

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.

  • Para obtener más información sobre la API, consulte ListTags en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-versions-by-function.

AWS CLI

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte ListVersionsByFunction en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar publish-layer-version.

AWS CLI

Para crear una versión de capa de Lambda

En el siguiente ejemplo de publish-layer-version se crea una nueva versión de capa de biblioteca de Python. El comando recupera el contenido de la capa, un archivo llamado 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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte PublishLayerVersion en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar publish-version.

AWS CLI

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener detalles de la API, consulte PublishVersion en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-function-concurrency.

AWS CLI

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 obtener información sobre la API, consulte PutFunctionConcurrency en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-function-event-invoke-config.

AWS CLI

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

En el siguiente ejemplo de put-function-event-invoke-config se establece una duración máxima de eventos 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": {}
    }
}

En el siguiente ejemplo de código, se muestra cómo utilizar put-provisioned-concurrency-config.

AWS CLI

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

En el siguiente ejemplo de código, se muestra cómo utilizar remove-layer-version-permission.

AWS CLI

Para eliminar permisos de versiones de capa

En el siguiente ejemplo de remove-layer-version-permission 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 de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

En el siguiente ejemplo de código, se muestra cómo utilizar remove-permission.

AWS CLI

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 AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para obtener información sobre la API, consulte RemovePermission en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource.

AWS CLI

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.

  • Para ver los detalles de la API, consulte TagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource.

AWS CLI

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.

  • Para ver los detalles de la API, consulte UntagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-alias.

AWS CLI

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 los alias de las funciones de AWS Lambda en la Guía para desarrolladores de AWS Lambda.

  • Para ver los detalles de la API, consulte UpdateAlias en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-event-source-mapping.

AWS CLI

Para actualizar la asignación entre un origen de eventos y una función de AWS Lambda

En el siguiente ejemplo de update-event-source-mapping se actualiza el tamaño de lote a ocho 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 sobre los eventos en Lambda, consulte Mapeos de origen de eventos AWS en la Guía para desarrolladores de AWS.

En el siguiente ejemplo de código, se muestra cómo utilizar update-function-code.

AWS CLI

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

En el siguiente ejemplo de update-function-code, se reemplaza el código de la versión no publicada ($LATEST) de la función my-function 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 obtener información acerca de la API, consulte UpdateFunctionCode en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-function-configuration.

AWS CLI

Para modificar la configuración de una función

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

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.

En el siguiente ejemplo de código, se muestra cómo utilizar update-function-event-invoke-config.

AWS CLI

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

En el siguiente ejemplo de update-function-event-invoke-config se agrega un destino en caso de fallo 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"
        }
    }
}