帮助文档 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
帮助文档 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 无影云电脑企业版
  4. 开发参考
  5. API参考(客户端)
  6. API目录
  7. 云资源管理
  8. DescribeSnapshots - 查询云电脑快照信息

DescribeSnapshots - 查询云电脑快照信息

  • 云资源管理
  • 发布于 2025-04-17
  • 0 次阅读
文档编辑
文档编辑

查询一台云电脑的快照列表和快照详细信息。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring是

地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。

cn-hangzhou
DesktopIdstring否

云电脑 ID。

ecd-gx2x1dhsmucyy****
SnapshotIdstring否

快照 ID。

s-2ze81owrnv9pity4****
MaxResultsinteger否

分页查询时,每页最大行数。默认值:100。

10
NextTokenstring否

下一个查询开始的 Token,NextToken 为空表示没有下一个。

AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****
ClientIdstring是

客户端生成的唯一 ID。

16dad2b6-3c6d-4e4c-b057-78ecb13c****
SessionIdstring是

会话 ID。

a99b9aca-bac5-4da2-819e-400ce98f****
LoginTokenstring是

登录凭证。

v16abfb945208fc5745061668654680853da4a25202d1a394fcad57bba484e9827ad43ea7d10fb6bf13d44a4adc0e9****

返回参数

名称类型描述示例值
object
NextTokenstring

下一个查询开始的 Token,NextToken 为空表示没有下一个。

AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****
RequestIdstring

请求 ID。

51592A88-0F2C-55E6-AD2C-2AD9C10D****
Snapshotsarray<object>

快照信息集合。

Snapshotobject
CreationTimestring

快照创建时间。按照 ISO8601 标准表示,并使用 UTC +0 时间,格式为yyyy-MM-ddTHH:mm:ssZ。

2020-12-20T14:52:28Z
Statusstring

快照状态。

枚举值:
  • PROGRESSING:创建中。
  • FAILED:创建失败。
  • ACCOMPLISHED:完成创建。
ACCOMPLISHED
SnapshotTypestring

快照创建类型。

枚举值:
  • AUTO:自动创建快照。
  • USER:手动创建快照。
USER
SnapshotNamestring

快照名称。

testSnapshotName
Progressstring

创建云电脑时的进度。

100%
Descriptionstring

快照描述信息。

testDescription
SnapshotIdstring

快照 ID。

s-2zeipxmnhej803x7****
RemainTimeinteger

正在创建的快照剩余完成时间。单位:秒。

30
SourceDiskSizestring

源磁盘容量。单位:GiB。

150
SourceDiskTypestring

源磁盘类型。

枚举值:
  • SYSTEM:系统盘。
  • DATA:数据盘。
SYSTEM
DesktopIdstring

快照所属的云电脑 ID。

ecd-g03l3tlm8djoj****
RestorePointIdstring

还原点 ID。

rp-btgmaa20wkcju****
RestorePointNamestring

还原点名称。

数据盘备份

示例

正常返回示例

JSON格式

{
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****",
  "RequestId": "51592A88-0F2C-55E6-AD2C-2AD9C10D****",
  "Snapshots": [
    {
      "CreationTime": "2020-12-20T14:52:28Z",
      "Status": "ACCOMPLISHED",
      "SnapshotType": "USER",
      "SnapshotName": "testSnapshotName",
      "Progress": "100%",
      "Description": "testDescription",
      "SnapshotId": "s-2zeipxmnhej803x7****",
      "RemainTime": 30,
      "SourceDiskSize": "150",
      "SourceDiskType": "SYSTEM",
      "DesktopId": "ecd-g03l3tlm8djoj****",
      "RestorePointId": "rp-btgmaa20wkcju****",
      "RestorePointName": "数据盘备份"
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2025-01-15OpenAPI 返回结构发生变更查看变更详情
相关文章

DescribeRegions - 查看可选的地域和可用区 2025-04-17 11:20

DescribeDirectories - 查询目录详细信息 2025-04-17 11:20

查询目录详细信息。

DescribeOfficeSites - 查询办公网络详细信息 2025-04-17 11:20

查询办公网络的详细信息。

DescribeGlobalDesktops - 查询全地域云电脑详细信息 2025-04-17 11:20

查询多个地域的云电脑详细信息。目前仅支持中国内地对应的地域查询(不包含南京本地地域)。

DescribeUserResources - 查询用户拥有的无影云资源列表 2025-04-17 11:20

查询用户资源列表。 接口说明

UnbindUserDesktop - 将用户与云电脑解绑 2025-04-17 11:20

将用户与云电脑解绑。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 博智数字服务平台.
闽ICP备08105208号-1