• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `aws:changeInstanceState`: modifica o rileva dello stato dell'istanza
<a name="automation-action-changestate"></a>

Modifica o rileva lo stato dell'istanza.

Questa operazione può essere utilizzata in modalità presuntiva (non esegue l'API per modificare lo stato, ma verifica se l'istanza è nello stato desiderato). Per utilizzare la modalità presuntiva, impostare il parametro `CheckStateOnly` su true. Questa modalità è utile, quando si esegue il comando Sysprep in Windows Server, in quanto si tratta di un comando asincrono, eseguibile in background per lunghi periodi di tempo. Puoi assicurarti che l'istanza venga arrestata prima di creare un'Amazon Machine Image (AMI).

**Nota**  
Il valore di timeout predefinito per questa operazione è 3600 secondi (un'ora). Puoi limitare o estendere il timeout specificando il parametro `timeoutSeconds` per una fase `aws:changeInstanceState`.

**Nota**  
L'azione `aws:changeInstanceState` supporta un nuovo tentativo di limitazione (della larghezza di banda della rete) automatico. Per ulteriori informazioni, consulta [Configurazione della ripetizione dei tentativi automatica per le operazioni di limitazione (della larghezza di banda della rete)](automation-throttling-retry.md).

**Input**

------
#### [ 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  
ID delle istanze.  
Tipo: StringList  
Obbligatorio: sì

CheckStateOnly  
Se false, imposta lo stato dell'istanza sullo stato desiderato. Se true, presume lo stato desiderato utilizzando il polling.  
Impostazione predefinita: `false`  
Tipo: Booleano  
Obbligatorio: no

DesiredState  
Stato desiderato. Se è impostata su `running`, questa operazione attende che lo stato di Amazon EC2 sia `Running`, lo stato dell'istanza sia `OK` e lo stato del sistema sia `OK` prima del completamento.  
Tipo: String  
Valori validi: `running` \| `stopped` \| `terminated`  
Obbligatorio: sì

Force  
Se impostato, forza l'arresto delle istanze. Le istanze non hanno la possibilità di svuotare le cache o i metadati del file system. Se utilizzi questa opzione, devi eseguire le procedure di verifica e riparazione del file system. Questa opzione non è consigliata per le istanze di EC2 di Windows Server.  
Tipo: Booleano  
Obbligatorio: no

AdditionalInfo  
Riservata.  
▬Tipo: stringa  
Obbligatorio: no

**Output**  
Nessuno