Tratar condições de erro usando uma máquina de estado Step Functions

Abra as AWS Lambda console em https://console.aws.amazon.com/lambda/.

Escolha a opção Criar função.

Escolha Usar um esquema, insira step-functions na caixa de pesquisa e escolha o esquema Throw a custom error (Lançar um erro personalizado).

Em Function name (Nome da função), insira FailFunction.

Para Função, retenha a seleção-padrão (Create a new role with basic Lambda permissions (Criar uma função com permissões básicas do Lambda)).

O código a seguir é exibido no painel Código de função do Lambda.

exports.handler = async (event, context) => {
    function CustomError(message) {
        this.name = 'CustomError';
        this.message = message;
    }
    CustomError.prototype = new Error();

    throw new CustomError('This is a custom error!');
};

O objeto context retorna a mensagem de erro This is a custom error!.

Escolha a opção Criar função.

Depois que sua função Lambda for criada, copie o Amazon Resource Name (ARN) da função exibido no canto superior direito da página. Veja a seguir um exemploARN:

arn:aws:lambda:us-east-1:123456789012:function:FailFunction

Escolha Implantar.

Na FailFunctionpágina, escolha a guia Teste e, em seguida, escolha Teste. Não é necessário criar um evento de teste.

Para analisar os resultados do teste, em Resultado da execução, expanda Detalhes.

Abra o console do Step Functions e clique em Criar máquina de estado.

Na caixa de diálogo Escolher um modelo, selecione Em branco.

Escolha Selecionar para abrir o Workflow Studio emModo de design.

Selecione Código para abrir o editor de código. No editor de código, você escreve e edita a definição Amazon States Language (ASL) dos seus fluxos de trabalho.

Cole o código a seguir, mas ARN substitua a função Lambda que você criou anteriormente no Resource campo.

{
   "Comment": "A Catch example of the Amazon States Language using an AWS Lambda function",
   "StartAt": "CreateAccount",
   "States": {
      "CreateAccount": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:FailFunction",
         "Catch": [ {
            "ErrorEquals": ["CustomError"],
            "Next": "CustomErrorFallback"
         }, {
            "ErrorEquals": ["States.TaskFailed"],
            "Next": "ReservedTypeFallback"
         }, {
            "ErrorEquals": ["States.ALL"],
            "Next": "CatchAllFallback"
         } ],
         "End": true
      },
      "CustomErrorFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from a custom Lambda function exception",
         "End": true
      },
      "ReservedTypeFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from a reserved error code",
         "End": true
      },
      "CatchAllFallback": {
         "Type": "Pass",
         "Result": "This is a fallback from any error code",
         "End": true
      }
   }
}

Essa é uma descrição da máquina de estado usando a Amazon States Language. Ela define um estado Task específico denominado CreateAccount. Para obter mais informações, consulte Estrutura da máquina de estado.

Para obter mais informações sobre a sintaxe do campo Retry, consulte Exemplos de máquinas de estado usando Retry e usando Catch.

(Opcional) No Visualização de grafos, veja a visualização gráfica em tempo real do seu fluxo de trabalho.

Especifique um nome para a máquina de estado. Para fazer isso, escolha o ícone de edição ao lado do nome padrão da máquina de estado de MyStateMachine. Em seguida, em Configuração da máquina de estado, insira um nome na caixa Nome da máquina de estado.

Para este tutorial, insira Catchfailure.

(Opcional) Em Configuração da máquina de estado, especifique outras configurações do fluxo de trabalho, como o tipo de máquina de estado e a função de execução.

Para este tutorial, mantenha todas as seleções padrão nas Configurações da máquina de estado.

Na caixa de diálogo Confirmar criação do perfil, selecione Confirmar para continuar.

Você também pode escolher Exibir configurações do perfil para voltar às Configurações da máquina de estado.

Na página Máquinas de estado, escolha Catchfailure.

Na página Catchfailure, escolha Iniciar execução. A caixa de diálogo Iniciar execução é exibida.

Na caixa de diálogo Iniciar execução, faça o seguinte:

Por exemplo, para visualizar sua mensagem de erro personalizada, escolha a CreateAccountetapa na visualização do gráfico e, em seguida, escolha a guia Saída.