View a markdown version of this page

AWSSupport-RecoverWorkSpace - AWS Systems Manager Référence du dossier d’exploitation Automation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWSSupport-RecoverWorkSpace

Description

Le AWSSupport-RecoverWorkSpace runbook exécute les étapes de restauration sur le bureau WorkSpaces virtuel Amazon, appelé « poste de travail » WorkSpace, que vous spécifiez. Le runbook redémarre et WorkSpace, si l'état est toujoursUNHEALTHY, le restaure ou le reconstruit en WorkSpace fonction des valeurs que vous avez spécifiées pour les paramètres d'entrée. Avant d'utiliser ce runbook, nous vous recommandons de consulter la section Problèmes de résolution WorkSpaces des problèmes dans le Guide d' WorkSpaces administration Amazon.

Important

La restauration ou la reconstruction d'un site WorkSpace est une action potentiellement destructrice qui peut entraîner la perte de données. En effet, le fichier WorkSpace est restauré à partir du dernier instantané disponible et les données récupérées à partir des instantanés peuvent dater de 12 heures.

L'option de restauration recrée à la fois le volume racine et le volume utilisateur en fonction des instantanés les plus récents. L'option de reconstruction recrée le volume utilisateur à partir de l'instantané le plus récent et le recrée WorkSpace à partir de l'image associée au bundle à partir duquel WorkSpace il a été créé. Les applications installées ou les paramètres système modifiés après leur WorkSpace création sont perdus. Pour plus d'informations sur la restauration et la reconstruction WorkSpaces, consultez Restaurer un WorkSpace et Reconstruire un WorkSpace dans le Guide d' WorkSpaces administration Amazon.

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

  • AutomationAssumeRole

    Type : Chaîne

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

  • Reconnaître

    Type : Chaîne

    Valeurs valides : Oui

    Description : (Obligatoire) Si vous saisissez « oui », vous comprenez que les actions de restauration et de reconstruction tenteront de récupérer les données à WorkSpace partir de l'instantané le plus récent, et que les données restaurées à partir de ces instantanés peuvent dater de 12 heures.

  • Redémarrer

    Type : Chaîne

    Valeurs valides : Oui | Non

    Par défaut : Oui

    Description : (Obligatoire) Détermine s'il WorkSpace est redémarré.

  • Reconstruire

    Type : Chaîne

    Valeurs valides : Oui | Non

    Par défaut : Non

    Description : (Obligatoire) Détermine si le WorkSpace est reconstruit.

  • Restaurer

    Type : Chaîne

    Valeurs valides : Oui | Non

    Par défaut : Non

    Description : (Obligatoire) Détermine si le WorkSpace est restauré.

  • WorkspaceId

    Type : Chaîne

    Description : (Obligatoire) L'ID du WorkSpace fichier que vous souhaitez récupérer.

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • workspaces:DescribeWorkspaces

  • workspaces:DescribeWorkspaceSnapshots

  • workspaces:RebootWorkspaces

  • workspaces:RebuildWorkspaces

  • workspaces:RestoreWorkspace

  • workspaces:StartWorkspaces

Étapes de document

  • aws:executeAwsApi- Recueille l'état WorkSpace que vous spécifiez dans le WorkspaceId paramètre.

  • aws:assertAwsResourceProperty- Vérifie l'état du WorkSpace isAVAILABLE,ERROR, IMPAIREDSTOPPED, ouUNHEALTHY.

  • aws:branch- Branches en fonction de l'état du WorkSpace.

  • aws:executeAwsApi- Démarre le WorkSpace.

  • aws:branch- Branches basées sur la valeur que vous spécifiez pour le Action paramètre.

  • aws:waitForAwsResourceProperty- Attend le WorkSpace statut après avoir démarré.

  • aws:waitForAwsResourceProperty- Attend que l' WorkSpace état passe àAVAILABLE, ERRORIMPAIRED, ou UNHEALTHY après le démarrage.

  • aws:executeAwsApi- Répertorie l'état WorkSpace après le démarrage.

  • aws:branch- Branches en fonction de l'état WorkSpace après le démarrage.

  • aws:executeAwsApi- Rassemble les instantanés disponibles pour restaurer ou reconstruire le. WorkSpace

  • aws:branch- Branches basées sur la valeur que vous spécifiez pour le Reboot paramètre.

  • aws:executeAwsApi- Redémarre le. WorkSpace

  • aws:executeAwsApi- Répertorie l'état WorkSpace après le démarrage.

  • aws:waitForAwsResourceProperty- Attend que l'état du WorkSpace passe àREBOOTING.

  • aws:waitForAwsResourceProperty- Attend que l' WorkSpace état passe à AVAILABLEERROR, ou UNHEALTHY après le redémarrage.

  • aws:executeAwsApi- Recueille l'état WorkSpace après le redémarrage.

  • aws:branch- Branches basées sur l'état WorkSpace après le redémarrage.

  • aws:branch- Branches basées sur la valeur que vous spécifiez pour le Restore paramètre.

  • aws:executeAwsApi- Restaure le WorkSpace. Si la restauration échoue, le runbook essaie de reconstruire le WorkSpace.

  • aws:waitForAwsResourceProperty- Attend que l'état du WorkSpace passe àRESTORING.

  • aws:waitForAwsResourceProperty- Attend que l' WorkSpace état passe à AVAILABLEERROR, ou UNHEALTHY après la restauration.

  • aws:executeAwsApi- Recueille l'état de l' WorkSpace après restauration.

  • aws:branch- Branches basées sur l'état WorkSpace après la restauration.

  • aws:branch- Branches basées sur la valeur que vous spécifiez pour le Rebuild paramètre.

  • aws:executeAwsApi- Reconstruit le. WorkSpace

  • aws:waitForAwsResourceProperty- Attend que l'état du WorkSpace passe àREBUILDING.

  • aws:waitForAwsResourceProperty- Attend que l' WorkSpace état passe à AVAILABLEERROR, ou UNHEALTHY après avoir été reconstruit.

  • aws:executeAwsApi- Répertorie l'état de l'édifice WorkSpace après sa reconstruction.

  • aws:assertAwsResourceProperty- Confirme l'état de WorkSpace l'étatAVAILABLE.