调用RebuildDesktops重建云桌面。

接口说明

重建云桌面将使用桌面对应模板中的镜像来重新初始化系统盘,规格和数据盘不变。相关注意事项如下:

  • 待重建的云桌面的状态必须为已关机(Stopped)。
  • 不支持Windows和Linux镜像之间的跨操作系统重建。
  • 重建后,原系统盘中的数据将被清除。基于原桌面系统盘创建的系统盘快照将无法使用,系统将自动删除相关快照。
说明 请提前备份系统盘中需要保存的数据,重建后,数据将被清除且无法恢复。

调试

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

请求参数

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

系统规定参数。取值:RebuildDesktops。

DesktopId.N RepeatList ecd-gx2x1dhsmucyy****

云桌面ID。可设置一个或多个,N的取值范围:1~20。

RegionId String cn-hangzhou

地域ID。

返回数据

名称 类型 示例值 描述
RebuildResults Array of RebuildResult

重建结果的集合。

Code String IncorrectDesktopStatus

重建结果。返回success表示成功,否则将返回错误信息。

DesktopId String ecd-gx2x1dhsmucyy****

云桌面ID。

Message String The current status of the desktop does not support this operation.

错误信息。当code为success时,不返回该参数。

RequestId String 484256DA-D816-44D2-9D86-B6EE4D5BA78C

请求ID。

示例

请求示例

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

正常返回示例

XML格式

<RebuildDesktopsvResponse>
      <RebuildResults>
            <Message>The current status of the desktop does not support this operation.</Message>
            <DesktopId>ecd-gx2x1dhsmucyy****</DesktopId>
            <Code>IncorrectDesktopStatus</Code>
      </RebuildResults>
      <RequestId>484256DA-D816-44D2-9D86-B6EE4D5BA78C</RequestId>
</RebuildDesktopsvResponse>

JSON格式

{
	"RebuildResults": [{
		"Message": "The current status of the desktop does not support this operation.",
		"DesktopId": "ecd-gx2x1dhsmucyy****",
		"Code": "IncorrectDesktopStatus"
	}],
	"RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C"
}