aws:changeInstanceState: modifica o rileva dello 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, in quanto si tratta di un comando asincrono che può essere eseguito 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.

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

Campo 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

Campo 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

Campo 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

Campo obbligatorio: no

AdditionalInfo

Riservata.

Tipo: string

Campo obbligatorio: no

Output

Nessuno