쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

WorkspaceDirectory - Amazon WorkSpaces Service
이 페이지는 귀하의 언어로 번역되지 않았습니다. 번역 요청

WorkspaceDirectory

Describes a directory that is used with Amazon WorkSpaces.

Contents

ActiveDirectoryConfig

Information about the Active Directory config.

Type: ActiveDirectoryConfig object

Required: No

Alias

The directory alias.

Type: String

Required: No

CertificateBasedAuthProperties

The certificate-based authentication properties used to authenticate SAML 2.0 Identity Provider (IdP) user identities to Active Directory for WorkSpaces login.

Type: CertificateBasedAuthProperties object

Required: No

CustomerUserName

The user name for the service account.

Type: String

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

Required: No

DirectoryId

The directory identifier.

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

DirectoryName

The name of the directory.

Type: String

Required: No

DirectoryType

The directory type.

Type: String

Valid Values: SIMPLE_AD | AD_CONNECTOR | CUSTOMER_MANAGED | AWS_IAM_IDENTITY_CENTER

Required: No

DnsIpAddresses

The IP addresses of the DNS servers for the directory.

Type: Array of strings

Required: No

EndpointEncryptionMode

Endpoint encryption mode that allows you to configure the specified directory between Standard TLS and FIPS 140-2 validated mode.

Type: String

Valid Values: STANDARD_TLS | FIPS_VALIDATED

Required: No

ErrorMessage

The error message returned.

Type: String

Required: No

IamRoleId

The identifier of the IAM role. This is the role that allows Amazon WorkSpaces to make calls to other services, such as Amazon EC2, on your behalf.

Type: String

Pattern: ^arn:aws[a-z-]{0,7}:[A-Za-z0-9][A-za-z0-9_/.-]{0,62}:[A-za-z0-9_/.-]{0,63}:[A-za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.\\-]{0,1023}$

Required: No

IDCConfig

Specifies details about identity center configurations.

Type: IDCConfig object

Required: No

ipGroupIds

The identifiers of the IP access control groups associated with the directory.

Type: Array of strings

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

Required: No

MicrosoftEntraConfig

Specifies details about Microsoft Entra configurations.

Type: MicrosoftEntraConfig object

Required: No

RegistrationCode

The registration code for the directory. This is the code that users enter in their Amazon WorkSpaces client application to connect to the directory.

Type: String

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

Required: No

SamlProperties

Describes the enablement status, user access URL, and relay state parameter name that are used for configuring federation with an SAML 2.0 identity provider.

Type: SamlProperties object

Required: No

SelfservicePermissions

The default self-service permissions for WorkSpaces in the directory.

Type: SelfservicePermissions object

Required: No

State

The state of the directory's registration with Amazon WorkSpaces. After a directory is deregistered, the DEREGISTERED state is returned very briefly before the directory metadata is cleaned up, so this state is rarely returned. To confirm that a directory is deregistered, check for the directory ID by using DescribeWorkspaceDirectories. If the directory ID isn't returned, then the directory has been successfully deregistered.

Type: String

Valid Values: REGISTERING | REGISTERED | DEREGISTERING | DEREGISTERED | ERROR

Required: No

StreamingProperties

The streaming properties to configure.

Type: StreamingProperties object

Required: No

SubnetIds

The identifiers of the subnets used with the directory.

Type: Array of strings

Array Members: Maximum number of 2 items.

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

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

Required: No

Tenancy

Specifies whether the directory is dedicated or shared. To use Bring Your Own License (BYOL), this value must be set to DEDICATED. For more information, see Bring Your Own Windows Desktop Images.

Type: String

Valid Values: DEDICATED | SHARED

Required: No

UserIdentityType

Indicates the identity type of the specifired user.

Type: String

Valid Values: CUSTOMER_MANAGED | AWS_DIRECTORY_SERVICE | AWS_IAM_IDENTITY_CENTER

Required: No

WorkspaceAccessProperties

The devices and operating systems that users can use to access WorkSpaces.

Type: WorkspaceAccessProperties object

Required: No

WorkspaceCreationProperties

The default creation properties for all WorkSpaces in the directory.

Type: DefaultWorkspaceCreationProperties object

Required: No

WorkspaceDirectoryDescription

The description of the WorkSpace directory

Type: String

Pattern: ^([a-zA-Z0-9_])[\\a-zA-Z0-9_@#%*+=:?./!\s-]{1,255}$

Required: No

WorkspaceDirectoryName

The name fo the WorkSpace directory.

Type: String

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.\s-]{1,64}$

Required: No

WorkspaceSecurityGroupId

The identifier of the security group that is assigned to new WorkSpaces.

Type: String

Length Constraints: Minimum length of 11. Maximum length of 20.

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

Required: No

WorkspaceType

Indicates whether the directory's WorkSpace type is personal or pools.

Type: String

Valid Values: PERSONAL | POOLS

Required: No

See Also

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

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.