aws:changeInstanceState: altera ou declara o estado da instância - AWS Systems Manager

aws:changeInstanceState: altera ou declara o estado da instância

Altera ou declara o estado da instância.

Essa ação pode ser usada no modo de declaração (não executa a API para alterar o estado, mas verifica se a instância está no estado desejado). Para usar o modo de declaração, defina o parâmetro CheckStateOnly como true. Esse modo é útil no Windows Server ao executar o comando Sysprep, um comando assíncrono que pode ser executado em segundo plano por um longo tempo. Você pode garantir que a instância seja interrompida antes de criar uma Amazon Machine Image (AMI).

nota

O valor de tempo limite padrão para esta ação é 3600 segundos (uma hora). Você pode limitar ou prolongar o tempo limite especificando o parâmetro timeoutSeconds para uma etapa aws:changeInstanceState.

nota

A ação aws:changeInstanceState suporta uma nova tentativa automática de controle de utilização. Para obter mais informações, consulte Configurar a repetição automática para operações com controle de utilização.

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

Os IDs das instâncias.

Tipo: StringList

Obrigatório: Sim

CheckStateOnly

Se false, define o estado da instância como o estado desejado. Se true, declara o estado desejado usando sondagem.

Padrão: false

Tipo: booliano

Obrigatório: Não

DesiredState

O estado desejado. Quando definida como running, essa ação aguarda que o estado do Amazon EC2 seja Running, o status da instância seja OK e o status do sistema seja OK, antes de concluir.

Tipo: String

Valores válidos: running | stopped | terminated

Obrigatório: Sim

Force

Se configurado, força a interrupção das instâncias. As instâncias não têm a oportunidade de liberar os caches ou metadados do sistema de arquivos. Se você usar essa opção, deve executar a verificação do sistema de arquivos e os procedimentos de reparo. Essa opção não é recomendada para instâncias do EC2 para Windows Server.

Tipo: booliano

Obrigatório: Não

AdditionalInfo

Reservado.

Tipo: String

Obrigatório: Não

Saída

Nenhum