调用CreateSnapshot为云桌面的磁盘创建一份快照。

接口说明

云桌面的状态必须为运行中已停止

调试

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

请求参数

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

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

DesktopId String ecd-gx2x1dhsmucyy****"

云桌面ID。

RegionId String cn-hangzhou

地域ID。

SnapshotName String testSnapshotName

快照的名称。长度为2~128个英文或中文字符。

为防止和自动创建的快照的名称冲突,不能以auto开头。

SourceDiskType String system

要创建快照的磁盘类型。取值范围:

  • system:系统盘。
  • data:数据盘。
Description String testDescription

快照描述。长度不能超过128个英文或中文字符。

返回数据

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

请求ID。

SnapshotId String s-2ze81owrnv9pity4****

快照ID。

示例

请求示例

https://ecd.cn-hangzhou.aliyuncs.com/?Action=CreateSnapshot
&Description=testDescription
&DesktopId=ecd-gx2x1dhsmucyy****"
&RegionId=cn-hangzhou
&SnapshotName=testSnapshotName
&SourceDiskType=system
&<公共请求参数>

正常返回示例

XML 格式

<CreateSnapshotResponse>
      <SnapshotId>s-2ze81owrnv9pity4****</SnapshotId>
      <RequestId>3EB7FCEE-D731-4948-85A3-4B2C341CA983</RequestId>
</CreateSnapshotResponse>

JSON 格式

{
	"SnapshotId": "s-2ze81owrnv9pity4****",
	"RequestId": "3EB7FCEE-D731-4948-85A3-4B2C341CA983"
}

错误码

访问错误中心查看更多错误码。