View a markdown version of this page

AWSSupport-RecoverWorkSpace - AWS Systems Manager Runbook-Referenz für Automation

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-RecoverWorkSpace

Beschreibung

Das AWSSupport-RecoverWorkSpace Runbook führt Wiederherstellungsschritte auf dem WorkSpaces virtuellen Amazon-Desktop durch, auch bekannt als WorkSpace, den Sie angeben. Das Runbook startet das neu WorkSpace, und wenn der Status unverändert bleibt, wird es auf der WorkSpace Grundlage der WerteUNHEALTHY, die Sie für die Eingabeparameter angeben, wiederhergestellt oder neu erstellt. Bevor Sie dieses Runbook verwenden, empfehlen wir Ihnen, die Informationen zur WorkSpaces Problembehandlung im Amazon-Administratorhandbuch zu lesen. WorkSpaces

Wichtig

Das Wiederherstellen oder Neuerstellen von a WorkSpace ist eine potenziell zerstörerische Aktion, die zum Verlust von Daten führen kann. Dies liegt daran, dass der aus dem letzten verfügbaren Snapshot wiederhergestellt WorkSpace wird und Daten, die aus Snapshots wiederhergestellt wurden, bis zu 12 Stunden alt sein können.

Mit der Wiederherstellungsoption werden sowohl das Root-Volume als auch das Benutzer-Volume auf der Grundlage der neuesten Snapshots neu erstellt. Mit der Neuerstellungsoption wird das Benutzer-Volume aus dem neuesten Snapshot neu erstellt und das aus dem Image neu erstellt, das dem Paket zugeordnet ist, WorkSpace aus dem es erstellt wurde. WorkSpace Anwendungen, die installiert wurden, oder Systemeinstellungen, die nach der Erstellung geändert wurden, WorkSpace gehen verloren. Weitere Informationen zum Wiederherstellen und Neuerstellen finden Sie unter Restore a WorkSpace und WorkSpaces Rebuild a WorkSpace im WorkSpaces Amazon-Administratorhandbuch.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

LinuxmacOS, Windows

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

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

  • Bestätigen

    Typ: Zeichenfolge

    Gültige Werte: Ja

    Beschreibung: (Erforderlich) Wenn Sie Ja eingeben, verstehen Sie, dass beim Wiederherstellen und Wiederherstellen versucht wird, den WorkSpace aktuellen Snapshot wiederherzustellen, und dass aus diesen Snapshots wiederhergestellte Daten bis zu 12 Stunden alt sein können.

  • Starten Sie neu

    Typ: Zeichenfolge

    Gültige Werte: Ja | Nein

    Standard: Ja

    Beschreibung: (Erforderlich) Legt fest, ob das neu gestartet WorkSpace wird.

  • Neu aufbauen

    Typ: Zeichenfolge

    Gültige Werte: Ja | Nein

    Standard: Nein

    Beschreibung: (Erforderlich) Legt fest, ob das neu erstellt WorkSpace wird.

  • Wiederherstellen

    Typ: Zeichenfolge

    Gültige Werte: Ja | Nein

    Standard: Nein

    Beschreibung: (Erforderlich) Legt fest, ob das wiederhergestellt WorkSpace wird.

  • WorkspaceId

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Die ID des Geräts, das WorkSpace Sie wiederherstellen möchten.

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Dokumentschritte

  • aws:executeAwsApi— Ruft den Status ab, den WorkSpace Sie im WorkspaceId Parameter angeben.

  • aws:assertAwsResourceProperty— Überprüft den Status von WorkSpace isAVAILABLE,, ERROR IMPAIREDSTOPPED, oder. UNHEALTHY

  • aws:branch- Filialen, die auf dem Status von basieren. WorkSpace

  • aws:executeAwsApi- Startet den WorkSpace.

  • aws:branch- Verzweigungen auf der Grundlage des Werts, den Sie für den Action Parameter angeben.

  • aws:waitForAwsResourceProperty- Wartet nach dem Start auf WorkSpace den Status.

  • aws:waitForAwsResourceProperty- Wartet darauf, dass der WorkSpace Status UNHEALTHY nach dem Start in AVAILABLEERROR,IMPAIRED, oder wechselt.

  • aws:executeAwsApi- Erfasst den Status von WorkSpace nach dem Start.

  • aws:branch- Verzweigungen, die auf dem Zustand basieren, in WorkSpace dem sich das Gerät nach dem Start befindet.

  • aws:executeAwsApi- Sammelt die verfügbaren Schnappschüsse für die Wiederherstellung oder Neuerstellung von. WorkSpace

  • aws:branch- Verzweigungen basieren auf dem Wert, den Sie für den Parameter angeben. Reboot

  • aws:executeAwsApi- Startet das WorkSpace neu.

  • aws:executeAwsApi- Erfasst den Status WorkSpace nach dem Start.

  • aws:waitForAwsResourceProperty- Wartet darauf, dass der Status von geändert wird WorkSpace . REBOOTING

  • aws:waitForAwsResourceProperty- Wartet daraufAVAILABLE, ERROR dass der WorkSpace Status in oder UNHEALTHY nach dem Neustart wechselt.

  • aws:executeAwsApi- Ruft den Zustand von nach dem Neustart ab. WorkSpace

  • aws:branch- Verzweigt auf der Grundlage des Zustands nach dem WorkSpace Neustart.

  • aws:branch- Verzweigungen, die auf dem Wert basieren, den Sie für den Restore Parameter angeben.

  • aws:executeAwsApi- Stellt das wieder her WorkSpace. Schlägt die Wiederherstellung fehl, versucht das Runbook, das WorkSpace neu zu erstellen.

  • aws:waitForAwsResourceProperty- Wartet darauf, dass der Status von in WorkSpace den geändert wird. RESTORING

  • aws:waitForAwsResourceProperty- Wartet daraufAVAILABLE, ERROR dass der WorkSpace Status in oder UNHEALTHY nach der Wiederherstellung wechselt.

  • aws:executeAwsApi- Erfasst den Zustand von WorkSpace nach der Wiederherstellung.

  • aws:branch- Zweige, die auf dem Zustand WorkSpace nach der Wiederherstellung basieren.

  • aws:branch- Verzweigungen, die auf dem Wert basieren, den Sie für den Rebuild Parameter angeben.

  • aws:executeAwsApi- Baut das WorkSpace neu auf.

  • aws:waitForAwsResourceProperty- Wartet, WorkSpace bis der Status von geändert wird. REBUILDING

  • aws:waitForAwsResourceProperty- Wartet daraufAVAILABLE, ERROR dass der WorkSpace Status in oder UNHEALTHY nach dem Wiederaufbau wechselt.

  • aws:executeAwsApi- Erfasst den Zustand des WorkSpace nach dem Wiederaufbau.

  • aws:assertAwsResourceProperty- Bestätigt den Status von WorkSpace istAVAILABLE.