aws:changeInstanceState: cambiar o confirmar el estado de la instancia - AWS Systems Manager

aws:changeInstanceState: cambiar o confirmar el estado de la instancia

Cambia o confirma el estado de la instancia.

Esta acción se puede utilizar en el modo de confirmación (no ejecuta la API para cambiar el estado, sino para comprobar que la instancia se encuentre en el estado deseado). Para utilizar el modo de aserción, establezca el parámetro CheckStateOnly en true. Este modo es útil al ejecutar el comando Sysprep en Windows, que es un comando asíncrono que puede ejecutar en segundo plano durante mucho tiempo. Puede asegurarse de que la instancia esté detenida antes de crear una Amazon Machine Image (AMI).

nota

El valor del tiempo de espera predeterminado para esta acción es de 3600 segundos (una hora). Puede limitar o ampliar el tiempo de espera mediante la especificación del parámetro timeoutSeconds para un paso aws:changeInstanceState.

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

Los ID de las instancias.

Tipo: StringList

Obligatorio: sí

CheckStateOnly

Si es false, establece el estado de la instancia en el valor deseado. Si es true, confirma el estado deseado mediante sondeo.

Valor predeterminado: false

Tipo: Booleano

Requerido: no

DesiredState

El estado deseado. Cuando se establece en running, esta acción espera hasta que el estado de Amazon EC2 sea Running, el estado de la instancia sea OK y el estado del sistema sea OK antes de completarse.

Tipo: cadena

Valores válidos: running | stopped | terminated

Obligatorio: sí

Force

Si se establece, obliga a las instancias a detenerse. Las instancias no tienen la oportunidad de vaciar las memorias cachés o los metadatos de los sistemas de archivos. Si utiliza esta opción, debe realizar los procedimientos de comprobación y reparación del sistema de archivos. Esta opción no se recomienda para las instancias EC2 de Windows Server.

Tipo: Booleano

Requerido: no

AdditionalInfo

Reservado.

Tipo: cadena

Requerido: no

Salida

Ninguna