星界链-云计算服务专家_云主机解决方案提供商

描述

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

请求参数

参数名	参数类型	是否必填	参数说明
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/v2/?Action=DescribeSnapshots
&Id=vs-xxx
&VolumeId=true
&公共参数

返回示例

{
    "code": 10000,
    "message": "",
    "data": {
        "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
        }]
    }
}