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

Patch By ID

Description

Patches an existing Active Directory. Supports partial document update by updating only the fields which are non-null.

Request

Request

URL

URL


patch
https://cloud.vmwarehorizon.com/admin/v2/active-directories/{id}
Copy

Path Parameters

Path Parameters

string
id Required

id


Query Parameters

Query Parameters

string
org_id Optional

Organization ID: non-super users can only access their own organization


Request Body

Request Body

ActiveDirectoryPatchTO of mimetype application/json Required

patchActiveDirectory

{
    "defaultOU": "OU=Computers",
    "description": "This is a test AD",
    "name": "TestAD"
}
bindAccounts Optional

string
defaultOU Optional

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


string
description Optional

Description for the AD


enrollmentServiceAccounts Optional

joinAccounts Optional

string
name Optional

Name that helps the customer identify the record

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns ActiveDirectoryTO of type */*

Successfully updated existing active directory record

{
    "credentialId": "5fb352ed5b19360006d8fd93",
    "defaultOU": "OU=Computers",
    "description": "This is a test AD",
    "dnsDomainName": "example.com",
    "id": "0123456789",
    "location": "US",
    "name": "TestAD",
    "orgId": "0123456789"
}
bindAccounts Optional

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
description Optional

Description for the AD


string
dnsDomainName Optional

Directory DNS name


enrollmentServicesAccounts Optional

string
id Optional

Unique record ID


joinAccounts Optional

string
location Optional

location


string
name Optional

Name that helps the customer identify the record


string
orgId Optional

Org ID that owns this record


string as date-time
updatedAt Optional

Record update timestamp


integer as int64
version Optional

Record version (internal)


204 No Content

No Content

Errors

Errors

ErrorResponse
400

Bad Request


ErrorResponse
401

Unauthorized


ErrorResponse
403

Forbidden


ErrorResponse
404

Not Found


ErrorResponse
409

Conflict - concurrent updates


ErrorResponse
500

Internal Server Error

Code Samples

Code Samples

cURL Command

curl -X PATCH -H "Content-Type: application/json" -d '{"defaultOU":"OU=Computers","description":"This is a test AD","name":"TestAD"}' https://cloud.vmwarehorizon.com/admin/v2/active-directories/{id}
Vendor Extensions

Vendor Extensions

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


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

Was this page helpful?