View a markdown version of this page

aws:change InstanceState — Modifica o afferma lo stato dell'istanza - AWS Systems Manager

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

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:change InstanceState — Modifica o afferma lo stato dell'istanza

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

Input

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

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

FailOnUnexpectedStopped

Se impostato su true, la fase di automazione fallisce quando un'istanza passa allo stato interrotto durante un'operazione di avvio. Ciò è utile per rilevare i casi in cui un'istanza non riesce ad avviarsi correttamente, ad esempio quando un'istanza ha un volume EBS crittografato ma non dispone delle autorizzazioni necessarie per la chiave KMS.

Tipo: Booleano

Obbligatorio: no

AdditionalInfo

Riservata.

▬Tipo: stringa

Obbligatorio: no

Output

Nessuno