AWSSupport-RestoreEC2InstanceFromSnapshot - AWS Systems Manager Referência do runbook de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWSSupport-RestoreEC2InstanceFromSnapshot

Descrição

O runbook AWSSupport-RestoreEC2InstanceFromSnapshot ajuda você a identificar e restaurar uma instância do Amazon Elastic Compute Cloud (Amazon EC2) a partir de um instantâneo do Amazon Elastic Block Store (Amazon EBS) do volume raiz.

Execute esta automação (console)

Tipo de documento

Automation

Proprietário

Amazon

Plataformas

Linux, macOS, Windows

Parâmetros

  • AutomationAssumeRole

    Tipo: sequência

    Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

  • EndDate

    Tipo: sequência

    Descrição: (opcional) A última data em que você deseja que a automação procure um snapshot.

  • InplaceSwap

    Tipo: booliano

    Valores válidos: verdadeiro | falso

    Descrição: (opcional) se o valor desse parâmetro for definido como true, o volume recém-criado do snapshot substituirá o volume raiz existente anexado à sua instância.

  • InstanceId

    Tipo: sequência

    Descrição: (obrigatório) o ID da instância de banco de dados do que você deseja reinicializar.

  • LookForInstanceStatusCheck

    Tipo: booliano

    Valores válidos: verdadeiro | falso

    Padrão: true

    Descrição: (opcional) se o valor desse parâmetro for definido como true, a automação verificará se as verificações de status da instância falham nas instâncias de teste iniciadas a partir dos snapshots.

  • SkipSnapshotsBy

    Tipo: sequência

    Descrição: (opcional) o intervalo em que os snapshots são ignorados ao pesquisar snapshots para restaurar sua instância. Por exemplo, se houver 100 snapshots disponíveis e você especificar um valor de 2 para esse parâmetro, cada terceiro snapshot será revisado.

    Padrão: 0

  • SnapshotId

    Tipo: sequência

    Descrição: (opcional) o ID de um snapshot do qual você deseja restaurar a instância.

  • StartDate

    Tipo: sequência

    Descrição: (opcional) a primeira data em que você deseja que a automação procure um snapshot.

  • TotalSnapshotsToLook

    Tipo: sequência

    Descrição: (opcional) o número de snapshots que a automação analisa.

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:DescribeInstanceInformation

  • ec2:AttachVolume

  • ec2:CreateImage

  • ec2:CreateTags

  • ec2:CreateVolume

  • ec2:DeleteTags

  • ec2:DeregisterImage

  • ec2:DescribeInstances

  • ec2:DescribeInstanceStatus

  • ec2:DescribeImages

  • ec2:DescribeSnapshots

  • ec2:DescribeVolumes

  • ec2:DetachVolume

  • ec2:RunInstances

  • ec2:StartInstances

  • ec2:StopInstances

  • ec2:TerminateInstances

  • cloudwatch:GetMetricData

Etapas do documento

  1. aws:executeAwsApi: reúne detalhes sobre a instância de destino.

  2. aws:assertAwsResourceProperty: verifica se a instância de destino existe.

  3. aws:assertAwsResourceProperty: verifica se o volume raiz é um volume do Amazon EBS.

  4. aws:assertAwsResourceProperty: verifica se ainda não está em execução outra automação que tenha como destino essa instância.

  5. aws:executeAwsApi: marca a instância de destino.

  6. aws:executeAwsApi: cria uma AMI da instância.

  7. aws:executeAwsApi: reúne detalhes sobre a AMI criada na etapa anterior.

  8. aws:waitForAwsResourceProperty: espera que o estado da AMI se torne available antes de prosseguir.

  9. aws:executeScript: inicia uma nova instância a partir da AMI recém-criada.

  10. aws:assertAwsResourceProperty: verifica se o estado da instância é available.

  11. aws:executeAwsApi: reúne detalhes sobre a instância recém-iniciada.

  12. aws:branch: ramifica com base no fato de ter fornecido um valor para o parâmetro SnapshotId.

  13. aws:executeScript: retorna uma lista de snapshots dentro do período especificado.

  14. aws:executeAwsApi: interrompe a instância.

  15. aws:waitForAwsResourceProperty: espera que o estado do volume seja available.

  16. aws:waitForAwsResourceProperty: espera que o estado da instância seja stopped.

  17. aws:executeAwsApi: separa o volume de raiz.

  18. aws:waitForAwsResourceProperty: espera que o volume raiz seja desanexado.

  19. aws:executeAwsApi: anexa o novo volume raiz.

  20. aws:waitForAwsResourceProperty: espera que o novo volume seja anexado.

  21. aws:executeAwsApi: inicia a instância.

  22. aws:waitForAwsResourceProperty: espera que o estado da instância seja available.

  23. aws:waitForAwsResourceProperty: espera que as verificações de status do sistema e da instância sejam aprovadas na instância.

  24. aws:executeScript: executa um script para encontrar um snapshot que possa ser usado para criar um volume com êxito.

  25. aws:executeScript: executa um script para recuperar a instância usando o volume recém-criado a partir do snapshot identificado pela automação ou usando o volume criado a partir do snapshot que você especificou no parâmetro SnapshotId.

  26. aws:executeScript: exclui recursos criados pela automação.

Saídas

launchCloneInstance.InstanceIds

ListSnapshotByDate.finalSnapshots

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot.workingSnapshot

InstanceRecovery.result