AWS::WorkSpaces::Workspace - AWS CloudFormation
SyntaxPropertiesReturn valuesSee also

This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::WorkSpaces::Workspace

The AWS::WorkSpaces::Workspace resource specifies a WorkSpace.

Updates are not supported for the BundleId, RootVolumeEncryptionEnabled, UserVolumeEncryptionEnabled, or VolumeEncryptionKey properties. To update these properties, you must also update a property that triggers a replacement, such as the UserName property.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::WorkSpaces::Workspace",
  "Properties" : {
      "BundleId" : String,
      "DirectoryId" : String,
      "RootVolumeEncryptionEnabled" : Boolean,
      "Tags" : [ Tag, ... ],
      "UserName" : String,
      "UserVolumeEncryptionEnabled" : Boolean,
      "VolumeEncryptionKey" : String,
      "WorkspaceProperties" : WorkspaceProperties
    }
}

YAML

Type: AWS::WorkSpaces::Workspace
Properties:
  BundleId: String
  DirectoryId: String
  RootVolumeEncryptionEnabled: Boolean
  Tags: 
    - Tag
  UserName: String
  UserVolumeEncryptionEnabled: Boolean
  VolumeEncryptionKey: String
  WorkspaceProperties: 
    WorkspaceProperties

Properties

BundleId

The identifier of the bundle for the WorkSpace.

Required: Yes

Type: String

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

Update requires: Updates are not supported.

DirectoryId

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

Required: Yes

Type: String

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

Minimum: 10

Maximum: 65

Update requires: No interruption

RootVolumeEncryptionEnabled

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

Required: No

Type: Boolean

Update requires: Updates are not supported.

Tags

The tags for the WorkSpace.

Required: No

Type: Array of Tag

Update requires: No interruption

UserName

The user name of the user for the WorkSpace. This user name must exist in the AWS Directory Service directory for the WorkSpace.

Required: Yes

Type: String

Minimum: 1

Maximum: 63

Update requires: Replacement

UserVolumeEncryptionEnabled

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

Required: No

Type: Boolean

Update requires: Updates are not supported.

VolumeEncryptionKey

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

Required: No

Type: String

Update requires: Updates are not supported.

WorkspaceProperties

The WorkSpace properties.

Required: No

Type: WorkspaceProperties

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the resource name.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Id

The identifier of the WorkSpace, returned as a string.

See also