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á.
# Versões da máquina de estado nos fluxos de trabalho do Step Functions
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 [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API 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.
![\[Diagrama ilustrativo difuso mostrando como as versões são snapshots imutáveis de máquinas de estado.\]](http://docs.aws.amazon.com/pt_br/step-functions/latest/dg/images/versioning-concept.png)
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:
+ Todas as versões de uma máquina de estado compartilham o mesmo tipo [(padrão ou expresso)](choosing-workflow-type.md).
+ Não é possível alterar o nome ou a data de criação de uma máquina de estado entre as versões.
+ As tags se aplicam globalmente às máquinas de estado. Você pode gerenciar tags para máquinas de estado usando as ações [TagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html)e [UntagResource](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html)da API.
As máquinas de estado também contêm propriedades que fazem parte de cada versão e [revision](concepts-cd-aliasing-versioning.md#statemachinerev), mas essas propriedades podem diferir entre duas versões ou revisões fornecidas. Essas propriedades incluem [Definição de máquina de estado](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-definition), [Perfil do IAM](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-roleArn), [Configuração de rastreamento](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-tracingConfiguration) e [Configuração de registro](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html#StepFunctions-UpdateStateMachine-request-loggingConfiguration).
## 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 [Console de gerenciamento da AWS](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html). Você pode excluir manualmente as versões não utilizadas do console ou invocando a ação da [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html)API.
**Para publicar uma versão de máquina de estado:**
1. Abra o [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) e escolha uma máquina de estado.
1. Na página **Detalhes da máquina de estado**, escolha **Editar**.
1. Edite a definição da máquina de estado conforme necessário e escolha **Salvar**.
1. Escolha **Publish version (Publicar versão)**.
1. (Opcional) No campo **Descrição** da caixa de diálogo exibida, digite uma breve descrição sobre a versão da máquina de estado.
1. Selecione **Publish**.
**nota**
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.
## 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:
+ [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html)— Publica uma versão da corrente [revision](concepts-cd-aliasing-versioning.md#statemachinerev) de uma máquina de estado.
+ [UpdateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html)— Publica uma nova versão da máquina de estado se você atualizar uma máquina de estado e definir o `publish` parâmetro como `true` na mesma solicitação.
+ [CreateStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html)— Publica a primeira revisão da máquina de estado se você definir o `publish` parâmetro como. `true`
+ [ListStateMachineVersions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html)— Lista as versões do ARN da máquina de estado especificada.
+ [DescribeStateMachine](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html)— Retorna os detalhes da versão da máquina de estado para uma versão ARN especificada em. `stateMachineArn`
+ [DeleteStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html)— Exclui uma versão da máquina 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:region:account-id:stateMachine:myStateMachine
```
A resposta retorna o `stateMachineVersionArn`. Por exemplo, o comando anterior devolve uma resposta de `arn:aws:states:region:account-id:stateMachine:myStateMachine:1`.
**nota**
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.
## 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](concepts-cd-aliasing-versioning.md#statemachinerev) da máquina de estado atual. Para publicar uma versão, use o console Step Functions ou invoque a ação da [PublishStateMachineVersion](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html)API. Você também pode invocar a ação da [UpdateStateMachineAlias](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html)API com um parâmetro opcional chamado `publish` para atualizar uma máquina de estado e publicar sua versão.
Você pode iniciar as execuções de uma versão usando o console ou invocando a ação da [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html)API e fornecendo o ARN da versão. Também é possível usar um [alias](concepts-state-machine-alias.md) para iniciar a execução de uma versão. Com base na [configuração de roteamento](concepts-state-machine-alias.md#alias-routing-config), 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](execution-alias-version-associate.md).
**Para iniciar a execução usando uma versão da máquina de estado:**
1. Abra o [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) e escolha uma máquina de estado para a qual você publicou uma ou mais versões. Para saber como publicar uma versão, consulte [Como publicar uma versão de máquina de estado (Console)](#procedure-create-versions).
1. Na página **Detalhes da máquina de estado**, escolha a guia **Versões**.
1. Na seção **Versões**, faça o seguinte:
1. Selecione a versão com a qual você quer iniciar a execução.
1. Selecione **Iniciar execução**.
1. (Opcional) Na caixa de diálogo **Iniciar execução**, digite um nome para a execução.
1. (Opcional) Digite os dados de entrada de execução e escolha **Iniciar execução**.