Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1467365253.0 KB

Obtains information about the directories that belong to this account.

You can retrieve information about specific directories by passing the directory identifiers in the DirectoryIds parameter. Otherwise, all directories that belong to the current account are returned.

This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the DescribeDirectoriesResult.NextToken member contains a token that you pass in the next call to DescribeDirectories to retrieve the next set of items.

You can also specify a maximum number of return results with the Limit parameter.

post/#X-Amz-Target=DirectoryService_20150416.DescribeDirectories

Query parameters

Limitstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'DirectoryService_20150416.DescribeDirectories' required

Request body

DirectoryIdsDirectoryId[]
<p>A list of identifiers of the directories for which to obtain the information. If this member is null, all directories that belong to the current account are returned.</p> <p>An empty list results in an <code>InvalidParameterException</code> being thrown.</p>
NextTokenstring

The <code>DescribeDirectoriesResult.NextToken</code> value from a previous call to <a>DescribeDirectories</a>. Pass null if this is the first call.

Limitinteger

The maximum number of items to return. If this value is zero, the maximum number of items is specified by the limitations of the operation.

Response

Success

NextTokenstring

If not null, more results are available. Pass this value for the <code>NextToken</code> parameter in a subsequent call to <a>DescribeDirectories</a> to retrieve the next set of items.