查询快照列表

1. 接口描述

本接口（DescribeSnapshots）用于获取快照列表，可指定云盘，可用区或者云盘分类进行查询。

2. 请求参数

名称	类型	是否必需	描述
VolumeId	String	否	云盘ID，传入该参数可获取指定硬盘的所有快照，此时其他三个参数无效
VolumeCategory	String	否	硬盘分类，system（系统盘）或data（数据盘），传入该参数可获取指定类型的快照列表
SnapshotId	String	否	快照ID，传入该参数可获取指定快照的信息，此时其他三个参数无效
AvailabilityZone	String	否	可用区，传入该参数可获取指定可用区的快照信息
SnapshotName	String	否	快照名称，传入可进行快照名称的查询
PageNumber	Integer	否	页码，默认1，范围1-intMax
PageSize	Integer	否	每页大小，默认10，范围1-intMax

3. 返回参数

名称	类型	描述
RequestId	String	唯一请求ID，每次请求都会返回
Snapshots	List	快照相关信息列表，包括快照ID、快照名称、云盘ID、快照容量、创建时间、快照状态、云盘属性、云盘名称、云盘类型、快照进度、所属可用区、云盘状态、快照类型；若无信息则不返回

4. 示例

输入参数

http://ebs.api.ksyun.com/
?Action=DescribeSnapshots
&Version=2016-03-04
&VolumeCategory=data
&VolumeId=b01cbcb3-04dd-40c8-bfbb-dc990d54ee68

返回参数

 "RequestId": "6e2682a1-5968-42f5-80e5-284aae218df0",
 "Snapshots": [
        {
            "SnapshotId": "8f4fd840-3921-42f3-94c1-dafd84e33e46",
            "SnapshotName": "type_test",
            "VolumeId": "b01cbcb3-04dd-40c8-bfbb-dc990d54ee68",
            "Size": 10,
            "CreateTime": "2020-09-08 12:15:25",
            "SnapshotStatus": "available",
            "VolumeCategory": "data",
            "VolumeName": "ksc_ebs_20200908121229",
            "VolumeType": "SSD3.0",
            "Progress": "100%",
            "AvailabilityZone": "cn-shanghai-3a",
            "VolumeStatus": "available",
            "SnapshotType": "LocalSnapShot"
        },
        {
            "SnapshotId": "5205b47f-9d80-4434-adf4-f28acbba0b26",
            "SnapshotName": "type_test",
            "VolumeId": "b01cbcb3-04dd-40c8-bfbb-dc990d54ee68",
            "Size": 10,
            "CreateTime": "2020-09-08 12:14:30",
            "SnapshotStatus": "available",
            "VolumeCategory": "data",
            "VolumeName": "ksc_ebs_20200908121229",
            "VolumeType": "SSD3.0",
            "Progress": "100%",
            "AvailabilityZone": "cn-shanghai-3a",
            "VolumeStatus": "available",
            "SnapshotType": "CommonSnapShot"
        }
    ],
    "Page": {
        "totalCount": 2,
        "pageSize": 10,
        "currentPage": 1,
        "nextPage": 2,
        "previousPage": 0,
        "totalPageCount": 1,
        "hasNext": false,
        "hasPrevious": false,
        "pageStartRow": 1,
        "showPageNum": 5,
        "pageList": [
            1
        ],
        "pageEndRow": 2
    }