AWSSupport-RecoverWorkSpace

説明

AWSSupport-RecoverWorkSpace ランブックは、 WorkSpace指定した と呼ばれる Amazon WorkSpaces 仮想デスクトップで復旧ステップを実行します。ランブックは を再起動し WorkSpace、 状態が のままの場合、 UNHEALTHY は入力パラメータに指定した値 WorkSpace に基づいて を復元または再構築します。このランブックを使用する前に、「Amazon WorkSpaces 管理ガイド」の WorkSpaces 「問題のトラブルシューティング」を確認することをお勧めします。

重要

を復元または再構築することは、データが失われる可能性のある破壊的なアクション WorkSpace です。これは、 WorkSpace が最後に利用可能なスナップショットから復元され、スナップショットから復元されたデータは 12 時間まで古い可能性があるためです。

復元オプションは、最新のスナップショットに基づいて、ルートボリュームとユーザーボリュームの両方を再作成します。再構築オプションは、最新のスナップショットからユーザーボリュームを再作成し、 WorkSpace が作成されたバンドルに関連付けられたイメージ WorkSpace から を再作成します。インストールされたアプリケーションや、 WorkSpace の作成後に変更されたシステム設定は失われます。の復元と再構築の詳細については WorkSpaces、「Amazon WorkSpaces 管理ガイド」の「 の復元 WorkSpace」と「 の再構築 WorkSpace」を参照してください。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

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

Linux、macOS、Windows

パラメータ

• AutomationAssumeRole

  型: 文字列

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

• 了解

  型: 文字列

  有効な値: はい

  説明: (必須) 「はい」と入力すると、復元アクションと再構築アクションが最新のスナップショット WorkSpace から を復元しようとし、これらのスナップショットから復元されたデータは 12 時間経過する場合があることを理解していることになります。

• 再起動

  型: 文字列

  有効な値: はい | いいえ

  デフォルト: Yes

  説明: (必須) WorkSpace を再起動するかどうかを決定します。

• 再構築

  型: 文字列

  有効な値: はい | いいえ

  デフォルト: いいえ

  説明: (必須) WorkSpace を再構築するかどうかを決定します。

• 復元

  型: 文字列

  有効な値: はい | いいえ

  デフォルト: いいえ

  説明: (必須) が復元 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 - 起動UNHEALTHY後に WorkSpace 状態が AVAILABLE 、ERROR、、または IMPAIRED に変わるのを待ちます。

• aws:executeAwsApi - 起動 WorkSpace 後の の状態を収集します。

• aws:branch - 起動 WorkSpace 後の の状態に基づいて分岐します。

• aws:executeAwsApi - を復元または再構築するために使用可能なスナップショットを収集します WorkSpace。

• aws:branch - Reboot パラメータで指定した値に基づいて分岐させます。

• aws:executeAwsApi - を再起動します WorkSpace。

• aws:executeAwsApi - 起動 WorkSpace 後の の状態を収集します。

• aws:waitForAwsResourceProperty - の状態が REBOOTING WorkSpace に変わるのを待ちます。

• aws:waitForAwsResourceProperty - 再起動UNHEALTHY後に WorkSpace 状態が AVAILABLE 、、または ERROR に変わるのを待ちます。

• aws:executeAwsApi - 再起動 WorkSpace 後の の状態を収集します。

• aws:branch - 再起動 WorkSpace 後の の状態に基づいて分岐します。

• aws:branch - Restore パラメータで指定した値に基づいて分岐させます。

• aws:executeAwsApi - を復元します WorkSpace。復元が失敗すると、ランブックは の再構築を試みます WorkSpace。

• aws:waitForAwsResourceProperty - の状態が RESTORING WorkSpace に変わるのを待ちます。

• aws:waitForAwsResourceProperty - WorkSpace 状態が復元UNHEALTHY後に AVAILABLE 、、または ERROR に変わるのを待ちます。

• aws:executeAwsApi - 復元 WorkSpace 後の の状態を収集します。

• aws:branch - 復元 WorkSpace 後の の状態に基づいて分岐します。

• aws:branch - Rebuild パラメータで指定した値に基づいて分岐させます。

• aws:executeAwsApi - を再構築します WorkSpace。

• aws:waitForAwsResourceProperty - の状態が REBUILDING WorkSpace に変わるのを待ちます。

• aws:waitForAwsResourceProperty - 再構築UNHEALTHY後に WorkSpace 状態が AVAILABLE 、、または ERROR に変わるのを待ちます。

• aws:executeAwsApi - 再構築 WorkSpace 後の の状態を収集します。

• aws:assertAwsResourceProperty - の状態が AVAILABLE WorkSpace であることを確認します。