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á.

Redriving Map Runs em execuções de Step Functions

Você pode reiniciar execuções malsucedidas do fluxo de trabalho secundário em um mapa executado por redrivingo fluxo de trabalho de seus pais. A redriven fluxo de trabalho principal redrives todos os estados malsucedidos, incluindo Mapa Distribuído. Um fluxo de trabalho principal vai redirecionar estados malsucedidos se não houver nenhum evento <stateType>Exited correspondente ao evento <stateType>Entered de um estado quando o fluxo de trabalho principal tiver concluído a execução. Por exemplo, se o histórico de eventos não contiver o MapStateExited evento de um MapStateEntered evento, você poderá redrive o fluxo de trabalho principal para redrive todas as execuções malsucedidas do fluxo de trabalho infantil no Map Run.

Uma Execução de mapa não é iniciada ou apresenta falha na tentativa de execução original quando a máquina de estado não tem a permissão necessária para acessar ItemReader (Mapa), ResultWriter (Mapa), ou ambas. Se o Map Run não foi iniciado na tentativa de execução original do fluxo de trabalho principal, redriving o fluxo de trabalho principal inicia o Map Run pela primeira vez. Para resolver isso, adicione as permissões necessárias à sua função de máquina de estado e, em seguida, redrive o fluxo de trabalho principal. Se você redrive o fluxo de trabalho principal sem adicionar as permissões necessárias, ele tenta iniciar uma nova execução do Map Run que falhará novamente. Para obter informações sobre as permissões de que você talvez precise, consulte IAMpolíticas para usar estados de mapas distribuídos.

Redrive elegibilidade para fluxos de trabalho secundários em um Map Run

Você pode redrive as execuções malsucedidas do fluxo de trabalho secundário em uma execução de mapa se as seguintes condições forem atendidas:

Uma nova execução de mapa é iniciada e a execução de mapa existente não redriven nos seguintes casos, mesmo se o Map Run falhar na tentativa de execução original:

Uma Execução de mapa pode continuar mesmo após o fluxo de trabalho principal parar ou atingir o tempo limite. Nesses cenários, o redrive não acontece imediatamente:

Nesses casos, o Map Run em execução conclui suas operações antes de tentar redrive.

Execuções de fluxo de trabalho secundário redrive comportamento

A ferramenta redriven as execuções do fluxo de trabalho secundário em um Map Run exibem o comportamento conforme descrito na tabela a seguir.

Se você tem redriven uma Execução de Mapa, e tendo atingido seu limite de simultaneidade, as execuções do fluxo de trabalho secundário nessa transição de Execução de Mapa para o estado pendente. O status de execução do Map Run também muda para Pendente redriveestado. Até que o limite de simultaneidade especificado possa permitir a execução de mais execuções de fluxo de trabalho secundário, a execução permanece na pasta Pendente redriveestado.

Por exemplo, digamos que o limite de simultaneidade de Mapa distribuído em seu fluxo de trabalho seja 3 mil e o número de fluxos de trabalho secundários a serem executados novamente seja de 6 mil. Isso faz com que 3 mil fluxos de trabalho secundários sejam executados em paralelo, enquanto os 3 mil fluxos de trabalho restantes permanecem no estado Redirecionamento pendente. Após a conclusão da execução do primeiro lote de 3 mil fluxos de trabalho secundários, os 3 mil restantes serão executados.

Quando uma execução de mapa conclui sua execução ou é abortada, a contagem de execuções secundárias do fluxo de trabalho no campo Pendente redriveo estado é redefinido para 0.

Cenários de entrada usados no Map Run redrive

Dependendo de como você forneceu informações para o Mapa Distribuído na tentativa de execução original, um redriven O Map Run usará a entrada conforme descrito na tabela a seguir.

IAMpermissão para redrive uma corrida de mapas

Step Functions precisa da permissão apropriada para redrive um Map Run. O exemplo IAM de política a seguir concede o menor privilégio necessário à sua máquina de estado para redriving um Map Run. Lembre-se de substituir o italicized texto com as informações específicas do seu recurso.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:RedriveExecution"
      ],
      "Resource": "arn:aws:states:us-east-2:123456789012:execution:myStateMachine/myMapRunLabel:*"
    }
  ]
}

Redriving Map Run no console

A imagem a seguir mostra o gráfico de execução de uma máquina de estado que contém um Mapa distribuído. Essa execução falhou porque a Execução de mapa falhou. Para redrive o Map Run, você deve redrive o fluxo de trabalho principal.

Depois de ter redriven em Map Run, você pode examinar seu redrive detalhes no console ou usando as DescribeExecutionAPIações GetExecutionHistorye. Para obter mais informações sobre como examinar um redriven execução, vejaExaminando redriven execuções.

Redriving Execute o mapa usando API

Você pode redrive um Map Run elegível usando o RedriveExecutionAPIno fluxo de trabalho principal. Isso API reinicia as execuções malsucedidas do fluxo de trabalho secundário em uma execução de mapa.

No painel, AWS Command Line Interface (AWS CLI), execute o seguinte comando para redrive uma execução malsucedida da máquina de estado. Lembre-se de substituir o italicized texto com as informações específicas do seu recurso.

aws stepfunctions redrive-execution --execution-arn arn:aws:states:us-east-2:123456789012:execution:myStateMachine:foo

Depois de ter redriven em Map Run, você pode examinar seu redrive detalhes no console ou usando a DescribeMapRunAPIação. Para examinar o redrive detalhes das execuções do fluxo de trabalho padrão em uma execução de mapa, você pode usar a DescribeExecutionAPIação GetExecutionHistoryou. Para obter mais informações sobre como examinar um redriven execução, vejaExaminando redriven execuções.

Você pode examinar o redrive detalhes das execuções do fluxo de trabalho Express em um Map Run no console Step Functions se você tiver ativado o registro no fluxo de trabalho principal. Para obter mais informações, consulte Usando CloudWatch Logs para registrar o histórico de execução em Step Functions.