Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Configurar o tratamento de erros para invocação assíncrona do Lambda

Modo de foco
Configurar o tratamento de erros para invocação assíncrona do Lambda - AWS Lambda

Use as configurações a seguir para definir como o Lambda lida com erros e novas tentativas para invocações de funções assíncronas:

  • MaximumEventAgeInSeconds: o tempo máximo usado pelo Lambda, em segundos, para que o Lambda mantenha um evento na fila de eventos assíncronos antes de descartá-lo.

  • MaximumRetryAttempts: o número máximo de vezes que o Lambda tenta novamente quando a função retorna um erro.

Use o console do Lambda ou a AWS CLI para definir as configurações de tratamento de erros em uma função, uma versão ou um alias.

Console
Como configurar o tratamento de erros
  1. Abra a página Funções do console do Lambda.

  2. Escolha uma função.

  3. Escolha Configuration (Configuração) e, em seguida, Asynchronous invocation (Invocação assíncrona).

  4. Em Asynchronous invocation (Invocação assíncrona), escolha Edit (Editar).

  5. Configure as definições a seguir.

    • Maximum age of event (Idade máxima do evento): a quantidade máxima de tempo que o Lambda retém um evento na fila de eventos assíncronos, até 6 horas.

    • Retry attempts (Tentativas de repetição): o número de vezes que o Lambda tenta novamente quando a função retorna um erro, entre 0 e 2.

  6. Escolha Salvar.

AWS CLI

Para configurar a invocação assíncrona com o AWS CLI, use o comando put-function-event-invoke-config. O exemplo a seguir configura uma função com uma idade máxima de evento de 1 hora e nenhuma repetição.

aws lambda put-function-event-invoke-config \ --function-name error \ --maximum-event-age-in-seconds 3600 \ --maximum-retry-attempts 0

O comando put-function-event-invoke-config substitui qualquer configuração existente na função, versão ou alias. Para configurar uma opção sem redefinir outras, use update-function-event-invoke-config. O exemplo a seguir configura o Lambda para enviar um registro a uma fila padrão do SQS denominada destination quando um evento não puder ser processado.

aws lambda update-function-event-invoke-config \ --function-name my-function \ --destination-config '{"OnFailure":{"Destination": "arn:aws:sqs:us-east-1:123456789012:destination"}}'
Como configurar o tratamento de erros
  1. Abra a página Funções do console do Lambda.

  2. Escolha uma função.

  3. Escolha Configuration (Configuração) e, em seguida, Asynchronous invocation (Invocação assíncrona).

  4. Em Asynchronous invocation (Invocação assíncrona), escolha Edit (Editar).

  5. Configure as definições a seguir.

    • Maximum age of event (Idade máxima do evento): a quantidade máxima de tempo que o Lambda retém um evento na fila de eventos assíncronos, até 6 horas.

    • Retry attempts (Tentativas de repetição): o número de vezes que o Lambda tenta novamente quando a função retorna um erro, entre 0 e 2.

  6. Escolha Salvar.

A seguinte saída deverá ser mostrada:

{
    "LastModified": 1573686021.479,
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {}
    }
}

Quando um evento de invocação exceder a idade máxima ou falhar em todas as tentativas de repetição, o Lambda o descartará. Para reter uma cópia de eventos descartados, configure um destino de evento com falha.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.