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 o Step Functions associa execuções a uma versão ou alias

Step Functions associa uma execução a uma versão ou alias com base no Amazon Resource Name (ARN) que você usa para invocar a ação. StartExecutionAPI O Step Functions executa essa ação no horário de início da execução.

Você pode iniciar a execução de uma máquina de estado usando um qualificado ou um não qualificadoARN.

Por exemplo, se seu qualificado se ARN refere à versão3, o Step Functions associa a execução a essa versão. Ele não associa a execução a nenhum alias que aponte para a versão 3.

Se seu qualificado ARN se referir a um alias, Step Functions associará a execução a esse alias e à versão para a qual o alias aponta. Uma execução só pode ser associada a um alias.

Como visualizar execuções iniciadas com uma versão ou um alias

O Step Functions fornece as seguintes maneiras pelas quais você pode visualizar as execuções iniciadas com uma versão ou um alias:

Usando API ações

Você pode visualizar todas as execuções associadas a uma versão ou a um alias invocando as DescribeExecutionações e. ListExecutionsAPI Essas API ações retornam ARN a versão ou o alias usado para iniciar a execução. Essas ações também retornam outros detalhes, incluindo o status e ARN a execução.

Você também pode fornecer um alias ARN ou versão da máquina de estado ARN para listar as execuções associadas a um alias ou versão específica.

O exemplo de resposta da ListExecutionsAPIação a seguir mostra o ARN alias usado para iniciar uma execução de máquina de estado chamada myFirstExecution.

A ferramenta italicized o texto no trecho de código a seguir representa informações específicas do recurso.

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}

Como usar o console do Step Functions

Você também pode ver as execuções iniciadas por uma versão ou um alias no console do Step Functions. O seguinte procedimento mostra como você pode visualizar as execuções iniciadas com uma versão específica:

A seguinte imagem mostra a página do console Detalhes da versão. Essa página lista as execuções iniciadas pela versão 4 de uma máquina de estado chamada MathAddDemo. Essa lista também exibe uma execução que foi iniciada por um alias chamado PROD. Esse alias roteou o tráfego de execução para a versão 4.

Usando CloudWatch métricas

Para cada execução de máquina de estado que você inicia com um Qualified ARN, o Step Functions emite métricas adicionais com o mesmo nome e valor das métricas emitidas atualmente. Essas métricas adicionais contêm dimensões para cada identificador de versão e nome de alias com os quais você inicia uma execução. Com essas métricas, você pode monitorar as execuções da máquina de estado no nível da versão e determinar quando um cenário de reversão pode ser necessário. Você também pode criar CloudWatch alarmes da Amazon com base nessas métricas.

O Step Functions emite as seguintes métricas para execuções que você inicia com um alias ou uma versão:

Se você iniciou a execução com uma versãoARN, o Step Functions publica a métrica com StateMachineArn e uma segunda métrica com StateMachineArn e Version dimensões.

Se você iniciou a execução com um aliasARN, o Step Functions emite as seguintes métricas: