备案 控制台 登录 注册
文档中心 > DescribeSnapshots
DescribeSnapshots

最近更新时间：2021-11-19

请求方法：GET

接口描述：使用DescribeSnapshots查看快照列表。


请求参数

名称

类型

是否必须

描述

Action

String

是

要执行的操作。取值DescribeSnapshots

RegionId

String

是

快照所在的地域。

  • HB1-BJMY （华北2-北京2）

  • HD1-SHMY（华东1-上海）

Page

int

否

页码。不传默认为1

Size

int

否

每页个数。不传默认为10

DiskId

String

否

硬盘ID。

SnapshotName

String

否

快照名称。

Status

String

否

快照状态。

Version

String

是

版本号。取值2


返回参数

名称

类型

描述

RequestId

String

请求ID。

snapshots

List

快照列表

+creationTime

String

创建时间

+snapshotId

String

快照ID

+description

String

快照描述

+snapshotName

String

快照名称

+sourceDiskId

String

源盘ID

+sourceDiskSize

String

源盘大小

+sourceDiskType

String

源盘类型

+sourceDiskName

String

源盘名称

+status

String

快照状态

+expireAt

String

过期时间

+snapshotType

int

快照类型

  • 0：手动快照

  • 1：定时快照

+userId

String

用户ID

+sourceDiskInstanceCode

String

源盘规格编码

pageNumber

int

当前页码

totalCount

int

快照总数

pageSize

int

每页个数


示例

请求示例

https://api.unicloud.com/ebs?&Action=DescribeSnapshots

&RegionId=cn-beijing

&Version=2

&公共请求参数


返回示例

JSON格式

{

 " snapshots ": [

        {

            "sourceDiskId": "ebs-jndvzmncvrfr",

            "snapshotId": "dds-jn6dfvxlirhi",

            "sourceDiskInstanceCode": "ebs.highIO.ssd",

            "creationTime": "2020-03-05 09:58:44",

            "snapshotType": 0,

            "sourceDiskName": "EBS022610231",

            "description": "",

            "expireAt": "",

            "userId": "00211f11-43f2-4925-b5fc-a9000a07730c",

            "sourceDiskType": "data",

            "snapshotName": "www",

            "sourceDiskSize": "20",

            "status": "Available",

        },

    ],

    "pageNumber": 1,

    "pageSize": 10,

    "totalCount": 1,

    "RequestId": "b9de1a62-d09e-4d34-9a61-38f0f56564b6"

}