All Products
Search
Document Center

WUYING Workspace:ModifyDesktopHostName

Last Updated:Apr 08, 2024

Modifies the hostname of a Windows cloud computer in the Active Directory (AD) office network.

Operation description

The Windows cloud computer whose hostname you want to modify must be in an AD office network. After the hostname is modified, the cloud computer is re-created.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
NewHostNamestringYes

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

  • The hostname must be 2 to 15 characters in length.
  • The hostname can contain only letters, digits, and hyphens (-). The hostname cannot start or end with a hyphen (-), contain consecutive hyphens (-), or contain only digits.
NewName
DesktopIdstringYes

The ID of the cloud computer.

ecd-gx2x1dhsmucyy****

Response parameters

ParameterTypeDescriptionExample
object

Schema of response.

RequestIdstring

The request ID.

1CBAFFAB-B697-4049-A9B1-67E1FC5F****

Examples

Sample success responses

JSONformat

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history