翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

 **説明** 

 `AWSSupport-RecoverWorkSpace` ランブックは、WorkSpace として知られる、指定した Amazon WorkSpaces 仮想デスクトップで復旧手順を実行します。ランブックは WorkSpace を再起動し、状態が `UNHEALTHY` のままな場合は、入力パラメータに指定した値に基づいて WorkSpace を復元または再構築します。このランブックを使用する前に、「Amazon WorkSpaces 管理ガイド」の「[WorkSpaces の問題のトラブルシューティング](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html)」を確認することをお勧めします。

**重要**  
WorkSpace の復元または再構築は、データが失われる可能性のある潜在的に破壊的なアクションです。これは、WorkSpace が最後に利用可能なスナップショットから復元され、スナップショットから復旧したデータは 12 時間前のものである可能性があるためです。  
 復元オプションは、最新のスナップショットに基づいて、ルートボリュームとユーザーボリュームの両方を再作成します。再構築オプションは、最新のスナップショットからユーザーボリュームを再作成し、WorkSpace の作成元のバンドルに関連付けられたイメージから WorkSpace を再作成します。WorkSpace の作成後にインストールされたアプリケーション、または変更されたシステム設定は失われます。WorkSpaces の復元と再構築の詳細については、「Amazon WorkSpaces 管理ガイド」の「[WorkSpace の復元](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html)」および「[WorkSpace の再構築](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html)」を参照してください。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpace) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

**[Platforms]** (プラットフォーム)

Linux、macOS、Windows

**パラメータ**
+ AutomationAssumeRole

  タイプ: 文字列

  説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ 了解

  タイプ: 文字列

  有効な値: はい

  説明: (必須)「はい」と入力すると、復元および再構築アクションによって最新のスナップショットから WorkSpace の復旧が試行され、このようなスナップショットから復元されたデータは 12 時間前のものである可能性あることを理解していることを意味します。
+ リブート

  タイプ: 文字列

  有効な値: はい \$1 いいえ

  デフォルト: Yes

  説明: (必須) 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` - `WorkspaceId` パラメータで指定した WorkSpace の状態を収集します。
+  `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 の状態が `AVAILABLE` であることを確認します。