

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `AWSSupport-RecoverWorkSpace`
<a name="automation-awssupport-recover-workspace"></a>

 **Descrição** 

 O `AWSSupport-RecoverWorkSpace` runbook executa etapas de recuperação no desktop WorkSpaces virtual da Amazon, conhecido como WorkSpace, que você especifica. O runbook reinicia o e WorkSpace, se o estado persistir`UNHEALTHY`, restaura ou reconstrói o WorkSpace com base nos valores que você especifica para os parâmetros de entrada. Antes de usar este runbook, recomendamos revisar a [solução de WorkSpaces problemas no Guia](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) de * WorkSpaces administração da Amazon*. 

**Importante**  
Restaurar ou reconstruir um WorkSpace é uma ação potencialmente destrutiva que pode resultar na perda de dados. Isso ocorre porque o WorkSpace é restaurado a partir do último instantâneo disponível e os dados recuperados dos instantâneos podem ter até 12 horas.  
 A opção de restauração recria o volume raiz e o volume do usuário com base nos snapshots mais recentes. A opção de reconstrução recria o volume do usuário a partir do snapshot mais recente e o recria a WorkSpace partir da imagem associada ao pacote a partir do qual foi criado. WorkSpace Os aplicativos que foram instalados ou as configurações do sistema que foram alteradas após a WorkSpace criação são perdidos. Para obter mais informações sobre restauração e reconstrução WorkSpaces, consulte [Restore](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) a WorkSpace e [Rebuild WorkSpace a no *Amazon WorkSpaces * Administration](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) Guide. 

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpace) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ Reconhecer

  Tipo: string

  Valores válidos: yes

  Descrição: (Obrigatório) Digitar sim significa que você entende que as ações de restauração e reconstrução tentarão recuperar o WorkSpace do instantâneo mais recente e que os dados restaurados desses instantâneos podem ter até 12 horas.
+ Reinicializar

  Tipo: string

  Valores válidos: sim \$1 não

  Padrão: sim

  Descrição: (Obrigatório) Determina se o WorkSpace é reinicializado.
+ Rebuild

  Tipo: string

  Valores válidos: sim \$1 não

  Padrão: não

  Descrição: (Obrigatório) Determina WorkSpace se o foi reconstruído.
+ Restaurar

  Tipo: string

  Valores válidos: sim \$1 não

  Padrão: não

  Descrição: (Obrigatório) Determina se o WorkSpace é restaurado.
+ WorkspaceId

  Tipo: string

  Descrição: (Obrigatório) O ID do WorkSpace que você deseja recuperar.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `workspaces:DescribeWorkspaces` 
+  `workspaces:DescribeWorkspaceSnapshots` 
+  `workspaces:RebootWorkspaces` 
+  `workspaces:RebuildWorkspaces` 
+  `workspaces:RestoreWorkspace` 
+  `workspaces:StartWorkspaces` 

 **Etapas do documento** 
+  `aws:executeAwsApi`- Reúne o estado do WorkSpace que você especifica no `WorkspaceId` parâmetro. 
+  `aws:assertAwsResourceProperty`- Verifica o estado do WorkSpace é`AVAILABLE`,`ERROR`, `IMPAIRED``STOPPED`, ou`UNHEALTHY`. 
+  `aws:branch`- Filiais com base no estado do WorkSpace. 
+  `aws:executeAwsApi`- Inicia WorkSpace o. 
+  `aws:branch` :Ramificações com base no valor especificado para o parâmetro `Action`. 
+  `aws:waitForAwsResourceProperty`- Aguarda o WorkSpace status após ser iniciado. 
+  `aws:waitForAwsResourceProperty`- Espera que o WorkSpace estado mude para`AVAILABLE`, `ERROR``IMPAIRED`, ou `UNHEALTHY` depois de ser iniciado. 
+  `aws:executeAwsApi`- Reúne o estado do WorkSpace após o início. 
+  `aws:branch`- Filiais com base no estado do WorkSpace após o início. 
+  `aws:executeAwsApi`- Reúne os instantâneos disponíveis para restaurar ou reconstruir o. WorkSpace 
+  `aws:branch` :Ramificações com base no valor especificado para o parâmetro `Reboot`. 
+  `aws:executeAwsApi`- Reinicia o. WorkSpace 
+  `aws:executeAwsApi`- Reúne o estado do WorkSpace após o início. 
+  `aws:waitForAwsResourceProperty`- Espera que o estado do mude WorkSpace para. `REBOOTING` 
+  `aws:waitForAwsResourceProperty`- Espera que o WorkSpace estado mude para `AVAILABLE``ERROR`, ou `UNHEALTHY` depois de ser reinicializado. 
+  `aws:executeAwsApi`- Reúne o estado do WorkSpace após a reinicialização. 
+  `aws:branch`- Ramificações com base no estado WorkSpace após a reinicialização. 
+  `aws:branch` :Ramificações com base no valor especificado para o parâmetro `Restore`. 
+  `aws:executeAwsApi`- Restaura o. WorkSpace Se a restauração falhar, o runbook tentará reconstruir o. WorkSpace 
+  `aws:waitForAwsResourceProperty`- Espera que o estado do mude WorkSpace para. `RESTORING` 
+  `aws:waitForAwsResourceProperty`- Espera que o WorkSpace estado mude para `AVAILABLE``ERROR`, ou `UNHEALTHY` depois de ser restaurado. 
+  `aws:executeAwsApi`- Reúne o estado do WorkSpace após ser restaurado. 
+  `aws:branch`- Filiais com base no estado da restauração WorkSpace após a restauração. 
+  `aws:branch` :Ramificações com base no valor especificado para o parâmetro `Rebuild`. 
+  `aws:executeAwsApi`- Reconstrói o. WorkSpace 
+  `aws:waitForAwsResourceProperty`- Espera que o estado do mude WorkSpace para. `REBUILDING` 
+  `aws:waitForAwsResourceProperty`- Espera que o WorkSpace estado mude para `AVAILABLE``ERROR`, ou `UNHEALTHY` depois de ser reconstruído. 
+  `aws:executeAwsApi`- Reúne o estado do WorkSpace após a reconstrução. 
+  `aws:assertAwsResourceProperty`- Confirma o estado do WorkSpace é`AVAILABLE`. 