Modify a WorkSpace - Amazon WorkSpaces
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Modify a WorkSpace

After you launch a WorkSpace, you can modify its configuration in two ways:

  • You can change the size of its root volume (for Windows, drive C; for Linux, /) and its user volume (for Windows, drive D; for Linux /home).

  • You can change its compute type to select a new bundle.

To see the current modification state of a WorkSpace, select the arrow to show more details about that WorkSpace. The possible values for State are Modifying Compute, Modifying Storage, and None.

If you want to modify a WorkSpace, it must have a status of AVAILABLE or STOPPED. You can't change the volume size and the compute type at the same time.

Changing the volume size or compute type of a WorkSpace will change the billing rate for the WorkSpace.

To allow your users to modify their volumes and compute types themselves, see Enable self-service WorkSpace management capabilities for your users.

Modify volume sizes

You can increase the size of the root and user volumes for a WorkSpace, up to 2000 GB each. WorkSpace root and user volumes come in set groups that can't be changed. The available groups are:

[Root (GB), User (GB)]
[80, 10]
[80, 50]
[80, 100]
[175 to 2000, 100 to 2000]

You can expand the root and user volumes whether they are encrypted or unencrypted, and you can expand both volumes once in a 6-hour period. However, you can't increase the size of the root and user volumes at the same time. For more information, see Limitations for Increasing Volumes.

Note

When you expand a volume for a WorkSpace, WorkSpaces automatically extends the volume's partition within Windows or Linux. When the process is finished, you must reboot the WorkSpace for the changes to take effect.

To ensure that your data is preserved, you cannot decrease the size of the root or user volumes after you launch a WorkSpace. Instead, make sure that you specify the minimum sizes for these volumes when launching a WorkSpace. You can launch a Value, Standard, Performance, Power, or PowerPro WorkSpace with a minimum of 80 GB for the root volume and 10 GB for the user volume. You can launch a Graphics.g4dn, GraphicsPro.g4dn, Graphics, or GraphicsPro WorkSpace with a minimum of 100 GB for the root volume and 100 GB for the user volume.

While a WorkSpace disk size increase is in progress, users can perform most tasks on their WorkSpace. However, they can't change their WorkSpace compute type, switch the WorkSpace running mode, rebuild their WorkSpace, or reboot (restart) their WorkSpace.

Note

If you want your users to be able to use their WorkSpaces while the disk size increase is in progress, make sure the WorkSpaces have a status of AVAILABLE instead of STOPPED before you resize the volumes of the WorkSpaces. If the WorkSpaces are STOPPED, they can't be started while the disk size increase is in progress.

In most cases, the disk size increase process might take up to two hours. However, if you're modifying the volume sizes for a large number of WorkSpaces, the process can take significantly longer. If you have a large number of WorkSpaces to modify, we recommend contacting Amazon Web Services Support for assistance.

Limitations for increasing volumes

  • You can resize only SSD volumes.

  • When you launch a WorkSpace, you must wait 6 hours before you can modify the sizes of its volumes.

  • You cannot increase the size of the root and user volumes at the same time. To increase the root volume, you must first change the user volume to 100 GB. After that change is made, you can then update the root volume to any value between 175 and 2000 GB. After the root volume has been changed to any value between 175 and 2000 GB, you can then update the user volume further, to any value between 100 and 2000 GB.

    Note

    If you want to increase both volumes, you must wait 20-30 minutes for the first operation to finish before you can start the second operation.

  • Unless the WorkSpace is a Graphics.g4dn, GraphicsPro.g4dn, Graphics, or GraphicsPro WorkSpace, the root volume cannot be less than 175 GB when the user volume is 100 GB. Graphics.g4dn, GraphicsPro.g4dn, Graphics, and GraphicsPro WorkSpaces can have the root and user volumes both set to 100 GB minimum.

  • If the user volume is 50 GB, you cannot update the root volume to anything other than 80 GB. If the root volume is 80 GB, the user volume can only be 10, 50, or 100 GB.

To modify the root volume of a WorkSpace

  1. Open the WorkSpaces console at https://console.amazonaws.cn/workspaces/.

  2. In the navigation pane, choose WorkSpaces.

  3. Select the WorkSpace and choose Actions, Modify root volume..

  4. Under Root volume sizes, choose a volume size or choose Custom to enter a custom volume size.

  5. Choose Save changes.

  6. When the disk size increase is finished, you must reboot the WorkSpace for the changes to take effect. To avoid data loss, make sure the user saves any open files before you reboot the WorkSpace.

To modify the user volume of a WorkSpace

  1. Open the WorkSpaces console at https://console.amazonaws.cn/workspaces/.

  2. In the navigation pane, choose WorkSpaces.

  3. Select the WorkSpace and choose Actions, Modify user volume..

  4. Under User volume sizes, choose a volume size or choose Custom to enter a custom volume size.

  5. Choose Save changes.

  6. When the disk size increase is finished, you must reboot the WorkSpace for the changes to take effect. To avoid data loss, make sure the user saves any open files before you reboot the WorkSpace.

To change the volume sizes of a WorkSpace

Use the modify-workspace-properties command with the RootVolumeSizeGib or UserVolumeSizeGib property.

Modify compute type

You can switch a WorkSpace between the Standard, Power, Performance, and PowerPro compute types. For more information about these compute types, see Amazon WorkSpaces Bundles.

Note
  • You can change the compute type from Graphics.g4dn to GraphicsPro.g4dn, or from GraphicsPro.g4dn to Graphics.g4dn. You cannot change the compute type of Graphics.g4dn and GraphicsPro.g4dn to any other value.

  • You cannot change the compute type of Graphics and GraphicsPro to any other value.

When you request a compute change, WorkSpaces reboots the WorkSpace using the new compute type. WorkSpaces preserves the operating system, applications, data, and storage settings for the WorkSpace.

You can request a larger compute type once in a 6-hour period or a smaller compute type once every 30 days. For a newly launched WorkSpace, you must wait 6 hours before requesting a larger compute type.

When a WorkSpace compute type change is in progress, users are disconnected from their WorkSpace, and they can't use or change the WorkSpace. The WorkSpace is automatically rebooted during the compute type change process.

Important

To avoid data loss, make sure users save any open documents and other application files before you change the WorkSpace compute type.

The compute type change process might take up to an hour.

To change the compute type of a WorkSpace

  1. Open the WorkSpaces console at https://console.amazonaws.cn/workspaces/.

  2. In the navigation pane, choose WorkSpaces.

  3. Select the WorkSpace and choose Actions, Modify compute type.

  4. Under Compute type, choose a compute type.

  5. Choose Save changes.

To change the compute type of a WorkSpace

Use the modify-workspace-properties command with the ComputeTypeName property.