AWS workspaces documentation change
Summary
Updated protocol modification documentation with clarified requirements, improved failure handling procedures, and added state flexibility for CLI operations.
Security assessment
Changes focus on operational clarifications (e.g., Windows-only protocol changes, network requirement references) and automated snapshot/restore workflows. No vulnerabilities, exploits, or security weaknesses are addressed. The network requirements link is standard documentation, not a new security feature.
Diff
diff --git a/workspaces/latest/adminguide/modify-workspaces.md b/workspaces/latest/adminguide/modify-workspaces.md index 3dd06c705..e10055ae3 100644 --- a//workspaces/latest/adminguide/modify-workspaces.md +++ b//workspaces/latest/adminguide/modify-workspaces.md @@ -179 +179 @@ If your WorkSpace is created with PCoIP bundles, you can modify their streaming - * You can only modify your protocol if your WorkSpace was created with PCoIP bundles. + * You can only modify the protocol for Windows WorkSpaces that were created with PCoIP bundles. @@ -181 +181 @@ If your WorkSpace is created with PCoIP bundles, you can modify their streaming - * Before you modify the protocol to DCV, ensure that your WorkSpace meets the following requirements for a DCV WorkSpace. + * Before you modify the protocol to DCV, make sure that your WorkSpace meets the following requirements for a DCV WorkSpace. @@ -183 +183 @@ If your WorkSpace is created with PCoIP bundles, you can modify their streaming - * Your WorkSpaces client supports DCV + * Your WorkSpaces client supports DCV. @@ -185 +185 @@ If your WorkSpace is created with PCoIP bundles, you can modify their streaming - * The region where your WorkSpace is deployed supports DCV + * The necessary network requirements for DCV are configured. For more information, see [IP address and port requirements for WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/workspaces-port-requirements.html). @@ -187,3 +187 @@ If your WorkSpace is created with PCoIP bundles, you can modify their streaming - * The IP address and port requirements for DCV are open. For more information, see [IP address and port requirements for WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/workspaces-port-requirements.html). - - * Ensure your current bundle is available with DCV. + * Your current bundle is available with DCV. @@ -226 +224 @@ The console provides a guided experience to change the protocol of a WorkSpace f - * In case of a protocol modification failure, the WorkSpace Status will show as _Modify Protocol Failed_. You can view all the WorkSpaces that failed during protocol modification by either selecting the _View failed WorkSpaces_ button in the console banner or by using the filters with combination of `PROTOCOL` and `UPDATE_FAILED`. + * If protocol modification fails, the WorkSpace status shows as _Modify Protocol Failed_. To view WorkSpaces that failed, choose _View failed WorkSpaces_ in the console banner. You can also filter the list by `PROTOCOL` and `UPDATE_FAILED`. @@ -228 +226 @@ The console provides a guided experience to change the protocol of a WorkSpace f - * Before protocol modification begins, a checkpoint snapshot of the WorkSpace is automatically taken. In case of a protocol modification failure, you can restore the WorkSpace to this pre-modification state to ensure no data is lost. To restore, use the [Restore WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) action. + * Before protocol modification begins, Amazon WorkSpaces automatically takes a checkpoint snapshot of the WorkSpace. If the modification fails, the WorkSpace is automatically restored to its pre-modification checkpoint snapshot to ensure no data is lost. @@ -230 +228 @@ The console provides a guided experience to change the protocol of a WorkSpace f - * After the WorkSpace has been restored to the checkpoint snapshot, try the Modify Protocol action again. If the failure persists, contact AWS Support. + * After the WorkSpace is automatically restored, try the Modify Protocol action again. If the failure persists, contact AWS Support. @@ -239 +237 @@ The console provides a guided experience to change the protocol of a WorkSpace f - 1. [Optional] Reboot your WorkSpace and wait until it's in the `AVAILABLE` state before modifying the protocol. + 1. (Optional) Reboot your WorkSpace before modifying the protocol. @@ -241 +239 @@ The console provides a guided experience to change the protocol of a WorkSpace f - 2. [Optional] Use the `describe-workspaces` command to list the WorkSpace properties. Ensure that it's in the `AVAILABLE` state and its current `Protocol` is accurate. + 2. (Optional) Use the `describe-workspaces` command to list the WorkSpace properties. Verify that its current `Protocols` property is accurate. The WorkSpace can be in either the `AVAILABLE` or `STOPPED` state. @@ -255 +253 @@ The `Protocols` property is case-sensitive. Ensure that you use `PCOIP` or `WSP` - 5. Use the `describe-workspaces` command again to list the WorkSpace properties and verify that it's in an `AVAILABLE` state and the current `Protocols` property has been changed to the correct protocol. + 5. Use the `describe-workspaces` command again. Verify that the WorkSpace is not in the `UNHEALTHY` state and that the `Protocols` property shows the correct protocol. @@ -265 +263 @@ The `Protocols` property is case-sensitive. Ensure that you use `PCOIP` or `WSP` - * Before protocol modification begins, a checkpoint snapshot of the WorkSpace is automatically taken. In case of a protocol modification failure, you can restore the WorkSpace to this pre-modification state to ensure no data is lost. To restore, use the [`restore-workspace`](https://docs.aws.amazon.com/cli/latest/reference/workspaces/restore-workspace.html) command. See [Restore WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) documentation for details. + * Before protocol modification begins, Amazon WorkSpaces automatically takes a checkpoint snapshot of the WorkSpace. If the modification fails, the WorkSpace is automatically restored to its pre-modification checkpoint snapshot to ensure no data is lost. @@ -267 +265 @@ The `Protocols` property is case-sensitive. Ensure that you use `PCOIP` or `WSP` - * After the WorkSpace has been restored to the checkpoint snapshot, try the `modify-workspace-properties` command again. If the failure persists, contact AWS Support. + * After the WorkSpace is automatically restored, try the `modify-workspace-properties` command again. If the failure persists, contact AWS Support.