• 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: stopMyInstance
action: aws:changeInstanceState
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  InstanceIds:
  - i-1234567890abcdef0
  CheckStateOnly: true
  DesiredState: stopped
```

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

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

------

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` \$1 `stopped` \$1 `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

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

**Output**  
Nenhum