---
title: Getting Started with Datadog
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog
---

# aws_ds_directory{% #aws_ds_directory %}

## `access_url`{% #access_url %}

**Type**: `STRING`**Provider name**: `AccessUrl`**Description**: 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`.

## `account_id`{% #account_id %}

**Type**: `STRING`

## `alias`{% #alias %}

**Type**: `STRING`**Provider name**: `Alias`**Description**: The alias for the directory. If no alias has been created for the directory, the alias is the directory identifier, such as `d-XXXXXXXXXX`.

## `connect_settings`{% #connect_settings %}

**Type**: `STRUCT`**Provider name**: `ConnectSettings`**Description**: 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.

- `availability_zones`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `AvailabilityZones`**Description**: A list of the Availability Zones that the directory is in.
- `connect_ips`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `ConnectIps`**Description**: The IP addresses of the AD Connector servers.
- `customer_user_name`**Type**: `STRING`**Provider name**: `CustomerUserName`**Description**: The user name of the service account in your self-managed directory.
- `security_group_id`**Type**: `STRING`**Provider name**: `SecurityGroupId`**Description**: The security group identifier for the AD Connector directory.
- `subnet_ids`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `SubnetIds`**Description**: A list of subnet identifiers in the VPC that the AD Connector is in.
- `vpc_id`**Type**: `STRING`**Provider name**: `VpcId`**Description**: The identifier of the VPC that the AD Connector is in.

## `description`{% #description %}

**Type**: `STRING`**Provider name**: `Description`**Description**: The description for the directory.

## `desired_number_of_domain_controllers`{% #desired_number_of_domain_controllers %}

**Type**: `INT32`**Provider name**: `DesiredNumberOfDomainControllers`**Description**: The desired number of domain controllers in the directory if the directory is Microsoft AD.

## `directory_id`{% #directory_id %}

**Type**: `STRING`**Provider name**: `DirectoryId`**Description**: The directory identifier.

## `dns_ip_addrs`{% #dns_ip_addrs %}

**Type**: `UNORDERED_LIST_STRING`**Provider name**: `DnsIpAddrs`**Description**: 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 your self-managed directory to which the AD Connector is connected.

## `edition`{% #edition %}

**Type**: `STRING`**Provider name**: `Edition`**Description**: The edition associated with this directory.

## `launch_time`{% #launch_time %}

**Type**: `TIMESTAMP`**Provider name**: `LaunchTime`**Description**: Specifies when the directory was created.

## `name`{% #name %}

**Type**: `STRING`**Provider name**: `Name`**Description**: The fully qualified name of the directory.

## `os_version`{% #os_version %}

**Type**: `STRING`**Provider name**: `OsVersion`**Description**: The operating system (OS) version of the directory.

## `owner_directory_description`{% #owner_directory_description %}

**Type**: `STRUCT`**Provider name**: `OwnerDirectoryDescription`**Description**: Describes the Managed Microsoft AD directory in the directory owner account.

- `account_id`**Type**: `STRING`**Provider name**: `AccountId`**Description**: Identifier of the directory owner account.
- `directory_id`**Type**: `STRING`**Provider name**: `DirectoryId`**Description**: Identifier of the Managed Microsoft AD directory in the directory owner account.
- `dns_ip_addrs`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `DnsIpAddrs`**Description**: IP address of the directory's domain controllers.
- `radius_settings`**Type**: `STRUCT`**Provider name**: `RadiusSettings`**Description**: A RadiusSettings object that contains information about the RADIUS server.
  - `authentication_protocol`**Type**: `STRING`**Provider name**: `AuthenticationProtocol`**Description**: The protocol specified for your RADIUS endpoints.
  - `display_label`**Type**: `STRING`**Provider name**: `DisplayLabel`**Description**: Not currently used.
  - `radius_port`**Type**: `INT32`**Provider name**: `RadiusPort`**Description**: The port that your RADIUS server is using for communications. Your self-managed network must allow inbound traffic over this port from the Directory Service servers.
  - `radius_retries`**Type**: `INT32`**Provider name**: `RadiusRetries`**Description**: The maximum number of times that communication with the RADIUS server is retried after the initial attempt.
  - `radius_servers`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `RadiusServers`**Description**: An array of strings that contains the fully qualified domain name (FQDN) or IP addresses of the RADIUS server endpoints, or the FQDN or IP addresses of your RADIUS server load balancer.
  - `radius_timeout`**Type**: `INT32`**Provider name**: `RadiusTimeout`**Description**: The amount of time, in seconds, to wait for the RADIUS server to respond.
  - `shared_secret`**Type**: `STRING`**Provider name**: `SharedSecret`**Description**: Required for enabling RADIUS on the directory.
  - `use_same_username`**Type**: `BOOLEAN`**Provider name**: `UseSameUsername`**Description**: Not currently used.
- `radius_status`**Type**: `STRING`**Provider name**: `RadiusStatus`**Description**: Information about the status of the RADIUS server.
- `vpc_settings`**Type**: `STRUCT`**Provider name**: `VpcSettings`**Description**: Information about the VPC settings for the directory.
  - `availability_zones`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `AvailabilityZones`**Description**: The list of Availability Zones that the directory is in.
  - `security_group_id`**Type**: `STRING`**Provider name**: `SecurityGroupId`**Description**: The domain controller security group identifier for the directory.
  - `subnet_ids`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `SubnetIds`**Description**: The identifiers of the subnets for the directory servers.
  - `vpc_id`**Type**: `STRING`**Provider name**: `VpcId`**Description**: The identifier of the VPC that the directory is in.

## `radius_settings`{% #radius_settings %}

**Type**: `STRUCT`**Provider name**: `RadiusSettings`**Description**: A RadiusSettings object that contains information about the RADIUS server configured for this directory.

- `authentication_protocol`**Type**: `STRING`**Provider name**: `AuthenticationProtocol`**Description**: The protocol specified for your RADIUS endpoints.
- `display_label`**Type**: `STRING`**Provider name**: `DisplayLabel`**Description**: Not currently used.
- `radius_port`**Type**: `INT32`**Provider name**: `RadiusPort`**Description**: The port that your RADIUS server is using for communications. Your self-managed network must allow inbound traffic over this port from the Directory Service servers.
- `radius_retries`**Type**: `INT32`**Provider name**: `RadiusRetries`**Description**: The maximum number of times that communication with the RADIUS server is retried after the initial attempt.
- `radius_servers`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `RadiusServers`**Description**: An array of strings that contains the fully qualified domain name (FQDN) or IP addresses of the RADIUS server endpoints, or the FQDN or IP addresses of your RADIUS server load balancer.
- `radius_timeout`**Type**: `INT32`**Provider name**: `RadiusTimeout`**Description**: The amount of time, in seconds, to wait for the RADIUS server to respond.
- `shared_secret`**Type**: `STRING`**Provider name**: `SharedSecret`**Description**: Required for enabling RADIUS on the directory.
- `use_same_username`**Type**: `BOOLEAN`**Provider name**: `UseSameUsername`**Description**: Not currently used.

## `radius_status`{% #radius_status %}

**Type**: `STRING`**Provider name**: `RadiusStatus`**Description**: The status of the RADIUS MFA server connection.

## `regions_info`{% #regions_info %}

**Type**: `STRUCT`**Provider name**: `RegionsInfo`**Description**: Lists the Regions where the directory has replicated.

- `additional_regions`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `AdditionalRegions`**Description**: Lists the Regions where the directory has been replicated, excluding the primary Region.
- `primary_region`**Type**: `STRING`**Provider name**: `PrimaryRegion`**Description**: The Region where the Managed Microsoft AD directory was originally created.

## `share_method`{% #share_method %}

**Type**: `STRING`**Provider name**: `ShareMethod`**Description**: The method used when sharing a directory to determine whether the directory should be shared within your Amazon Web Services organization (`ORGANIZATIONS`) or with any Amazon Web Services account by sending a shared directory request (`HANDSHAKE`).

## `share_notes`{% #share_notes %}

**Type**: `STRING`**Provider name**: `ShareNotes`**Description**: A directory share request that is sent by the directory owner to the directory consumer. The request includes a typed message to help the directory consumer administrator determine whether to approve or reject the share invitation.

## `share_status`{% #share_status %}

**Type**: `STRING`**Provider name**: `ShareStatus`**Description**: Current directory status of the shared Managed Microsoft AD directory.

## `short_name`{% #short_name %}

**Type**: `STRING`**Provider name**: `ShortName`**Description**: The short name of the directory.

## `size`{% #size %}

**Type**: `STRING`**Provider name**: `Size`**Description**: The directory size.

## `sso_enabled`{% #sso_enabled %}

**Type**: `BOOLEAN`**Provider name**: `SsoEnabled`**Description**: Indicates if single sign-on is enabled for the directory. For more information, see EnableSso and DisableSso.

## `stage`{% #stage %}

**Type**: `STRING`**Provider name**: `Stage`**Description**: The current stage of the directory.

## `stage_last_updated_date_time`{% #stage_last_updated_date_time %}

**Type**: `TIMESTAMP`**Provider name**: `StageLastUpdatedDateTime`**Description**: The date and time that the stage was last updated.

## `stage_reason`{% #stage_reason %}

**Type**: `STRING`**Provider name**: `StageReason`**Description**: Additional information about the directory stage.

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `type`{% #type %}

**Type**: `STRING`**Provider name**: `Type`**Description**: The directory type.

## `vpc_settings`{% #vpc_settings %}

**Type**: `STRUCT`**Provider name**: `VpcSettings`**Description**: A DirectoryVpcSettingsDescription object that contains additional information about a directory. This member is only present if the directory is a Simple AD or Managed Microsoft AD directory.

- `availability_zones`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `AvailabilityZones`**Description**: The list of Availability Zones that the directory is in.
- `security_group_id`**Type**: `STRING`**Provider name**: `SecurityGroupId`**Description**: The domain controller security group identifier for the directory.
- `subnet_ids`**Type**: `UNORDERED_LIST_STRING`**Provider name**: `SubnetIds`**Description**: The identifiers of the subnets for the directory servers.
- `vpc_id`**Type**: `STRING`**Provider name**: `VpcId`**Description**: The identifier of the VPC that the directory is in.