Referencia de parámetros y funciones de AWS Lambda

A continuación, se presenta la referencia de las funciones y parámetros que se pueden utilizar para invocar Lambda con Aurora PostgreSQL.

aws_lambda.invoke

Ejecuta una Lambda función destinada a un clúster deAurora PostgreSQL base de datos .

Para obtener más detalles acerca de la invocación de funciones de Lambda, consulte también Invoke en la guía para desarrolladores de AWS Lambda.

Sintaxis

JSON

aws_lambda.invoke(
IN function_name TEXT,
IN payload JSON,
IN region TEXT DEFAULT NULL,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSON DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSON,
OUT executed_version TEXT,
OUT log_result TEXT)

aws_lambda.invoke(
IN function_name aws_commons._lambda_function_arn_1,
IN payload JSON,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSON DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSON,
OUT executed_version TEXT,
OUT log_result TEXT)

JSONB

aws_lambda.invoke(
IN function_name TEXT,
IN payload JSONB,
IN region TEXT DEFAULT NULL,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSONB DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSONB,
OUT executed_version TEXT,
OUT log_result TEXT)

aws_lambda.invoke(
IN function_name aws_commons._lambda_function_arn_1,
IN payload JSONB,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSONB DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSONB,
OUT executed_version TEXT,
OUT log_result TEXT
)

Parámetros de entrada

function_name

El nombre de identificación de la función Lambda. El valor puede ser el nombre de la función, un ARN o un ARN parcial. Para obtener una lista de los formatos posibles, consulte los formatos de nombres de función de Lambda en la guía para desarrolladores de AWS Lambda.

payload

La entrada de la función Lambda. El formato puede ser JSON o JSONB. Para obtener más información, consulte la documentación de PostgreSQL sobre Tipos de JSON.

region

(Opcional) La región Lambda de la función. De forma predeterminada, Aurora resuelve la región de AWS desde el ARN completo en function_name o utiliza la región de instancia de base de datos de Aurora PostgreSQL. Si este valor de región entra en conflicto con el proporcionado en el ARN function_name, se genera un error.

invocation_type

Tipo de invocación de la función Lambda. El valor distingue entre mayúsculas y minúsculas. Entre los valores posibles se incluyen:

• RequestResponse – El valor de tiempo de espera predeterminado. Este tipo de invocación para una función Lambda es sincrónica y devuelve una carga útil de respuesta en el resultado. Utilice el tipo de invocación de RequestResponse cuando el flujo de trabajo dependa de recibir el resultado de la función Lambda inmediatamente.

• Event – Este tipo de invocación para una función Lambda es asincrónica y regresa inmediatamente sin una carga útil devuelta. Utilice el tipo de invocación Event cuando no necesite resultados de la función Lambda antes de que el flujo de trabajo avance.

• DryRun – Este tipo de invocación prueba el acceso sin ejecutar la función Lambda.

log_type

El tipo de registro Lambda que se va a devolver en el parámetro log_result de salida. El valor distingue entre mayúsculas y minúsculas. Entre los valores posibles se incluyen:

• Final – El parámetro de salida log_result devuelto incluirá los últimos 4 KB del registro de ejecución.

• Ninguno – No se devuelve ninguna información de registro Lambda.

context

Contexto del cliente en formato JSON o JSONB. Los campos que se van a utilizar incluyen custom y env.

Calificador

Un calificador que identifica la versión de una función Lambda que se va a invocar. Si este valor entra en conflicto con uno proporcionado en el ARN function_name, se genera un error.

Parámetros de salida

status_code

Un código de respuesta de estado HTTP. Para obtener más información, consulte los elementos de respuesta de invocación de Lambda en la guía para desarrolladores de AWS Lambda.

payload

La información devuelta de la función Lambda que se ejecutó. El formato está en JSON o JSONB.

executed_version

La versión de la función Lambda que se ejecutó.

log_result

La información del registro de ejecución devuelta si el valor log_type es Tail cuando se invocó la función Lambda. El resultado contiene los últimos 4 KB del registro de ejecución codificado en Base64.

aws_commons.create_lambda_function_arn

Crea una estructura aws_commons._lambda_function_arn_1 para contener la información del nombre de función Lambda. Puede utilizar los resultados de la función aws_commons.create_lambda_function_arn en el parámetro function_name de la función aws_lambda.invoke aws_lambda.invoke.

Sintaxis

aws_commons.create_lambda_function_arn(
    function_name TEXT,
    region TEXT DEFAULT NULL
    )
    RETURNS aws_commons._lambda_function_arn_1

Parámetros de entrada

function_name

Una cadena de texto obligatoria que contiene el nombre de la función Lambda. El valor puede ser un nombre de función, un ARN parcial o un ARN completo.

region

Una cadena de texto opcional que contiene la región de AWS en la que se encuentra la función de Lambda. Para ver una lista de los nombres de regiones de y los valores asociados, consulte Regiones y zonas de disponibilidad.

Parámetros de aws_lambda

En esta tabla verá los parámetros asociados a la función aws_lambda.

Parámetro	Descripción
aws_lambda.connect_timeout_ms	Se trata de un parámetro dinámico y establece el tiempo máximo de espera durante la conexión a AWS Lambda. El valor predeterminado es 1000. Los valores permitidos para este parámetro son de 1 a 900 000.
aws_lambda.request_timeout_ms	Se trata de un parámetro dinámico y establece el tiempo máximo de espera a la respuesta de AWS Lambda. El valor predeterminado es 3000. Los valores permitidos para este parámetro son de 1 a 900 000.
aws_lambda.endpoint_override	Especifica el punto de conexión que se puede utilizar para conectarse a AWS Lambda. Una cadena vacía selecciona el punto de conexión de AWS Lambda predeterminado para la región. Debe reiniciar la base de datos para que se aplique el cambio en este parámetro estático.