

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

 **Beschreibung** 

Das `AWSSupport-RestoreEC2InstanceFromSnapshot` Runbook hilft Ihnen dabei, eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance anhand eines funktionierenden Amazon Elastic Block Store (Amazon EBS) -Snapshots des Root-Volumes zu identifizieren und wiederherzustellen.

[Führen Sie diese Automatisierung (Konsole) aus](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RestoreEC2InstanceFromSnapshot)

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Linux, macOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ EndDate

  Typ: Zeichenfolge

  Beschreibung: (Optional) Das letzte Datum, an dem die Automatisierung nach einem Snapshot suchen soll.
+ InplaceSwap

  Typ: Boolesch

  Zulässige Werte: true \$1 false

  Beschreibung: (Optional) Wenn der Wert für diesen Parameter auf gesetzt ist`true`, ersetzt das neu erstellte Volume aus dem Snapshot das bestehende Root-Volume, das an Ihre Instance angehängt ist.
+ InstanceId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID der Instance, die Sie aus einem Snapshot wiederherstellen möchten.
+ LookForInstanceStatusCheck

  Typ: Boolesch

  Zulässige Werte: true \$1 false

  Standard: true

  Beschreibung: (Optional) Wenn der Wert für diesen Parameter auf gesetzt ist, prüft die Automatisierung`true`, ob die Instanzstatusprüfungen bei den Testinstanzen, die über die Snapshots gestartet wurden, fehlschlagen.
+ SkipSnapshotsBy

  Typ: Zeichenfolge

  Beschreibung: (Optional) Das Intervall, in dem Snapshots bei der Suche nach Snapshots zur Wiederherstellung Ihrer Instanz übersprungen werden. Wenn beispielsweise 100 Snapshots verfügbar sind und Sie für diesen Parameter den Wert 2 angeben, wird jeder dritte Snapshot überprüft.

  Standard: 0
+ SnapshotId

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die ID eines Snapshots, aus dem Sie die Instanz wiederherstellen möchten.
+ StartDate

  Typ: Zeichenfolge

  Beschreibung: (Optional) Das erste Datum, an dem die Automatisierung nach einem Snapshot suchen soll.
+ TotalSnapshotsToLook

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der Snapshots, die die Automatisierung überprüft.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+ `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`

 **Dokumentschritte** 

1. `aws:executeAwsApi`- Sammelt Details zur Zielinstanz.

1. `aws:assertAwsResourceProperty`— Überprüft, ob die Zielinstanz existiert.

1. `aws:assertAwsResourceProperty`— Überprüft, ob es sich bei dem Root-Volume um ein Amazon EBS-Volume handelt.

1. `aws:assertAwsResourceProperty`— Überprüft, ob noch keine andere Automatisierung ausgeführt wird, die auf diese Instance abzielt.

1. `aws:executeAwsApi`— Markiert die Zielinstanz.

1. `aws:executeAwsApi`- Erzeugt eine AMI der Instanz.

1. `aws:executeAwsApi`- Sammelt Details über AMI im vorherigen Schritt erstellt.

1. `aws:waitForAwsResourceProperty`- Wartet auf die AMI Zustand, der werden soll, `available` bevor fortgefahren wird.

1. `aws:executeScript`- Startet eine neue Instanz von der neu erstellten AMI.

1. `aws:assertAwsResourceProperty`- Überprüft, ob der Instanzstatus lautet`available`.

1. `aws:executeAwsApi`— Sammelt Details über die neu gestartete Instanz.

1. `aws:branch`— Verzweigt je nachdem, ob Sie einen Wert für den `SnapshotId` Parameter angegeben haben.

1. `aws:executeScript`- Gibt eine Liste von Schnappschüssen innerhalb des angegebenen Zeitraums zurück.

1. `aws:executeAwsApi`- Stoppt die Instanz.

1. `aws:waitForAwsResourceProperty`- Wartet darauf, dass der Lautstärkestatus erreicht ist. `available`

1. `aws:waitForAwsResourceProperty`- Wartet darauf, dass der Instanzstatus erreicht ist. `stopped`

1. `aws:executeAwsApi`- Trennt das Root-Volume.

1. `aws:waitForAwsResourceProperty`- Wartet darauf, dass das Root-Volume getrennt wird.

1. `aws:executeAwsApi`- Hängt das neue Root-Volume an.

1. `aws:waitForAwsResourceProperty`- Wartet darauf, dass das neue Volume angehängt wird.

1. `aws:executeAwsApi`- Startet die Instanz.

1. `aws:waitForAwsResourceProperty`- Wartet darauf, dass der Instanzstatus erreicht ist. `available`

1. `aws:waitForAwsResourceProperty`- Wartet darauf, dass die System- und Instanzstatusprüfungen für die Instanz bestanden sind.

1. `aws:executeScript`- Führt ein Skript aus, um einen Snapshot zu finden, mit dem ein Volume erfolgreich erstellt werden kann.

1. `aws:executeScript`- Führt ein Skript aus, um die Instanz mithilfe des neu erstellten Volumes aus dem durch die Automatisierung identifizierten Snapshot oder mithilfe des Volumes wiederherzustellen, das aus dem Snapshot erstellt wurde, den Sie im `SnapshotId` Parameter angegeben haben.

1. `aws:executeScript`- Löscht Ressourcen, die durch die Automatisierung erstellt wurden.

 **Ausgaben** 

launchCloneInstance.InstanceIds

ListSnapshotByDate. Letzte Schnappschüsse

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot. funktionierender Snapshot

InstanceRecovery. Ergebnis