aws:changeInstanceState: modifica o rileva dello stato dell'istanza - AWS Systems Manager

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 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: 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