選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

Workspace - Amazon WorkSpaces Service
此頁面尚未翻譯為您的語言。 請求翻譯

Workspace

Describes a WorkSpace.

Contents

BundleId

The identifier of the bundle used to create the WorkSpace.

Type: String

Pattern: ^wsb-[0-9a-z]{8,63}$

Required: No

ComputerName

The name of the WorkSpace, as seen by the operating system. The format of this name varies. For more information, see Launch a WorkSpace.

Type: String

Required: No

DataReplicationSettings

Indicates the settings of the data replication.

Type: DataReplicationSettings object

Required: No

DirectoryId

The identifier of the AWS Directory Service directory for the WorkSpace.

Type: String

Length Constraints: Minimum length of 10. Maximum length of 65.

Pattern: ^(d-[0-9a-f]{8,63}$)|(wsd-[0-9a-z]{8,63}$)

Required: No

ErrorCode

The error code that is returned if the WorkSpace cannot be created.

Type: String

Required: No

ErrorMessage

The text of the error message that is returned if the WorkSpace cannot be created.

Type: String

Required: No

IpAddress

The IP address of the WorkSpace.

Type: String

Required: No

ModificationStates

The modification states of the WorkSpace.

Type: Array of ModificationState objects

Required: No

RelatedWorkspaces

The standby WorkSpace or primary WorkSpace related to the specified WorkSpace.

Type: Array of RelatedWorkspaceProperties objects

Required: No

RootVolumeEncryptionEnabled

Indicates whether the data stored on the root volume is encrypted.

Type: Boolean

Required: No

StandbyWorkspacesProperties

The properties of the standby WorkSpace

Type: Array of StandbyWorkspacesProperties objects

Required: No

State

The operational state of the WorkSpace.

  • PENDING – The WorkSpace is in a waiting state (for example, the WorkSpace is being created).

  • AVAILABLE – The WorkSpace is running and has passed the health checks.

  • IMPAIRED – Refer to UNHEALTHY state.

  • UNHEALTHY – The WorkSpace is not responding to health checks.

  • REBOOTING – The WorkSpace is being rebooted (restarted).

  • STARTING – The WorkSpace is starting up and health checks are being run.

  • REBUILDING – The WorkSpace is being rebuilt.

  • RESTORING – The WorkSpace is being restored.

  • MAINTENANCE – The WorkSpace is undergoing scheduled maintenance by AWS.

  • ADMIN_MAINTENANCE – The WorkSpace is undergoing maintenance by the WorkSpaces administrator.

  • TERMINATING – The WorkSpace is being deleted.

  • TERMINATED – The WorkSpace has been deleted.

  • SUSPENDED – The WorkSpace has been suspended for image creation.

  • UPDATING – The WorkSpace is undergoing an update.

  • STOPPING – The WorkSpace is being stopped.

  • STOPPED – The WorkSpace has been stopped.

  • ERROR – The WorkSpace is an error state (for example, an error occurred during startup).

Note

After a WorkSpace is terminated, the TERMINATED state is returned only briefly before the WorkSpace directory metadata is cleaned up, so this state is rarely returned. To confirm that a WorkSpace is terminated, check for the WorkSpace ID by using DescribeWorkSpaces. If the WorkSpace ID isn't returned, then the WorkSpace has been successfully terminated.

Type: String

Valid Values: PENDING | AVAILABLE | IMPAIRED | UNHEALTHY | REBOOTING | STARTING | REBUILDING | RESTORING | MAINTENANCE | ADMIN_MAINTENANCE | TERMINATING | TERMINATED | SUSPENDED | UPDATING | STOPPING | STOPPED | ERROR

Required: No

SubnetId

The identifier of the subnet for the WorkSpace.

Type: String

Length Constraints: Minimum length of 15. Maximum length of 24.

Pattern: ^(subnet-([0-9a-f]{8}|[0-9a-f]{17}))$

Required: No

UserName

The user for the WorkSpace.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Required: No

UserVolumeEncryptionEnabled

Indicates whether the data stored on the user volume is encrypted.

Type: Boolean

Required: No

VolumeEncryptionKey

The ARN of the symmetric AWS KMS key used to encrypt data stored on your WorkSpace. Amazon WorkSpaces does not support asymmetric KMS keys.

Type: String

Required: No

WorkspaceId

The identifier of the WorkSpace.

Type: String

Pattern: ^ws-[0-9a-z]{8,63}$

Required: No

WorkspaceName

The name of the user-decoupled WorkSpace.

Type: String

Pattern: ^[a-zA-Z0-9_()][a-zA-Z0-9_.()-]{1,63}$

Required: No

WorkspaceProperties

The properties of the WorkSpace.

Type: WorkspaceProperties object

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。