UpdateFunctionEventInvokeConfig - AWS Lambda

UpdateFunctionEventInvokeConfig

Atualiza a configuração para invocação assíncrona de uma função, uma versão ou um alias.

Para configurar opções de invocação assíncrona, use PutFunctionEventInvokeConfig.

Sintaxe da Solicitação

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 da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

FunctionName

O nome da função, versão ou alias do Lambda.

Formatos de nome
  • Function name - my-function (somente nome), my-function:v1 (com alias).

  • ARN da função - arn:aws:lambda:us-west-2:123456789012:function:my-function.

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

Você pode anexar um número de versão ou alias a qualquer um dos formatos. A restrição de comprimento se aplica apenas ao ARN completo. Se você especificar apenas o nome da função, ele será limitado a 64 caracteres.

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.

Padrão: (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-_]+))?

Exigido: Sim

Qualifier

Um número de versão ou nome de alias.

Restrições de Tamanho: Tamanho mínimo 1. Comprimento máximo de 128.

Padrão: (|[a-zA-Z0-9$_-]+)

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

DestinationConfig

Um destino para eventos depois que eles foram enviados a uma função para processamento.

Destinos
  • Function (Função) – o nome de recurso da Amazon (ARN) da função do Lambda.

  • Fila: o ARN de uma fila padrão do SQS.

  • Tópico: o ARN de um tópico padrão do SNS.

  • Event Bus (Barramento de eventos) – o ARN de um barramento de eventos do Amazon EventBridge.

Tipo: objeto DestinationConfig

Obrigatório: não

MaximumEventAgeInSeconds

A idade máxima de uma solicitação que o Lambda envia a uma função para processamento.

Tipo: inteiro

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

Obrigatório: não

MaximumRetryAttempts

O número máximo de vezes para tentar novamente quando a função retorna um erro.

Tipo: inteiro

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

Obrigatório: não

Sintaxe da Resposta

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 Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

DestinationConfig

Um destino para eventos depois que eles foram enviados a uma função para processamento.

Destinos
  • Function (Função) – o nome de recurso da Amazon (ARN) da função do Lambda.

  • Fila: o ARN de uma fila padrão do SQS.

  • Tópico: o ARN de um tópico padrão do SNS.

  • Event Bus (Barramento de eventos) – o ARN de um barramento de eventos do Amazon EventBridge.

Tipo: objeto DestinationConfig

FunctionArn

O nome de recurso da Amazon (ARN) da função.

Tipo: string

Padrão: 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

A data e a hora em que a configuração foi atualizada pela última vez, em segundos no tempo do Unix.

Tipo: Carimbo de data/hora

MaximumEventAgeInSeconds

A idade máxima de uma solicitação que o Lambda envia a uma função para processamento.

Tipo: inteiro

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

MaximumRetryAttempts

O número máximo de vezes para tentar novamente quando a função retorna um erro.

Tipo: inteiro

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

Erros

Para obter informações sobre os erros que todas as ações retornam, consulte Erros comuns.

InvalidParameterValueException

Um dos parâmetros da solicitação não é válido.

Código de Status HTTP: 400

ResourceConflictException

O recurso já existe ou outra operação está em andamento.

Código de status HTTP: 409

ResourceNotFoundException

O recurso especificado na solicitação não existe.

Código de Status HTTP: 404

ServiceException

O serviço AWS Lambda encontrou um erro interno.

Código de Status HTTP: 500

TooManyRequestsException

O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte Cotas do Lambda.

Código de status HTTP: 429

Ver também

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte: