

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`
<a name="automation-awssupport-recover-workspace"></a>

 **Description** 

 Le `AWSSupport-RecoverWorkSpace` runbook exécute les étapes de restauration sur le bureau WorkSpaces virtuel Amazon, connu sous le nom de WorkSpace, que vous spécifiez. Le runbook redémarre le WorkSpace, et si l'état est toujours le cas`UNHEALTHY`, le restaure ou le reconstruit en WorkSpace fonction des valeurs que vous spécifiez pour les paramètres d'entrée. Avant d'utiliser ce runbook, nous vous recommandons de consulter le *guide d' WorkSpaces administration Amazon* consacré [ WorkSpaces aux problèmes de résolution](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) des problèmes. 

**Important**  
La restauration ou la reconstruction d'un WorkSpace est une action potentiellement destructrice qui peut entraîner la perte de données. Cela est dû au fait que les WorkSpace données sont restaurées à partir du dernier instantané disponible et que 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 [Restore a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) et [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) dans le *Guide d' WorkSpaces administration Amazon*. 

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpace) 

**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 lance ce runbook.
+ Reconnaître

  Type : Chaîne

  Valeurs valides : Oui

  Description : (Obligatoire) Si vous entrez 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 seulement.
+ Redémarrer

  Type : Chaîne

  Valeurs valides : Oui \$1 Non

  Par défaut : Oui

  Description : (Obligatoire) Détermine si le WorkSpace est redémarré.
+ Reconstruire

  Type : Chaîne

  Valeurs valides : Oui \$1 Non

  Par défaut : Non

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

  Type : Chaîne

  Valeurs valides : Oui \$1 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`- Rassemble l'état de ce WorkSpace que vous spécifiez dans le `WorkspaceId` paramètre. 
+  `aws:assertAwsResourceProperty`- Vérifie l'état du WorkSpace is`AVAILABLE`,`ERROR`, `IMPAIRED``STOPPED`, ou`UNHEALTHY`. 
+  `aws:branch`- Branches basées sur 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` `ERROR``IMPAIRED`, ou `UNHEALTHY` après avoir été démarré. 
+  `aws:executeAwsApi`- Recueille l'état de la machine WorkSpace après le démarrage. 
+  `aws:branch`- Branches basées sur l'état de la WorkSpace machine 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`- Recueille l'état de la machine WorkSpace après le démarrage. 
+  `aws:waitForAwsResourceProperty`- Attend que l'état du WorkSpace passe à`REBOOTING`. 
+  `aws:waitForAwsResourceProperty`- Attend que l' WorkSpace état passe à `AVAILABLE``ERROR`, ou `UNHEALTHY` après avoir été redémarré. 
+  `aws:executeAwsApi`- Recueille l'état du WorkSpace après le redémarrage. 
+  `aws:branch`- Branches basées sur l'état du 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 à `AVAILABLE``ERROR`, ou `UNHEALTHY` après avoir été restauré. 
+  `aws:executeAwsApi`- Rassemble l'état de l' WorkSpace objet restauré. 
+  `aws:branch`- Branches basées sur l'état de la restauration WorkSpace après 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 change ou `UNHEALTHY` après avoir été reconstruit. `AVAILABLE` `ERROR` 
+  `aws:executeAwsApi`- Rassemble l'état de l' WorkSpace après sa reconstruction. 
+  `aws:assertAwsResourceProperty`- Confirme l'état du WorkSpace si`AVAILABLE`. 