查询云硬盘快照信息

更新时间:2017-09-07 03:38:04

描述

查询云硬盘快照信息,可查询一条或多条记录,可根据名称等多个查询条件查询

请求参数

参数名 参数类型 是否必填 参数说明
Action String

操作方法

Region String

机房标识,取值参见地域列表

VolumeId String

云硬盘ID

Id.N String

云硬盘快照ID,支持批量,N为自然数,格式:&Id.0=xxx&Id.1=xxx等

Name String

名称

StartTime String

创建开始时间 格式yyyy-MM-dd HH:mm:ss

EndTime String

创建结束时间 格式yyyy-MM-dd HH:mm:ss

Offset String

记录偏移量,不指定取 0

Count String

记录数量,不指定为全部

IsSystem String

根据系统类型查询,取值范围:

  • true-查询系统盘快照
  • false-查询数据盘快照(默认值)

返回参数

名称 类型 说明
Action String 执行的操作
TaskId String 请求标识
TotalCount Integer 过滤条件下总共记录数
SnapshotSet SnapshotItemType 由SnapshotItemType组成的数组格式,返回云硬盘快照信息

SnapshotItemType节点

云硬盘快照信息的数据类型

名称 类型 说明
Id String 快照标识
Name String 名称
Description String 描述信息
OwnerId String 快照所有者
Process String 快照的进度
Locked Boolean 快照是否锁定,true-锁定,false-未锁定
StartTime DateTime 开始时间
Status String 快照状态:CREATING,AVAILABLE,DELETING,ERROR,`ERROR_DELETING
VolumeId String 卷标识
Size Integer 快照大小,这里返回的大小单位为KB
IsFileLock String 是否是归档类型的快照

请求示例

https://api.chinac.com/?Action=LockSnapshotStatus
&Id=vs-xxx
&VolumeId=true
&公共参数

返回示例

{
    "TaskId":"l2c9i20170509175400941",
    "Action":"DescribeSnapshots",
    "TotalCount":1,
    "SnapshotSet":[{"Id":"vs-4e9ih44jti40a",
                    "Name":"333",
                    "Description":"3333",
                    "OwnerId":"1890420",
                    "Process":"",
                    "StartTime":"2017-05-04T19:29:54 +0800",
                    "Status":"AVAILABLE",
                    "VolumeId":"v-lj9ih44ao882y",
                    "Size":1,
                    "Locked":false,
                    "IsFileLock":false
}
*
*