View a markdown version of this page

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

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

FailOnUnexpectedStopped

Se definida como true, a etapa de automação falha quando uma instância faz a transição para o estado interrompido durante uma operação inicial. Isso é útil para detectar casos em que uma instância falha ao iniciar com êxito, como quando uma instância tem um volume do EBS criptografado, mas não tem as permissões de chave do KMS necessárias.

Tipo: booliano

Obrigatório: não

AdditionalInfo

Reservado.

Tipo: string

Obrigatório: não

Output

Nenhum