Como testar funções do Lambda no console - AWS Lambda

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como testar funções do Lambda no console

Você pode testar sua função do Lambda no console invocando sua função com um evento de teste. Um evento de teste é uma entrada JSON para sua função. Se a função não necessitar de entrada, o evento poderá ser um documento vazio ({}).

Quando você executa um teste no console, o Lambda invoca sua função de maneira síncrona com o evento de teste. O runtime da função converte o JSON do evento em um objeto e o transmite ao método do manipulador do código para processamento.

Criar um evento de teste

Antes de testar no console, é necessário criar um evento de teste privado ou compartilhável.

Como invocar funções com eventos de teste

Para testar uma função
  1. Abra a página Funções do console do Lambda.

  2. Escolha o nome da função que deseja testar.

  3. Selecione a guia Test (Testar).

  4. Em Evento de teste, escolha Criar evento ou Editar evento salvo e escolha o evento salvo que deseja usar.

  5. Opcionalmente, escolha um Modelo para o JSON do evento.

  6. Escolha Testar.

  7. Para analisar os resultados do teste, em Execution result (Resultado da execução), expanda Details (Detalhes).

Para invocar sua função sem salvar seu evento de teste, escolha Test (Testar) antes de salvar. Isso cria um evento de teste não salvo que o Lambda preservará somente durante a sessão.

Na guia Code (Código), também é possível acessar seus eventos de teste salvos e não salvos. Em seguida, escolha Test (Testar) e escolha seu evento de teste.

Criar eventos de teste privados

Os eventos privados de teste estão disponíveis apenas para o criador do evento e não exigem permissões adicionais para uso. É possível criar e salvar até 10 eventos privados de teste por função.

Para criar um evento privado de teste
  1. Abra a página Funções do console do Lambda.

  2. Escolha o nome da função que deseja testar.

  3. Selecione a guia Test (Testar).

  4. Em Test event (Evento de teste), faça o seguinte:

    1. Escolha um Template (Modelo).

    2. Insira um Name (Nome) para o teste.

    3. Na caixa de entrada de texto, insira o evento de teste JSON.

    4. Em Event sharing settings (Configurações de compartilhamento de eventos), escolha Private (Privado).

  5. Escolha Salvar alterações.

Você também pode criar novos eventos de teste na guia Code (Código). Em seguida, escolha Test (Testar), Configure test event (Configurar evento de teste).

Criar eventos de teste compartilháveis

Eventos de teste compartilháveis são eventos de teste que você pode compartilhar com outros usuários na mesma conta da AWS. É possível editar eventos compartilháveis de teste de outros usuários e invocar sua função com esses eventos.

O Lambda salva eventos de teste compartilháveis como esquemas em um registro de esquema da Amazon EventBridge (CloudWatch Events) chamado. lambda-testevent-schemas Como o Lambda utiliza esse registro para armazenar e chamar eventos compartilháveis de teste que você cria, recomendamos que não edite esse registro nem crie um registro usando o nome lambda-testevent-schemas.

Para ver, compartilhar e editar eventos de teste compartilháveis, você deve ter permissões para todas as seguintes operações da API de registro de esquema EventBridge (CloudWatch Eventos):

Observe que o salvamento de edições feitas em um evento compartilhável de teste resulta na substituição do respectivo evento.

Se não puder criar, editar ou ver eventos compartilháveis de teste, verifique se sua conta tem as permissões necessárias para essas operações. Se você tiver as permissões necessárias, mas ainda não conseguir acessar eventos de teste compartilháveis, verifique se há políticas baseadas em recursos que possam limitar o acesso ao registro EventBridge (CloudWatch Eventos).

Para criar um evento compartilhável de teste
  1. Abra a página Funções do console do Lambda.

  2. Escolha o nome da função que deseja testar.

  3. Selecione a guia Test (Testar).

  4. Em Test event (Evento de teste), faça o seguinte:

    1. Escolha um Template (Modelo).

    2. Insira um Name (Nome) para o teste.

    3. Na caixa de entrada de texto, insira o evento de teste JSON.

    4. Em Event sharing settings (Configurações de compartilhamento de eventos), escolha Shareable (Compartilhável).

  5. Escolha Salvar alterações.

Use eventos de teste compartilháveis com AWS Serverless Application Model.

É possível usar o AWS SAM para invocar eventos de teste compartilháveis. Consulte sam remote test-event no Guia do desenvolvedor do AWS Serverless Application Model

Excluir esquemas de eventos compartilháveis de teste

Quando você exclui eventos compartilháveis de teste, o Lambda os remove do registro lambda-testevent-schemas. Se você remover o último evento compartilhável de teste do registro, o Lambda excluirá o registro.

Se excluir a função, o Lambda não excluirá nenhum esquema associado de evento compartilhável de teste. Você deve limpar esses recursos manualmente no console EventBridge (CloudWatch Eventos).