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:
