调用ModifyDesktopHostName修改云桌面的主机名称。

接口说明

仅支持修改AD工作区下，操作系统是Windows的云桌面主机名称。修改主机名称后，云桌面将进行重建。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyDesktopHostName

系统规定参数。取值：ModifyDesktopHostName。
DesktopId String 是 ecd-gx2x1dhsmucyy****

云桌面ID。
NewHostName String 是 NewName

修改后的云桌面主机名称。 主机名称的命名规则如下：

  • 长度为2~15个字符。
  • 支持大小写字母、数字或者短划线（-）。不能以短划线开头或者结尾，不能连续使用短划线，不能只使用数字。
RegionId String 是 cn-hangzhou

地域ID。

返回数据

名称 类型 示例值 描述
RequestId String 3EB7FCEE-D731-4948-85A3-4B2C341CA983

请求ID。

示例

请求示例

https://ecd.cn-hangzhou.aliyuncs.com/?Action=ModifyDesktopHostName
&DesktopId=ecd-gx2x1dhsmucyy****
&NewHostName=NewName
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

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

JSON格式 

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