Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# `AWSSupport-RestoreEC2InstanceFromSnapshot`
<a name="automation-awssupport-restoreec2instancefromsnapshot"></a>

 **Descripción** 

El `AWSSupport-RestoreEC2InstanceFromSnapshot` manual le ayuda a identificar y restaurar una instancia de Amazon Elastic Compute Cloud (Amazon EC2) a partir de una instantánea activa del volumen raíz de Amazon Elastic Block Store (Amazon EBS).

[Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RestoreEC2InstanceFromSnapshot)

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parámetros**
+ AutomationAssumeRole

  Tipo: cadena

  Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.
+ EndDate

  Tipo: cadena

  Descripción: (opcional) la última fecha en la que quiere que la automatización busque una instantánea.
+ InplaceSwap

  Tipo: Booleano

  Valores válidos: true \$1 false

  Descripción: (opcional) si el valor de este parámetro se establece en `true`, el volumen recién creado a partir de la instantánea sustituirá al volumen raíz existente adjunto a su instancia.
+ InstanceId

  Tipo: cadena

  Descripción: (obligatorio) el ID de la instancia de base de datos de que desea restaurar de una instantánea.
+ LookForInstanceStatusCheck

  Tipo: Booleano

  Valores válidos: true \$1 false

  Predeterminado: true

  Descripción: (opcional) si el valor de este parámetro se establece en `true`, la automatización comprueba si las comprobaciones de estado de las instancias fallan en las instancias de prueba lanzadas desde las instantáneas.
+ SkipSnapshotsBy

  Tipo: cadena

  Descripción: (opcional) el intervalo en el que se omiten las instantáneas al buscar instantáneas para restaurar su instancia. Por ejemplo, si hay 100 instantáneas disponibles y especifica un valor de 2 para este parámetro, se revisará una de cada tres instantáneas.

  Predeterminado: 0
+ SnapshotId

  Tipo: cadena

  Descripción: (opcional) el ID de la instantánea desde la que quiere restaurar la instancia.
+ StartDate

  Tipo: cadena

  Descripción: (opcional) la primera fecha en la que quiere que la automatización busque una instantánea.
+ TotalSnapshotsToLook

  Tipo: cadena

  Descripción: (opcional) el número de instantáneas que revisa la automatización.

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+ `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`

 **Pasos de documentos** 

1. `aws:executeAwsApi`: recopila detalles sobre la instancia de destino.

1. `aws:assertAwsResourceProperty`: verifica la existencia de la instancia de destino.

1. `aws:assertAwsResourceProperty`: verifica que el volumen raíz sea un volumen de Amazon EBS.

1. `aws:assertAwsResourceProperty`: verifica que no se esté ejecutando otra automatización dirigida a esta instancia.

1. `aws:executeAwsApi`: etiqueta la instancia de destino.

1. `aws:executeAwsApi`- Crea un AMI de la instancia.

1. `aws:executeAwsApi`- Recopila detalles sobre el AMI creado en el paso anterior.

1. `aws:waitForAwsResourceProperty`- Espera a que AMI estado en el que se convertirá `available` antes de continuar.

1. `aws:executeScript`- Lanza una nueva instancia a partir de la recién creada AMI.

1. `aws:assertAwsResourceProperty`: comprueba que el estado de la instancia sea `available`.

1. `aws:executeAwsApi`: recopila detalles sobre la instancia recién lanzada.

1. `aws:branch`: se ramifica en función de si ha proporcionado un valor para el parámetro `SnapshotId`.

1. `aws:executeScript`: regresa una lista de instantáneas dentro del período de tiempo especificado.

1. `aws:executeAwsApi`: detiene la instancia.

1. `aws:waitForAwsResourceProperty`: espera a que el estado del volumen sea `available`.

1. `aws:waitForAwsResourceProperty`: espera a que el estado de la instancia sea `stopped`.

1. `aws:executeAwsApi`: separa el volumen raíz.

1. `aws:waitForAwsResourceProperty`: espera a que se separe el volumen raíz.

1. `aws:executeAwsApi`: fija el nuevo volumen raíz.

1. `aws:waitForAwsResourceProperty`: espera a que se adjunte el nuevo volumen.

1. `aws:executeAwsApi`: inicie la instancia.

1. `aws:waitForAwsResourceProperty`: espera a que el estado de la instancia sea `available`.

1. `aws:waitForAwsResourceProperty`: espera a que las comprobaciones de estado del sistema y de la instancia sean superadas por la instancia.

1. `aws:executeScript`: ejecuta un script para encontrar una instantánea que pueda usarse para crear correctamente un volumen.

1. `aws:executeScript`: ejecuta un script para recuperar la instancia utilizando el volumen recién creado a partir de la instantánea identificada por la automatización, o utilizando el volumen creado a partir de la instantánea que especificó en el parámetro `SnapshotId`.

1. `aws:executeScript`: elimina los recursos creados por la automatización.

 **Salidas** 

launchCloneInstance.InstanceIds

ListSnapshotByDate.FinalSnapshots

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot.Instantánea de trabajo

InstanceRecovery.resultado