• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# `aws:changeInstanceState`: altera ou declara o estado da instância
<a name="automation-action-changestate"></a>

Altera ou declara o estado da instância.

Essa ação pode ser usada no modo de declaração (não executa a API para alterar o estado, mas verifica se a instância está no estado desejado). Para usar o modo de declaração, defina o parâmetro `CheckStateOnly` como true. Esse modo é útil no Windows Server ao executar o comando Sysprep, um comando assíncrono que pode ser executado em segundo plano por um longo tempo. Você pode garantir que a instância seja interrompida antes de criar uma Amazon Machine Image (AMI).

**nota**  
O valor de tempo limite padrão para esta ação é 3600 segundos (uma hora). Você pode limitar ou prolongar o tempo limite especificando o parâmetro `timeoutSeconds` para uma etapa `aws:changeInstanceState`.

**nota**  
A ação `aws:changeInstanceState` suporta uma nova tentativa automática de controle de utilização. Para obter mais informações, consulte [Configurar a repetição automática para operações com controle de utilização](automation-throttling-retry.md).

**Entrada**

------
#### [ YAML ]

```
name: startMyInstance
action: aws:changeInstanceState
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  InstanceIds:
  - i-1234567890abcdef0
  CheckStateOnly: true
  DesiredState: running
  FailOnUnexpectedStopped: true
```

------
#### [ JSON ]

```
{
    "name":"startMyInstance",
    "action": "aws:changeInstanceState",
    "maxAttempts": 3,
    "timeoutSeconds": 3600,
    "onFailure": "Abort",
    "inputs": {
        "InstanceIds": ["i-1234567890abcdef0"],
        "CheckStateOnly": true,
        "DesiredState": "running",
        "FailOnUnexpectedStopped": true
    }
}
```

------

InstanceIds  
Os IDs das instâncias.  
Tipo: StringList  
Obrigatório: Sim

CheckStateOnly  
Se false, define o estado da instância como o estado desejado. Se true, declara o estado desejado usando sondagem.  
Padrão: `false`  
Tipo: booliano  
Obrigatório: não

DesiredState  
O estado desejado. Quando definida como `running`, essa ação aguarda que o estado do Amazon EC2 seja `Running`, o status da instância seja `OK` e o status do sistema seja `OK`, antes de concluir.  
Tipo: string  
Valores válidos: `running` \| `stopped` \| `terminated`  
Obrigatório: Sim

Force  
Se configurado, força a interrupção das instâncias. As instâncias não têm a oportunidade de liberar os caches ou metadados do sistema de arquivos. Se você usar essa opção, deve executar a verificação do sistema de arquivos e os procedimentos de reparo. Essa opção não é recomendada para instâncias do EC2 para Windows Server.  
Tipo: booliano  
Obrigatório: não

FailOnUnexpectedStopped  
Se definida como true, a etapa de automação falha quando uma instância faz a transição para o estado interrompido durante uma operação inicial. Isso é útil para detectar casos em que uma instância falha ao iniciar com êxito, como quando uma instância tem um volume do EBS criptografado, mas não tem as permissões de chave do KMS necessárias.  
Tipo: booliano  
Obrigatório: não

AdditionalInfo  
Reservado.  
Tipo: string  
Obrigatório: não

**Output**  
Nenhum