查看某个图的备份列表(1.0.0)
功能介绍
查询某个图下的备份列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1.0/{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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorMessage |
String |
系统提示信息。
|
|
errorCode |
String |
系统提示信息。
|
|
backupCount |
Integer |
备份总个数。请求失败时,该字段为空。 |
|
backupList |
Array of backup objects |
当前Project下指定Graph的备份列表。请求失败时,该字段为空。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
备份ID。 |
|
name |
String |
备份名称。 |
|
backupMethod |
String |
备份方法,取值为auto或manual。 |
|
graphId |
String |
备份关联的图ID。 |
|
graph_name |
String |
备份关联的图Name。 |
|
graphStatus |
String |
备份关联的图状态。 |
|
graphSizeTypeIndex |
String |
备份关联的图规格。 |
|
dataStoreVersion |
String |
备份关联的图版本。 |
|
arch |
String |
备份关联的图CPU架构。 |
|
status |
String |
备份状态。
|
|
startTimestamp |
Long |
备份开始时间戳。 |
|
startTime |
String |
备份时间。 |
|
endTimestamp |
Long |
备份结束时间戳。 |
|
endTime |
String |
备份时间。 |
|
size |
Long |
备份文件大小,单位为MB。 |
|
duration |
Long |
备份时间,单位为秒。 |
请求示例
GET https://{Endpoint}/v1.0/{project_id}/graphs/{graph_id}/backups?offset=0&limit=2
响应示例
状态码: 200
成功响应示例
{
"backupCount": 2,
"backupList": [
{
"id": "ada3e720-ab87-48cb-bff7-3ec5ae1a9652",
"name": "ges060803_nodelete-20210608135513",
"backupMethod": "manual",
"graphId": "4c5f882d-a813-4d78-a8e3-6d3212ddd121",
"graph_name": "ges060803_nodelete",
"graphStatus": "200",
"graphSizeTypeIndex": "1",
"dataStoreVersion": "2.2.22",
"arch": "x86_64",
"status": "success",
"startTimestamp": 1623160513000,
"startTime": "2021-06-08T13:55:13",
"endTimestamp": 1623160568000,
"endTime": "2021-06-08T13:56:08",
"size": 1,
"duration": 54
},
{
"id": "7ed3f51d-816d-4651-9129-fe21b64b5c91",
"name": "ges060803_nodelete_20210609203323_auto",
"backupMethod": "auto",
"graphId": "4c5f882d-a813-4d78-a8e3-6d3212ddd121",
"graph_name": "ges060803_nodelete",
"graphStatus": "200",
"graphSizeTypeIndex": "1",
"dataStoreVersion": "2.2.21",
"arch": "x86_64",
"status": "success",
"startTimestamp": 1623242004000,
"startTime": "2021-06-09T12:33:24",
"endTimestamp": 1623242004000,
"endTime": "2021-06-09T12:33:24",
"size": 1,
"duration": 0
}
]
}
状态码: 404
失败响应示例
{
"error_msg": "Cluster does not exist or has been deleted.",
"error_code": "GES.0047"
}
状态码
|
状态码 |
说明 |
|---|---|
|
200 |
请求成功。 |
|
400 |
请求错误。 |
|
401 |
鉴权失败。 |
|
403 |
没有操作权限。 |
|
404 |
找不到资源。 |
|
500 |
服务内部错误。 |
|
503 |
服务不可用。 |