UpdateFunctionEventInvokeConfig - AWS Lambda

UpdateFunctionEventInvokeConfig

Actualiza la configuración de invocación asincrónica para una función, versión o alias.

Para configurar opciones para la invocación asincrónica, utilice PutFunctionEventInvokeConfig.

Sintaxis de la solicitud

POST /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number }

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

FunctionName

El nombre de función de Lambda, la versión o el alias.

Formatos de nombre
  • Nombre de la función: my-function (solo nombre), my-function:v1 (con alias).

  • ARN de la función: arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • ARN parcial: 123456789012:function:my-function.

Puede incluir un número de versión o alias en cualquiera de los formatos. La limitación de longitud se aplica únicamente al ARN completo. Si solo especifica el nombre de la función, se limita a 64 caracteres de longitud.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.

Patrón: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Obligatorio: sí

Qualifier

Un número de versión o nombre de alias.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.

Patrón: (|[a-zA-Z0-9$_-]+)

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

DestinationConfig

Un destino para eventos después de que se hayan enviado a una función para su procesamiento.

Destinos
  • Función: el nombre de recurso de Amazon (ARN) de una función de Lambda.

  • Cola: el ARN de una cola de SQS estándar.

  • Tema: el ARN de un tema de SNS estándar.

  • Bus de eventos - El ARN de un bus de eventos de Amazon EventBridge.

Tipo: objeto DestinationConfig

Obligatorio: no

MaximumEventAgeInSeconds

La antigüedad máxima de una solicitud que Lambda envía a una función para su procesamiento.

Tipo: entero

Rango válido: valor mínimo de 60. Valor máximo de 21600.

Obligatorio: no

MaximumRetryAttempts

El número máximo de veces que se debe volver a intentar cuando la función devuelve un error.

Tipo: entero

Rango válido: valor mínimo de 0. Valor máximo de 2.

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "FunctionArn": "string", "LastModified": number, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

DestinationConfig

Un destino para eventos después de que se hayan enviado a una función para su procesamiento.

Destinos
  • Función: el nombre de recurso de Amazon (ARN) de una función de Lambda.

  • Cola: el ARN de una cola de SQS estándar.

  • Tema: el ARN de un tema de SNS estándar.

  • Bus de eventos - El ARN de un bus de eventos de Amazon EventBridge.

Tipo: objeto DestinationConfig

FunctionArn

El nombre de recurso de Amazon (ARN) de la función.

Tipo: String

Patrón: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

LastModified

La fecha y hora en las que se actualizó por última vez la configuración, en segundos de tiempo Unix.

Tipo: marca temporal

MaximumEventAgeInSeconds

La antigüedad máxima de una solicitud que Lambda envía a una función para su procesamiento.

Tipo: entero

Rango válido: valor mínimo de 60. Valor máximo de 21600.

MaximumRetryAttempts

El número máximo de veces que se debe volver a intentar cuando la función devuelve un error.

Tipo: entero

Rango válido: valor mínimo de 0. Valor máximo de 2.

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

InvalidParameterValueException

Uno de los parámetros de la solicitud no es válido.

Código de estado HTTP: 400

ResourceConflictException

El recurso ya existe o hay otra operación en marcha.

Código de estado HTTP: 409

ResourceNotFoundException

El recurso especificado en la solicitud no existe.

Código de estado HTTP: 404

ServiceException

El servicio AWS Lambda detectó un error interno.

Código de estado HTTP: 500

TooManyRequestsException

Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte Cuotas de Lambda.

Código de estado HTTP: 429

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: