

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

 **Descrizione** 

 Il `AWSSupport-RecoverWorkSpace` runbook esegue le fasi di ripristino sul desktop WorkSpaces virtuale Amazon, noto come a WorkSpace, specificato dall'utente. Il runbook riavvia e WorkSpace, se lo stato è fermo`UNHEALTHY`, lo ripristina o ricostruisce in WorkSpace base ai valori specificati per i parametri di input. Prima di utilizzare questo runbook, ti consigliamo di consultare la sezione [Troubleshooting WorkSpaces Issues](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) nella *Amazon WorkSpaces Administration Guide*. 

**Importante**  
Il ripristino o la ricostruzione di un WorkSpace è un'azione potenzialmente distruttiva che può causare la perdita di dati. Questo perché WorkSpace viene ripristinato dall'ultima istantanea disponibile e i dati recuperati dalle istantanee possono durare fino a 12 ore.  
 L'opzione di ripristino ricrea sia il volume root che il volume utente in base alle istantanee più recenti. L'opzione rebuild ricrea il volume utente dall'istantanea più recente e ricrea quello WorkSpace dall'immagine associata al pacchetto da cui è stato creato. WorkSpace Le applicazioni installate o le impostazioni di sistema modificate dopo la WorkSpace creazione vengono perse. Per ulteriori informazioni sul ripristino e la ricostruzione WorkSpaces, consulta [Restore a WorkSpace e [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html)](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) nella *Amazon WorkSpaces * Administration Guide. 

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

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

LinuxmacOS, Windows

**Parametri**
+ AutomationAssumeRole

  Tipo: String

  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.
+ Riconoscere

  Tipo: String

  Valori validi: Sì

  Descrizione: (Obbligatorio) Se si digita sì, si accetta che le azioni di ripristino e ricostruzione tenteranno di ripristinare l'istantanea più recente e che i dati ripristinati da queste istantanee possono durare fino a 12 ore. WorkSpace 
+ Riavviare

  Tipo: String

  Valori validi: Sì \$1 No

  Predefinito: Sì

  Descrizione: (Obbligatorio) Determina se WorkSpace viene riavviato.
+ Ricostruire

  Tipo: String

  Valori validi: Sì \$1 No

  Predefinito: No

  Descrizione: (Obbligatorio) Determina se WorkSpace viene ricostruito.
+ Ripristino

  Tipo: String

  Valori validi: Sì \$1 No

  Predefinito: No

  Descrizione: (Obbligatorio) Determina se WorkSpace viene ripristinato.
+ WorkspaceId

  Tipo: String

  Descrizione: (Obbligatorio) L'ID del file che WorkSpace desideri ripristinare.

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `workspaces:DescribeWorkspaces` 
+  `workspaces:DescribeWorkspaceSnapshots` 
+  `workspaces:RebootWorkspaces` 
+  `workspaces:RebuildWorkspaces` 
+  `workspaces:RestoreWorkspace` 
+  `workspaces:StartWorkspaces` 

 **Fasi del documento** 
+  `aws:executeAwsApi`- Raccoglie lo stato WorkSpace specificato nel `WorkspaceId` parametro. 
+  `aws:assertAwsResourceProperty`- Verifica lo stato di WorkSpace is`AVAILABLE`,, `ERROR` `IMPAIRED``STOPPED`, o. `UNHEALTHY` 
+  `aws:branch`- Filiali in base allo stato del WorkSpace. 
+  `aws:executeAwsApi`- Avvia il WorkSpace. 
+  `aws:branch`- Rami basati sul valore specificato per il `Action` parametro. 
+  `aws:waitForAwsResourceProperty`- Attende lo WorkSpace stato dopo l'avvio. 
+  `aws:waitForAwsResourceProperty`- Attende che lo WorkSpace stato cambi in`AVAILABLE`, `ERROR``IMPAIRED`, o `UNHEALTHY` dopo l'avvio. 
+  `aws:executeAwsApi`- Raccoglie lo stato di WorkSpace dopo l'avvio. 
+  `aws:branch`- Filiali in base allo stato del WorkSpace dopo l'avvio. 
+  `aws:executeAwsApi`- Raccoglie le istantanee disponibili per il ripristino o la ricostruzione di. WorkSpace 
+  `aws:branch`- Rami basati sul valore specificato per il parametro. `Reboot` 
+  `aws:executeAwsApi`- Riavvia il. WorkSpace 
+  `aws:executeAwsApi`- Raccoglie lo stato di WorkSpace dopo l'avvio. 
+  `aws:waitForAwsResourceProperty`- Attende che lo stato del WorkSpace cambi. `REBOOTING` 
+  `aws:waitForAwsResourceProperty`- Attende che lo WorkSpace stato cambi o `UNHEALTHY` dopo `AVAILABLE` il `ERROR` riavvio. 
+  `aws:executeAwsApi`- Raccoglie lo stato di dopo il riavvio. WorkSpace 
+  `aws:branch`- Rami in base allo stato del dopo il WorkSpace riavvio. 
+  `aws:branch`- Rami basati sul valore specificato per il `Restore` parametro. 
+  `aws:executeAwsApi`- Ripristina il. WorkSpace Se il ripristino fallisce, il runbook tenta di ricostruire il. WorkSpace 
+  `aws:waitForAwsResourceProperty`- Attende che lo stato WorkSpace di. `RESTORING` 
+  `aws:waitForAwsResourceProperty`- Attende che lo WorkSpace stato cambi a `AVAILABLE``ERROR`, o `UNHEALTHY` dopo essere stato ripristinato. 
+  `aws:executeAwsApi`- Raccoglie lo stato di WorkSpace dopo il ripristino. 
+  `aws:branch`- Rami in base allo stato dell'ambiente WorkSpace dopo il ripristino. 
+  `aws:branch`- Rami basati sul valore specificato per il `Rebuild` parametro. 
+  `aws:executeAwsApi`- Ricostruisce il. WorkSpace 
+  `aws:waitForAwsResourceProperty`- Attende che lo stato del cambi WorkSpace in. `REBUILDING` 
+  `aws:waitForAwsResourceProperty`- Attende che lo WorkSpace stato cambi a `AVAILABLE``ERROR`, o `UNHEALTHY` dopo essere stato ricostruito. 
+  `aws:executeAwsApi`- Raccoglie lo stato di WorkSpace dopo la ricostruzione. 
+  `aws:assertAwsResourceProperty`- Conferma lo stato di is. WorkSpace `AVAILABLE` 