更新时间:2024-10-28 GMT+08:00
分享

查询快照链的列表

功能介绍

查询快照链的列表

调用方法

请参见如何调用API

URI

GET /v5/{project_id}/snapshot-chains

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。 获取方法请参见"获取项目ID"。

表2 Query参数

参数

是否必选

参数类型

描述

marker

String

分页查询的起始资源ID,取值为上一页最后一条查询记录的资源ID。

limit

Integer

返回结果个数限制。 最小值1,最大值1000,默认为1000。返回的结果中记录数不超过limit值。

id

String

快照链ID。

volume_id

String

快照链所属的云硬盘ID。

category

String

快照链的类型,当前快照链支持"standard"、"backup"和"server_backup"三种类型。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

snapshot_chains

Array of snapshot_chains objects

快照链列表。

表5 snapshot_chains

参数

参数类型

描述

id

String

快照链ID。

availability_zone

String

快照链所属云硬盘的可用区。

snapshot_count

Integer

快照链上的快照个数,

capacity

Integer

快照链的大小。

project_id

String

项目ID。

volume_id

String

快照链所属的云硬盘ID。

category

String

快照链的类型。

created_at

String

创建时间。

updated_at

String

更新时间。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息。

表7 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。

错误码和其对应的含义请参考错误码说明

message

String

出现错误时,返回的错误消息。

请求示例

GET https://{endpoint}/v5/{project_id}/snapshot-chains

响应示例

状态码: 200

OK

{
  "snapshot_chains" : [ {
    "id" : "e97f57fe-767b-46c6-ac1b-10b77e491406",
    "capacity" : 0,
    "project_id" : "fb640396c4344e4f96057fab643fe5b5",
    "volume_id" : "7c40f5ae-2b26-4922-b586-3d41af4822f1",
    "category" : "standard",
    "availability_zone" : "cn-southwest-242a",
    "snapshot_count" : 1,
    "created_at" : "2023-10-25T08:56:26.087002",
    "updated_at" : "2023-10-25T08:56:26.758003"
  }, {
    "id" : "5b798ddd-872b-4823-ab45-a02733ed62cb",
    "capacity" : 1,
    "project_id" : "fb640396c4344e4f96057fab643fe5b5",
    "volume_id" : "92fea069-6073-4784-a7e8-7a1a4caf9c70",
    "category" : "standard",
    "availability_zone" : null,
    "snapshot_count" : 1,
    "created_at" : "2023-08-15T13:17:59.061000",
    "updated_at" : "2023-08-15T13:17:59.065000"
  } ]
}

状态码: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码

相关文档