查看某个图的备份列表(1.0.0)
功能介绍
查询某个图下的备份列表。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
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 |
备份开始时间。 |
|
product_type |
String |
图产品类型。
|
|
end_timestamp |
Long |
备份结束时间戳。 |
|
end_time |
String |
备份结束时间。 |
|
size |
Long |
备份文件大小，单位为MB。 |
|
duration |
Long |
备份时间，单位为秒。 |
状态码： 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
}, {
"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
} ]
}
状态码： 404
失败响应示例
{
"error_msg": "Cluster does not exist or has been deleted.",
"error_code": "GES.0047"
}
状态码
|
返回值 |
说明 |
|---|---|
|
400 Bad Request |
请求错误 |
|
401 Unauthorized |
鉴权失败 |
|
403 Forbidden |
没有操作权限 |
|
404 Not Found |
找不到资源 |
|
500 Internal Server Error |
服务内部错误 |
|
503 Service Unavailable |
服务不可用 |
错误码
请参见错误码。
