Menu
AWS Directory Service
API Reference

DirectoryDescription

Contains information about an AWS Directory Service directory.

Contents

AccessUrl

The access URL for the directory, such as http://<alias>.awsapps.com. If no alias has been created for the directory, <alias> is the directory identifier, such as d-XXXXXXXXXX.

Type: String

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

Required: No

Alias

The alias for the directory. If no alias has been created for the directory, the alias is the directory identifier, such as d-XXXXXXXXXX.

Type: String

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

Pattern: ^(?!d-)([\da-zA-Z]+)([-]*[\da-zA-Z])*

Required: No

ConnectSettings

A DirectoryConnectSettingsDescription object that contains additional information about an AD Connector directory. This member is only present if the directory is an AD Connector directory.

Type: DirectoryConnectSettingsDescription object

Required: No

Description

The textual description for the directory.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

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

Required: No

DesiredNumberOfDomainControllers

The desired number of domain controllers in the directory if the directory is Microsoft AD.

Type: Integer

Valid Range: Minimum value of 2.

Required: No

DirectoryId

The directory identifier.

Type: String

Pattern: ^d-[0-9a-f]{10}$

Required: No

DnsIpAddrs

The IP addresses of the DNS servers for the directory. For a Simple AD or Microsoft AD directory, these are the IP addresses of the Simple AD or Microsoft AD directory servers. For an AD Connector directory, these are the IP addresses of the DNS servers or domain controllers in the on-premises directory to which the AD Connector is connected.

Type: Array of strings

Pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$

Required: No

LaunchTime

Specifies when the directory was created.

Type: Timestamp

Required: No

Name

The fully-qualified name of the directory.

Type: String

Pattern: ^([a-zA-Z0-9]+[\\.-])+([a-zA-Z0-9])+$

Required: No

RadiusSettings

A RadiusSettings object that contains information about the RADIUS server configured for this directory.

Type: RadiusSettings object

Required: No

RadiusStatus

The status of the RADIUS MFA server connection.

Type: String

Valid Values: Creating | Completed | Failed

Required: No

ShortName

The short name of the directory.

Type: String

Pattern: ^[^\\/:*?\"\<\>|.]+[^\\/:*?\"<>|]*$

Required: No

Size

The directory size.

Type: String

Valid Values: Small | Large

Required: No

SsoEnabled

Indicates if single-sign on is enabled for the directory. For more information, see EnableSso and DisableSso.

Type: Boolean

Required: No

Stage

The current stage of the directory.

Type: String

Valid Values: Requested | Creating | Created | Active | Inoperable | Impaired | Restoring | RestoreFailed | Deleting | Deleted | Failed

Required: No

StageLastUpdatedDateTime

The date and time that the stage was last updated.

Type: Timestamp

Required: No

StageReason

Additional information about the directory stage.

Type: String

Required: No

Type

The directory size.

Type: String

Valid Values: SimpleAD | ADConnector | MicrosoftAD

Required: No

VpcSettings

A DirectoryVpcSettingsDescription object that contains additional information about a directory. This member is only present if the directory is a Simple AD or Managed AD directory.

Type: DirectoryVpcSettingsDescription object

Required: No

See Also

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

On this page: