REST Resource: projects.locations.activedirectories

Resource: ActiveDirectory

ActiveDirectory is the public representation of the active directory config.

JSON representation
{
  "name": string,
  "createTime": string,
  "state": enum (State),
  "domain": string,
  "site": string,
  "dns": string,
  "netBios": string,
  "organizationalUnit": string,
  "aesEncryption": boolean,
  "username": string,
  "password": string,
  "backupOperators": [
    string
  ],
  "securityOperators": [
    string
  ],
  "kdcHostname": string,
  "kdcIp": string,
  "nfsUsersWithLdap": boolean,
  "description": string,
  "ldapSigning": boolean,
  "encryptDcConnections": boolean,
  "labels": {
    string: string,
    ...
  },
  "stateDetails": string
}
Fields
name

string

Output only. The resource name of the active directory. Format: projects/{project_number}/locations/{locationId}/activedirectories/{activeDirectoryId}.

createTime

string (Timestamp format)

Output only. Create time of the active directory.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Output only. The state of the AD.

domain

string

Required. Name of the Active Directory domain

site

string

The Active Directory site the service will limit Domain Controller discovery too.

dns

string

Required. Comma separated list of DNS server IP addresses for the Active Directory domain.

netBios

string

Required. NetBIOS name of the server.

organizationalUnit

string

The Organizational Unit (OU) within the Windows Active Directory the user belongs to.

aesEncryption

boolean

If enabled, AES encryption will be enabled for SMB communication.

username

string

Required. Username of the Active Directory domain administrator.

password

string

Required. Password of the Active Directory domain administrator.

backupOperators[]

string

Users to be added to the Built-in Backup Operator active directory group.

securityOperators[]

string

Domain users to be given the SeSecurityPrivilege.

kdcHostname

string

Name of the active directory machine. (ad_name on SDE)

kdcIp

string

KDC server IP address for the active directory machine.

nfsUsersWithLdap

boolean

If enabled, will allow access to local users and LDAP users. If access is needed for only LDAP users, it has to be disabled.

description

string

Description of the active directory.

ldapSigning

boolean

Specifies whether or not the LDAP traffic needs to be signed.

encryptDcConnections

boolean

If enabled, traffic between the SMB server to Domain Controller (DC) will be encrypted.

labels

map (key: string, value: string)

Labels for the active directory.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

stateDetails

string

The state details of the AD.

State

The Active Directory States

Enums
STATE_UNSPECIFIED Unspecified state
CREATING Creating
READY Ready
UPDATING Updating
IN_USE In use
DELETING Deleting
ERROR Error

Methods

create

CreateActiveDirectory Creates the active directory specified in the request.

delete

DeleteActiveDirectory Delete the active directory specified in the request.

get

DescribeActiveDirectory Describes a specified active directory.

list

ListActiveDirectories Lists active directories.

patch

UpdateActiveDirectory Update the parameters of an active directories.