CfnDirectoryProps Struct
Properties for defining a CfnDirectory.
Example
ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_workspaces as workspaces } from 'aws-cdk-lib';
const cfnDirectoryProps: workspaces.CfnDirectoryProps = {
activeDirectoryConfig: {
domainName: 'domainName',
serviceAccountSecretArn: 'serviceAccountSecretArn',
},
certificateBasedAuthProperties: {
certificateAuthorityArn: 'certificateAuthorityArn',
status: 'status',
},
enableSelfService: false,
endpointEncryptionMode: 'endpointEncryptionMode',
idcInstanceArn: 'idcInstanceArn',
ipGroupIds: ['ipGroupIds'],
microsoftEntraConfig: {
applicationConfigSecretArn: 'applicationConfigSecretArn',
tenantId: 'tenantId',
},
samlProperties: {
relayStateParameterName: 'relayStateParameterName',
status: 'status',
userAccessUrl: 'userAccessUrl',
},
selfservicePermissions: {
changeComputeType: 'changeComputeType',
increaseVolumeSize: 'increaseVolumeSize',
rebuildWorkspace: 'rebuildWorkspace',
restartWorkspace: 'restartWorkspace',
switchRunningMode: 'switchRunningMode',
},
streamingProperties: {
globalAccelerator: {
mode: 'mode',
// the properties below are optional
preferredProtocol: 'preferredProtocol',
},
storageConnectors: [{
connectorType: 'connectorType',
status: 'status',
}],
streamingExperiencePreferredProtocol: 'streamingExperiencePreferredProtocol',
userSettings: [{
action: 'action',
permission: 'permission',
// the properties below are optional
maximumLength: 123,
}],
},
subnetIds: ['subnetIds'],
tags: [{
key: 'key',
value: 'value',
}],
tenancy: 'tenancy',
userIdentityType: 'userIdentityType',
workspaceAccessProperties: {
accessEndpointConfig: {
accessEndpoints: [{
accessEndpointType: 'accessEndpointType',
vpcEndpointId: 'vpcEndpointId',
}],
// the properties below are optional
internetFallbackProtocols: ['internetFallbackProtocols'],
},
deviceTypeAndroid: 'deviceTypeAndroid',
deviceTypeChromeOs: 'deviceTypeChromeOs',
deviceTypeIos: 'deviceTypeIos',
deviceTypeLinux: 'deviceTypeLinux',
deviceTypeOsx: 'deviceTypeOsx',
deviceTypeWeb: 'deviceTypeWeb',
deviceTypeWindows: 'deviceTypeWindows',
deviceTypeWorkSpacesThinClient: 'deviceTypeWorkSpacesThinClient',
deviceTypeZeroClient: 'deviceTypeZeroClient',
},
workspaceCreationProperties: {
customSecurityGroupId: 'customSecurityGroupId',
defaultOu: 'defaultOu',
enableInternetAccess: false,
enableMaintenanceMode: false,
instanceIamRoleArn: 'instanceIamRoleArn',
userEnabledAsLocalAdministrator: false,
},
workspaceDirectoryDescription: 'workspaceDirectoryDescription',
workspaceDirectoryName: 'workspaceDirectoryName',
workspaceType: 'workspaceType',
};
Properties
activeDirectoryConfigoptionalIResolvable | CfnDirectory.ActiveDirectoryConfigPropertyactive_directory_configoptionaltyping.Union[IResolvable, ActiveDirectoryConfigProperty]activeDirectoryConfigoptionalIResolvableActiveDirectoryConfigoptionalIResolvableActiveDirectoryConfigoptionalinterface{}#Information about the Active Directory config.
certificateBasedAuthPropertiesoptionalIResolvable | CfnDirectory.CertificateBasedAuthPropertiesPropertycertificate_based_auth_propertiesoptionaltyping.Union[IResolvable, CertificateBasedAuthPropertiesProperty]certificateBasedAuthPropertiesoptionalIResolvableCertificateBasedAuthPropertiesoptionalIResolvableCertificateBasedAuthPropertiesoptionalinterface{}#Describes the properties of the certificate-based authentication you want to use with your WorkSpaces.
enableSelfServiceoptionalboolean | IResolvableenable_self_serviceoptionaltyping.Union[bool, IResolvable]enableSelfServiceoptionalBooleanEnableSelfServiceoptionalboolEnableSelfServiceoptionalinterface{}#Indicates whether self-service capabilities are enabled or disabled.
endpointEncryptionModeoptionalstringendpoint_encryption_modeoptionalstrendpointEncryptionModeoptionalStringEndpointEncryptionModeoptionalstringEndpointEncryptionModeoptional*string#Endpoint encryption mode that allows you to configure the specified directory between Standard TLS and FIPS 140-2 validated mode.
idcInstanceArnoptionalstringidc_instance_arnoptionalstridcInstanceArnoptionalStringIdcInstanceArnoptionalstringIdcInstanceArnoptional*string#The Amazon Resource Name (ARN) of the identity center instance.
ipGroupIdsoptionalstring[]ip_group_idsoptionaltyping.List[str]ipGroupIdsoptionalList<String>IpGroupIdsoptionalstring[]IpGroupIdsoptional*[]*string#The identifiers of the IP access control groups associated with the directory.
microsoftEntraConfigoptionalIResolvable | CfnDirectory.MicrosoftEntraConfigPropertymicrosoft_entra_configoptionaltyping.Union[IResolvable, MicrosoftEntraConfigProperty]microsoftEntraConfigoptionalIResolvableMicrosoftEntraConfigoptionalIResolvableMicrosoftEntraConfigoptionalinterface{}#Specifies the configurations of the Microsoft Entra.
samlPropertiesoptionalIResolvable | CfnDirectory.SamlPropertiesPropertysaml_propertiesoptionaltyping.Union[IResolvable, SamlPropertiesProperty]samlPropertiesoptionalIResolvableSamlPropertiesoptionalIResolvableSamlPropertiesoptionalinterface{}#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.
selfservicePermissionsoptionalIResolvable | CfnDirectory.SelfservicePermissionsPropertyselfservice_permissionsoptionaltyping.Union[IResolvable, SelfservicePermissionsProperty]selfservicePermissionsoptionalIResolvableSelfservicePermissionsoptionalIResolvableSelfservicePermissionsoptionalinterface{}#Describes the self-service permissions for a directory.
streamingPropertiesoptionalIResolvable | CfnDirectory.StreamingPropertiesPropertystreaming_propertiesoptionaltyping.Union[IResolvable, StreamingPropertiesProperty]streamingPropertiesoptionalIResolvableStreamingPropertiesoptionalIResolvableStreamingPropertiesoptionalinterface{}#Describes the streaming properties.
subnetIdsoptionalstring[]subnet_idsoptionaltyping.List[str]subnetIdsoptionalList<String>SubnetIdsoptionalstring[]SubnetIdsoptional*[]*string#The identifiers of the subnets for your virtual private cloud (VPC).
tagsoptionalCfnTag[]tagsoptionaltyping.List[CfnTag]tagsoptionalList<CfnTag>TagsoptionalCfnTag[]Tagsoptional*[]CfnTag#The tags associated with the directory.
tenancyoptionalstringtenancyoptionalstrtenancyoptionalStringTenancyoptionalstringTenancyoptional*string#Indicates whether your WorkSpace directory is dedicated or shared.
userIdentityTypeoptionalstringuser_identity_typeoptionalstruserIdentityTypeoptionalStringUserIdentityTypeoptionalstringUserIdentityTypeoptional*string#The type of identity management the user is using.
workspaceAccessPropertiesoptionalIResolvable | CfnDirectory.WorkspaceAccessPropertiesPropertyworkspace_access_propertiesoptionaltyping.Union[IResolvable, WorkspaceAccessPropertiesProperty]workspaceAccessPropertiesoptionalIResolvableWorkspaceAccessPropertiesoptionalIResolvableWorkspaceAccessPropertiesoptionalinterface{}#The device types and operating systems that can be used to access a WorkSpace.
workspaceCreationPropertiesoptionalIResolvable | CfnDirectory.DefaultWorkspaceCreationPropertiesPropertyworkspace_creation_propertiesoptionaltyping.Union[IResolvable, DefaultWorkspaceCreationPropertiesProperty]workspaceCreationPropertiesoptionalIResolvableWorkspaceCreationPropertiesoptionalIResolvableWorkspaceCreationPropertiesoptionalinterface{}#The default values that are used to create WorkSpaces.
workspaceDirectoryDescriptionoptionalstringworkspace_directory_descriptionoptionalstrworkspaceDirectoryDescriptionoptionalStringWorkspaceDirectoryDescriptionoptionalstringWorkspaceDirectoryDescriptionoptional*string#Description of the directory to register.
workspaceDirectoryNameoptionalstringworkspace_directory_nameoptionalstrworkspaceDirectoryNameoptionalStringWorkspaceDirectoryNameoptionalstringWorkspaceDirectoryNameoptional*string#The name of the directory to register.
workspaceTypeoptionalstringworkspace_typeoptionalstrworkspaceTypeoptionalStringWorkspaceTypeoptionalstringWorkspaceTypeoptional*string#Indicates whether the directory's WorkSpace type is personal or pools.