本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

 **描述** 

 `AWSSupport-RecoverWorkSpace`运行手册在您指定的 Amazon WorkSpaces 虚拟桌面（称为 a WorkSpace）上执行恢复步骤。运行手册会重新启动 WorkSpace，如果状态静止`UNHEALTHY`，则 WorkSpace 根据您为输入参数指定的值恢复或重建。在使用本运行手册之前，我们建议您查看《*Amazon WorkSpaces 管理指南》*中的 “[疑难解答 WorkSpaces ](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html)”。

**重要**  
恢复或重建 WorkSpace 是一种潜在的破坏性操作，可能会导致数据丢失。这是因为是从上次可用的快照中恢复的，而从快照中恢复的数据可能长达 12 小时。 WorkSpace   
 恢复选项会根据最新的快照重新创建根卷和用户卷。rebuild 选项根据最新的快照重新创建用户卷，并 WorkSpace 从与创建该分发包关联的映像中重新创建用户卷。 WorkSpace 已安装的应用程序或在创建后更改的 WorkSpace 系统设置都将丢失。有关恢复和重建的更多信息 WorkSpaces，请参阅《*Amazon WorkSpaces 管理指南》 WorkSpace*中的 “[还](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html)原 WorkSpace和[重建 a](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html)”。

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpace) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux、macOS、Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ 确认

  类型：字符串

  有效值：是

  描述：（必填）输入 “是” 表示您知道还原和重建操作将尝试 WorkSpace 从最新的快照中恢复，并且从这些快照恢复的数据可能最长为 12 小时。
+ Reboot

  类型：字符串

  有效值：是 \$1 否

  默认：是

  描述：（必填）确定 WorkSpace 是否重新启动。
+ 重建

  类型：字符串

  有效值：是 \$1 否

  默认：否

  描述：（必填）确定 WorkSpace 是否重建。
+ Restore

  类型：字符串

  有效值：是 \$1 否

  默认：否

  描述：（必填）确定 WorkSpace 是否恢复。
+ WorkspaceId

  类型：字符串

  描述：（必填） WorkSpace 要恢复的 ID。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `workspaces:DescribeWorkspaces` 
+  `workspaces:DescribeWorkspaceSnapshots` 
+  `workspaces:RebootWorkspaces` 
+  `workspaces:RebuildWorkspaces` 
+  `workspaces:RestoreWorkspace` 
+  `workspaces:StartWorkspaces` 

 **文档步骤** 
+  `aws:executeAwsApi`-收集 WorkSpace 您在`WorkspaceId`参数中指定的状态。
+  `aws:assertAwsResourceProperty`-验证 WorkSpace 是`AVAILABLE`、、`ERROR``IMPAIRED``STOPPED`、或`UNHEALTHY`的状态。
+  `aws:branch`-基于状态的分支 WorkSpace。
+  `aws:executeAwsApi`-启动 WorkSpace。
+  `aws:branch` - 根据您为 `Action` 参数指定的值进行分支。
+  `aws:waitForAwsResourceProperty`-启动后等待 WorkSpace 状态。
+  `aws:waitForAwsResourceProperty`-等待 WorkSpace 状态更改为`AVAILABLE`、`ERROR``IMPAIRED`、或启动`UNHEALTHY`后。
+  `aws:executeAwsApi`-收集启动 WorkSpace 后的状态。
+  `aws:branch`-基于启动 WorkSpace 后的状态的分支。
+  `aws:executeAwsApi`-收集用于恢复或重建的可用快照。 WorkSpace
+  `aws:branch` - 根据您为 `Reboot` 参数指定的值进行分支。
+  `aws:executeAwsApi`-重新启动。 WorkSpace
+  `aws:executeAwsApi`-收集启动 WorkSpace 后的状态。
+  `aws:waitForAwsResourceProperty`-等待状态变 WorkSpace 为。`REBOOTING`
+  `aws:waitForAwsResourceProperty`-等待 WorkSpace 状态更改为`AVAILABLE``ERROR`、或重新启动`UNHEALTHY`后。
+  `aws:executeAwsApi`-收集重启 WorkSpace 后的状态。
+  `aws:branch`-根据重启 WorkSpace 后的状态进行分支。
+  `aws:branch` - 根据您为 `Restore` 参数指定的值进行分支。
+  `aws:executeAwsApi`-恢复。 WorkSpace如果恢复失败，运行手册将尝试重建。 WorkSpace
+  `aws:waitForAwsResourceProperty`-等待状态变 WorkSpace 为。`RESTORING`
+  `aws:waitForAwsResourceProperty`-等待 WorkSpace 状态更改为`AVAILABLE``ERROR`、或恢复`UNHEALTHY`后。
+  `aws:executeAwsApi`-收集恢复 WorkSpace 后的状态。
+  `aws:branch`-基于恢复 WorkSpace 后的状态的分支。
+  `aws:branch` - 根据您为 `Rebuild` 参数指定的值进行分支。
+  `aws:executeAwsApi`-重建。 WorkSpace
+  `aws:waitForAwsResourceProperty`-等待状态变 WorkSpace 为。`REBUILDING`
+  `aws:waitForAwsResourceProperty`-等待 WorkSpace 状态更改为`AVAILABLE``ERROR`、或重建`UNHEALTHY`后。
+  `aws:executeAwsApi`-收集重建 WorkSpace 后的状态。
+  `aws:assertAwsResourceProperty`-确认 WorkSpace is 的状态`AVAILABLE`。