Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . workspaces ]

describe-workspace-directories

Description

Describes the available AWS Directory Service directories that are registered with Amazon WorkSpaces.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

describe-workspace-directories is a paginated operation. Multiple API calls may be issued in order to retrieve the entire data set of results. You can disable pagination by providing the --no-paginate argument. When using --output text and the --query argument on a paginated response, the --query argument must extract data from the results of the following query expressions: Directories

Synopsis

  describe-workspace-directories
[--directory-ids <value>]
[--cli-input-json <value>]
[--starting-token <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]

Options

--directory-ids (list)

The identifiers of the directories. If the value is null, all directories are retrieved.

Syntax:

"string" "string" ...

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--starting-token (string)

A token to specify where to start paginating. This is the NextToken from a previously truncated response.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--max-items (integer)

The total number of items to return in the command's output. If the total number of items available is more than the value specified, a NextToken is provided in the command's output. To resume pagination, provide the NextToken value in the starting-token argument of a subsequent command. Do not use the NextToken response element directly outside of the AWS CLI.

For usage examples, see Pagination in the AWS Command Line Interface User Guide .

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Examples

To describe your WorkSpace directories

This example describes all of your WorkSpace directories.

Command:

aws workspaces describe-workspace-directories

Output:

{
  "Directories" : [
    {
      "CustomerUserName" : "Administrator",
      "DirectoryId" : "d-906735683d",
      "DirectoryName" : "example.awsapps.com",
      "SubnetIds" : [
        "subnet-af0e2a87",
        "subnet-657e7a23"
      ],
      "WorkspaceCreationProperties" :
      {
        "EnableInternetAccess" : false,
        "EnableWorkDocs" : false,
        "UserEnabledAsLocalAdministrator" : true
      },
      "Alias" : "example",
      "State" : "REGISTERED",
      "DirectoryType" : "SIMPLE_AD",
      "RegistrationCode" : "SLiad+S393HD",
      "IamRoleId" : "arn:aws:iam::972506530580:role/workspaces_DefaultRole",
      "DnsIpAddresses" : [
        "10.0.2.190",
        "10.0.1.202"
      ],
      "WorkspaceSecurityGroupId" : "sg-6e40640b"
    },
    {
      "CustomerUserName" : "Administrator",
      "DirectoryId" : "d-906732325d",
      "DirectoryName" : "exampledomain.com",
      "SubnetIds" : [
        "subnet-775a6531",
        "subnet-435c036b"
      ],
      "WorkspaceCreationProperties" :
      {
        "EnableInternetAccess" : false,
        "EnableWorkDocs" : true,
        "UserEnabledAsLocalAdministrator" : true
      },
      "Alias" : "example-domain",
      "State" : "REGISTERED",
      "DirectoryType" : "AD_CONNECTOR",
      "RegistrationCode" : "SLiad+UBZGNH",
      "IamRoleId" : "arn:aws:iam::972506530580:role/workspaces_DefaultRole",
      "DnsIpAddresses" : [
        "50.0.2.223",
        "50.0.2.184"
      ]
    }
  ]
}

Output

Directories -> (list)

Information about the directories.

(structure)

Contains information about an AWS Directory Service directory for use with Amazon WorkSpaces.

DirectoryId -> (string)

The directory identifier.

Alias -> (string)

The directory alias.

DirectoryName -> (string)

The name of the directory.

RegistrationCode -> (string)

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

SubnetIds -> (list)

The identifiers of the subnets used with the directory.

(string)

DnsIpAddresses -> (list)

The IP addresses of the DNS servers for the directory.

(string)

CustomerUserName -> (string)

The user name for the service account.

IamRoleId -> (string)

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.

DirectoryType -> (string)

The directory type.

WorkspaceSecurityGroupId -> (string)

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

State -> (string)

The state of the directory's registration with Amazon WorkSpaces

WorkspaceCreationProperties -> (structure)

The default creation properties for all WorkSpaces in the directory.

EnableWorkDocs -> (boolean)

Indicates whether the directory is enabled for Amazon WorkDocs.

EnableInternetAccess -> (boolean)

The public IP address to attach to all WorkSpaces that are created or rebuilt.

DefaultOu -> (string)

The organizational unit (OU) in the directory for the WorkSpace machine accounts.

CustomSecurityGroupId -> (string)

The identifier of any security groups to apply to WorkSpaces when they are created.

UserEnabledAsLocalAdministrator -> (boolean)

Indicates whether the WorkSpace user is an administrator on the WorkSpace.

NextToken -> (string)

The token to use to retrieve the next set of results, or null if there are no more results available. This token is valid for one day and must be used within that time frame.