查看某个图的备份列表(1.0.0)
功能介绍
查询某个图下的备份列表。
URI
GET /v2/{project_id}/graphs/{graph_id}/backups
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
graph_id |
是 |
String |
图ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
每页资源数量的最大值,默认为10。 |
offset |
否 |
Integer |
本次请求的起始位置,默认为0。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
backup_count |
Integer |
备份总个数。请求失败时,字段为空。 |
backup_list |
Array of backup_list objects |
当前Project ID下的所有图的备份列表。请求失败时,字段为空。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
备份ID。 |
name |
String |
备份名称。 |
backup_method |
String |
备份方法,取值为auto,manual或者import。 |
graph_id |
String |
备份关联的图ID。 |
graph_name |
String |
备份关联的图Name。 |
graph_status |
String |
备份关联的图状态。 |
graph_size_type_index |
String |
备份关联的图规格。 |
data_store_version |
String |
备份关联的图版本。 |
arch |
String |
备份关联的图CPU架构。 |
status |
String |
备份状态。
|
start_timestamp |
Long |
备份开始时间戳。 |
start_time |
String |
备份开始时间。 |
end_timestamp |
Long |
备份结束时间戳。 |
end_time |
String |
备份结束时间。 |
size |
Long |
备份文件大小,单位为MB。 |
duration |
Long |
备份时间,单位为秒。 |
encrypted |
Boolean |
是否加密。true表示加密,默认值为"false",不加密。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
系统提示信息。
|
error_msg |
String |
系统提示信息。
|
请求示例
查询某个图下的备份列表。
GET https://Endpoint/v2/{project_id}/graphs/{graph_id}/backups?offset=0&limit=2
响应示例
状态码: 200
成功响应示例
{ "backup_count" : 2, "backup_list" : [ { "id" : "ada3e720-ab87-48cb-bff7-3ec5ae1a9652", "name" : "ges060803_nodelete-20210608135513", "backup_method" : "manual", "graph_id" : "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name" : "ges060803_nodelete", "graph_status" : "200", "graph_size_type_index" : "1", "data_store_version" : "2.2.21", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623160513000, "start_time" : "2021-06-08T13:55:13", "end_timestamp" : 1623160568000, "end_time" : "2021-06-08T13:56:08", "size" : 1, "duration" : 54, "encrypted" : false }, { "id" : "7ed3f51d-816d-4651-9129-fe21b64b5c91", "name" : "ges060803_nodelete_20210609203323_auto", "backup_method" : "auto", "graph_id" : "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name" : "ges060803_nodelete", "graph_status" : "200", "graph_size_type_index" : "1", "data_store_version" : "2.2.21", "arch" : "x86_64", "status" : "success", "start_timestamp" : 1623242004000, "start_time" : "2021-06-09T12:33:24", "end_timestamp" : 1623242004000, "end_time" : "2021-06-09T12:33:24", "size" : 1, "duration" : 0, "encrypted" : false } ] }
状态码: 400
失败响应示例
{ "error_code" : "GES.7000", "error_msg" : "The graph does not exist or has been deleted." }
状态码
返回值 |
说明 |
---|---|
400 Bad Request |
请求错误 |
401 Unauthorized |
鉴权失败 |
403 Forbidden |
没有操作权限 |
404 Not Found |
找不到资源 |
500 Internal Server Error |
服务内部错误 |
503 Service Unavailable |
服务不可用 |
错误码
请参见错误码。