Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

 **Descrizione** 

Il `AWSSupport-RestoreEC2InstanceFromSnapshot` runbook ti aiuta a identificare e ripristinare un'istanza Amazon Elastic Compute Cloud (Amazon EC2) da uno snapshot Amazon Elastic Block Store (Amazon EBS) funzionante del volume root.

[Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RestoreEC2InstanceFromSnapshot)

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

Linux, macOS, Windows

**Parametri**
+ AutomationAssumeRole

  Tipo: stringa

  Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
+ EndDate

  Tipo: stringa

  Descrizione: (Facoltativo) L'ultima data in cui si desidera che l'automazione cerchi un'istantanea.
+ InplaceSwap

  Tipo: Booleano

  Valori validi: true \| false

  Descrizione: (Facoltativo) Se il valore di questo parametro è impostato su`true`, il volume appena creato dall'istantanea sostituisce il volume principale esistente collegato all'istanza.
+ InstanceId

  Tipo: stringa

  Descrizione: (Obbligatorio) L'ID dell'istanza che desideri ripristinare da un'istantanea.
+ LookForInstanceStatusCheck

  Tipo: Booleano

  Valori validi: true \| false

  Impostazione predefinita: true

  Descrizione: (Facoltativo) Se il valore di questo parametro è impostato su`true`, l'automazione verifica se i controlli dello stato dell'istanza hanno esito negativo sulle istanze di test avviate dalle istantanee.
+ SkipSnapshotsBy

  Tipo: stringa

  Descrizione: (Facoltativo) L'intervallo in cui le istantanee vengono saltate durante la ricerca di istantanee per ripristinare l'istanza. Ad esempio, se sono disponibili 100 istantanee e si specifica il valore 2 per questo parametro, viene esaminata ogni terza istantanea.

  Impostazione predefinita: 0
+ SnapshotId

  Tipo: stringa

  Descrizione: (Facoltativo) L'ID di un'istantanea da cui si desidera ripristinare l'istanza.
+ StartDate

  Tipo: stringa

  Descrizione: (Facoltativo) La prima data in cui desideri che l'automazione cerchi un'istantanea.
+ TotalSnapshotsToLook

  Tipo: stringa

  Descrizione: (Facoltativo) Il numero di istantanee esaminate dall'automazione.

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+ `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`

 **Fasi del documento** 

1. `aws:executeAwsApi`- Raccoglie dettagli sull'istanza di destinazione.

1. `aws:assertAwsResourceProperty`- Verifica l'esistenza dell'istanza di destinazione.

1. `aws:assertAwsResourceProperty`- Verifica che il volume root sia un volume Amazon EBS.

1. `aws:assertAwsResourceProperty`- Verifica che non sia già in esecuzione un'altra automazione destinata a questa istanza.

1. `aws:executeAwsApi`- Etichetta l'istanza di destinazione.

1. `aws:executeAwsApi`- Crea un AMI dell'istanza.

1. `aws:executeAwsApi`- Raccoglie dettagli sulla AMI creato nel passaggio precedente.

1. `aws:waitForAwsResourceProperty`- Attende il AMI stato da diventare `available` prima di procedere.

1. `aws:executeScript`- Avvia una nuova istanza da quella appena creata AMI.

1. `aws:assertAwsResourceProperty`- Verifica che lo stato dell'istanza sia. `available`

1. `aws:executeAwsApi`- Raccoglie i dettagli sull'istanza appena lanciata.

1. `aws:branch`- Rami in base al fatto che tu abbia fornito un valore per il `SnapshotId` parametro.

1. `aws:executeScript`- Restituisce un elenco di istantanee entro il periodo di tempo specificato.

1. `aws:executeAwsApi`- Arresta l'istanza.

1. `aws:waitForAwsResourceProperty`- Attende che lo stato del volume sia `available` raggiunto.

1. `aws:waitForAwsResourceProperty`- Attende che lo stato dell'istanza sia. `stopped`

1. `aws:executeAwsApi`- Rimuove il volume principale.

1. `aws:waitForAwsResourceProperty`- Attende che il volume principale venga scollegato.

1. `aws:executeAwsApi`- Collega il nuovo volume principale.

1. `aws:waitForAwsResourceProperty`- Attende che il nuovo volume venga allegato.

1. `aws:executeAwsApi`- Avvia l'istanza.

1. `aws:waitForAwsResourceProperty`- Attende che lo stato dell'istanza sia`available`.

1. `aws:waitForAwsResourceProperty`- Attende che i controlli dello stato del sistema e dell'istanza vengano superati.

1. `aws:executeScript`- Esegue uno script per trovare un'istantanea che può essere utilizzata per creare correttamente un volume.

1. `aws:executeScript`- Esegue uno script per ripristinare l'istanza utilizzando il volume appena creato dall'istantanea identificata dall'automazione o utilizzando il volume creato dall'istantanea specificata nel parametro. `SnapshotId`

1. `aws:executeScript`- Elimina le risorse create dall'automazione.

 **Output** 

launchCloneInstance.InstanceIds

ListSnapshotByDate. Istantanee finali

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot.Istantanea funzionante

InstanceRecovery.risultato