[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen

Create

Description

Creates a new Active Directory record in the admin service, belonging to the specified org. This does not create anything in AD itself.

Request

Request

URL

URL


post
https://cloud.vmwarehorizon.com/admin/v1/active-directories
Copy

Request Body

Request Body

ActiveDirectoryCreateTO of mimetype application/json Required

activeDirectory

{
    "defaultOU": "OU=Computers",
    "dnsDomainName": "example.com",
    "joinPassword": "secret",
    "joinUsername": "user",
    "netBIOSName": "EXAMPLE",
    "orgId": "0123456789",
    "primaryDNS": "127.0.0.1",
    "secondaryDNS": "127.0.0.2"
}
string
defaultOU Optional

Default OU (organizational unit) for adding VMs to the domain


string
dnsDomainName Optional

Directory DNS name


string
joinPassword Optional

Password for joining new VMs to the domain


string
joinUsername Optional

Username for joining new VMs to the domain


string
netBIOSName Optional

Directory NETBIOS name


string
orgId Optional

Org ID that owns this record


string
primaryDNS Optional

Primary DNS server


string
secondaryDNS Optional

Secondary DNS server

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

201 Created

Returns ActiveDirectoryTO of type */*

Successfully created active directory record

{
    "credentialId": "5fb352ed5b19360006d8fd93",
    "defaultOU": "OU=Computers",
    "dnsDomainName": "example.com",
    "id": "0123456789",
    "joinUsername": "user",
    "location": "US",
    "netBIOSName": "EXAMPLE",
    "orgId": "0123456789",
    "primaryDNS": "127.0.0.1",
    "secondaryDNS": "127.0.0.2"
}
string as date-time
createdAt Optional

Record creation timestamp


string
credentialId Optional

The credential ID to be used with the credential service


string
defaultOU Optional

Default OU (organizational unit) for adding VMs to the domain


string
dnsDomainName Optional

Directory DNS name


string
id Optional

Unique record ID


string
joinUsername Optional

Username for joining new VMs to the domain


string
location Optional

location


string
netBIOSName Optional

Directory NETBIOS name


string
orgId Optional

Org ID that owns this record


string
primaryDNS Optional

Primary DNS server


string
secondaryDNS Optional

Secondary DNS server


string as date-time
updatedAt Optional

Record update timestamp


integer as int64
version Optional

Record version (internal)

Errors

Errors

400

Bad Request


401

Unauthorized


403

Forbidden

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"defaultOU":"OU=Computers","dnsDomainName":"example.com","joinPassword":"secret","joinUsername":"user","netBIOSName":"EXAMPLE","orgId":"0123456789","primaryDNS":"127.0.0.1","secondaryDNS":"127.0.0.2"}' https://cloud.vmwarehorizon.com/admin/v1/active-directories
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-codegen-request-body-name: activeDirectory


[{"label":"Latest (V1)","version":"latest"}]
horizon-cloud-nextgen
Feedback

Was this page helpful?