Changes the hostname of a cloud desktop.

Description

You can only change the hostname of a Windows cloud desktop in the workspace of the enterprise Active Directory (AD) account type. After the hostname is changed, the cloud desktop is recreated.

Debugging

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 ModifyDesktopHostName

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

DesktopId String Yes ecd-gx2x1dhsmucyy****

The ID of the cloud desktop.

NewHostName String Yes NewName

The new hostname of the cloud desktop. The hostname must meet the following requirements:

  • Must be 2 to 15 characters in length.
  • Contain letters, digits, and hyphens (-). It cannot start or end with a hyphen (-), contain consecutive hyphens (-), or contain only digits.
RegionId String Yes cn-hangzhou

The ID of the region.

Response parameters

Parameter Type Example Description
RequestId String 3EB7FCEE-D731-4948-85A3-4B2C341CA983

The ID of the request.

Examples

Sample requests

https://ecd.cn-hangzhou.aliyuncs.com/?Action=ModifyDesktopHostName
&DesktopId=ecd-gx2x1dhsmucyy****
&NewHostName=NewName
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<ModifyDesktopHostNameResponse>
      <RequestId>3EB7FCEE-D731-4948-85A3-4B2C341CA983</RequestId>
</ModifyDesktopHostNameResponse>

JSON format

{
    "RequestId":"3EB7FCEE-D731-4948-85A3-4B2C341CA983"
}