Versões da máquina de estado nos fluxos de trabalho do Step Functions

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

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

Uma versão é um snapshot numerado e imutável de uma máquina de estado. Você publica versões da revisão mais recente feita nessa máquina de estado. Cada versão tem um nome do recurso da Amazon (ARN) exclusivo, que é uma combinação do ARN da máquina de estado e do número da versão separados por dois-pontos (:). O exemplo a seguir mostra o formato de um ARN da versão da máquina de estado.

arn:partition:states:region:account-id:stateMachine:myStateMachine:1

Para começar a usar versões de máquina de estado, você deve publicar a primeira versão. Depois de publicar uma versão, você pode invocar a ação da StartExecutionAPI com o ARN da versão. Você não pode editar uma versão, mas pode atualizar uma máquina de estado e publicar uma nova versão. Você também pode publicar várias versões da máquina de estado.

Ao publicar uma nova versão da máquina de estado, o Step Functions atribui a ela um número de versão. Os números das versões começam em 1 e aumentam monotonicamente para cada nova versão. Os números de versão não são reutilizados para uma máquina de estado. Se você excluir a versão 10 da máquina de estado e depois publicar uma nova versão, o Step Functions a publicará como versão 11.

As propriedades a seguir são as mesmas para todas as versões de uma máquina de estado:

As máquinas de estado também contêm propriedades que fazem parte de cada versão e revision, mas essas propriedades podem diferir entre duas versões ou revisões fornecidas. Essas propriedades incluem Definição de máquina de estado, Perfil do IAM, Configuração de rastreamento e Configuração de registro.

Como publicar uma versão de máquina de estado (Console)

Você pode publicar até mil versões de uma máquina de estado. Para solicitar um aumento desse limite flexível, use a página Support Center no AWS Management Console. Você pode excluir manualmente as versões não utilizadas do console ou invocando a ação da DeleteStateMachineVersionAPI.

Como gerenciar versões com operações da API do Step Functions

O Step Functions fornece as seguintes operações de API para publicar e gerenciar versões de máquinas de estado:

Para publicar uma nova versão da revisão atual de uma máquina de estado chamada myStateMachine usando o AWS Command Line Interface, use o publish-state-machine-version comando:

aws stepfunctions publish-state-machine-version --state-machine-arn arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

A resposta retorna o stateMachineVersionArn. Por exemplo, o comando anterior devolve uma resposta de arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1.

Como executar uma versão de máquina de estado do console

Para começar a usar versões de máquina de estado, você deve publicar primeiro uma versão da revision da máquina de estado atual. Para publicar uma versão, use o console Step Functions ou invoque a ação da PublishStateMachineVersionAPI. Você também pode invocar a ação da UpdateStateMachineAliasAPI com um parâmetro opcional chamado publish para atualizar uma máquina de estado e publicar sua versão.

Você pode iniciar a execução de uma versão usando o console ou invocando a ação da StartExecutionAPI e fornecendo o ARN da versão. Também é possível usar um alias para iniciar a execução de uma versão. Com base na configuração de roteamento, um alias roteia o tráfego para uma versão específica.

Se você iniciar a execução de uma máquina de estado sem usar uma versão, o Step Functions usará a revisão mais recente da máquina de estado para a execução. Para obter informações sobre como o Step Functions associa uma execução a uma versão, consulte Como associar execuções de máquinas a uma versão ou alias.