You can call this operation to modify an AD directory.


This operation modifies only the domain name and DNS parameters of AD directories in the Error (ERROR) or Registering (REGISTERING) state. DNS parameters include DomainName, SubDomainName, DnsAddress.N, and SubDomainDnsAddress.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyADConnectorDirectory

The operation that you want to perform. Set the value to ModifyADConnectorDirectory.

DirectoryId String Yes cn-hangzhou+dir-gx2x1dhsmu52rd****

The ID of the directory.

RegionId String Yes cn-hangzhou

The region ID of the directory.

DomainName String No

The domain name. The domain name must be 2 to 255 characters in length and consist of two parts. Example: Each domain name can be registered only once.

DomainUserName String No sAMAccountName

The username of the domain administrator. The username must be 1 to 64 characters in length.

DomainPassword String No testPassword

The password of the domain administrator. The password must be 1 to 64 characters in length.

DnsAddress.N RepeatList No 127.0.**.**

The IP address of the DNS server of the enterprise AD system. You can specify only one IP address. Make sure that the specified IP address is accessible in the network of the selected vSwitch.

DirectoryName String No testDirectoryName

The name of the directory.

SubDomainDnsAddress.N RepeatList No 127.0.**.**

The DNS address of the enterprise AD subdomain. If you specify SubDomainName but not this parameter, the DNS address of the subdomain is considered to be the same as that of the parent domain.

SubDomainName String No

The domain name of the enterprise AD subdomain.

MfaEnabled Boolean No false

Specifies whether to enable Multi-Factor Authentication (MFA). Default value: false.

If you set this parameter to true to enable MFA, all AD users in this AD directory must enter the password and the dynamic verification code generated by the MFA device when they log on to a cloud desktop.

Note When you log on to a cloud desktop for the first time, you must bind the MFA device.

Response parameters

Parameter Type Example Description
RequestId String 3FE99D5E-93A1-493F-B1CB-0ABD4D05BEFF

The ID of the request.


Sample requests
&<Common request parameters>

Sample success responses

XML format


JSON format


Error codes

For a list of error codes, visit the API Error Center.