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`
<a name="automation-awssupport-restoreec2instancefromsnapshot"></a>

 **Descrição** 

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

[Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RestoreEC2InstanceFromSnapshot)

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

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

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

  Tipo: booliano

  Valores válidos: True \$1 False

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

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

  Tipo: booliano

  Valores válidos: True \$1 False

  Padrão: verdadeiro

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

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

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

  Tipo: string

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

  Tipo: string

  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.

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

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

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

1. `aws:executeAwsApi`: marca a instância de destino.

1. `aws:executeAwsApi`- Cria um AMI da instância.

1. `aws:executeAwsApi`- Reúne detalhes sobre o AMI criado na etapa anterior.

1. `aws:waitForAwsResourceProperty`- Espera pelo AMI estado a ser `available` antes de prosseguir.

1. `aws:executeScript`- Lança uma nova instância a partir da recém-criada AMI.

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

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

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

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

1. `aws:executeAwsApi`: interrompe a instância.

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

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

1. `aws:executeAwsApi`: separa o volume de raiz.

1. `aws:waitForAwsResourceProperty`: espera que o volume raiz seja desanexado.

1. `aws:executeAwsApi`: anexa o novo volume raiz.

1. `aws:waitForAwsResourceProperty`: espera que o novo volume seja anexado.

1. `aws:executeAwsApi`: inicia a instância.

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

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

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

1. `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`.

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

 **Saídas** 

launchCloneInstance.InstanceIds

ListSnapshotByDate. Instantâneos finais

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot.Instantâneo de trabalho

InstanceRecovery.resultado