How do I recover an Amazon WorkSpaces desktop that has an UNHEALTHY status?

2 minute read

I want to use the AWSSupport-RecoverWorkSpace AWS Systems Manager automation runbook to recover an unhealthy WorkSpace.

Short description

Before you use the AWSSupport-RecoverWorkSpace runbook to restore or rebuild a WorkSpace that's in the UNHEALTHY status, see Troubleshooting WorkSpaces issues to try to resolve the issue.

Important: When you restore or rebuild a WorkSpace, data loss can occur. The WorkSpace is restored from the last available snapshot that's up to 12 hours old. The rebuild option recreates the user volume from the most recent snapshot. The rebuild recreates the WorkSpace from the image that's associated with the bundle that you created the WorkSpace from. Applications that you installed or system settings that you changed after you created the WorkSpace are lost.

For more information, see Restore a WorkSpace and Rebuild a WorkSpace.



Before you run the automation, make sure that your AWS Identify and Access Management (IAM) user or role has the required permissions. For more information, see the Required IAM permissions section of AWSSupport-RecoverWorkSpace.

Run the AWSSupport-RecoverWorkSpace runbook

Complete the following steps:

  1. Open the AWSSupport-RecoverWorkSpace runbook.
  2. Choose Execute automation.
  3. For the input parameters enter the following values:
    AutomationAssumeRole (optional): The ARN of the IAM role that allows Automation to perform actions. If you don't specify a role, then the automation uses the permissions of the user that starts the runbook.
    Acknowledge (required): Enter Yes to acknowledge that restore and rebuild actions recover the WorkSpace from the most recent snapshot.
    Choose one of the following required actions:
    Reboot (required): Choose Yes to reboot the WorkSpace.
    Rebuild (required): Choose Yes to rebuild the WorkSpace.
    Restore (required): Choose Yes to restore the WorkSpace. 
    WorkspaceId (required): The ID of the WorkSpace that you want to recover.
  4. Choose Execute.
    For a list of the steps that the runbook performs, see the Document Steps section of AWSSupport-RecoverWorkSpace.
  5. Check the status of your workspace in the Output section of the runbook.

Related information

Run an automation

Setting up Automation

AWS OFFICIALUpdated 5 months ago

This is very helpful. However, the article says we have to manually enter the WorkspaceID that needs to be recovered. Is it possible to send the Unhealthy WorkspaceID automatically via cloudwatch alarm ? Or do we have any automation to fetch the Unhealthy WorkspaceID automatically?

replied 3 months ago

Thank you for your comment. We'll review and update the Knowledge Center article as needed.

profile pictureAWS
replied 3 months ago