更新时间:2024-04-03 GMT+08:00

查看某个图的备份列表(1.0.0)

功能介绍

查询某个图下的备份列表。

URI

GET /v1.0/{project_id}/graphs/{graph_id}/backups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

graph_id

String

图ID。

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

每页资源数量的最大值,默认为10。

offset

Integer

本次请求的起始位置,默认为0。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

errorMessage

String

系统提示信息。

  • 执行成功时,字段可能为空。
  • 执行失败时,用于显示错误信息。

errorCode

String

系统提示信息。

  • 执行成功时,字段可能为空。
  • 执行失败时,用于显示错误码。

backupCount

Integer

备份总个数。请求失败时,该字段为空。

backupList

Array of backup objects

当前Project下指定Graph的备份列表。请求失败时,该字段为空。

表5 backup

参数

参数类型

描述

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

备份状态。

  • backing_up:备份中
  • success:备份成功
  • failed:备份失败

startTimestamp

Long

备份开始时间戳。

startTime

String

备份时间。

endTimestamp

Long

备份结束时间戳。

endTime

String

备份时间。

size

Long

备份文件大小,单位为MB。

duration

Long

备份时间,单位为秒。

encrypted

Boolean

是否加密。true表示加密,默认值为"false",不加密。

请求示例

GET https://Endpoint/v1.0/{project_id}/graphs/{graph_id}/backups?offset=0&limit=2

响应示例

状态码: 200

OK

{
    "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,
            "encrypted": false
        },
        {
            "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,
            "encrypted": false
        }
    ]
}

状态码: 400

Bad Request

{
  "errorCode" : "GES.7000",
  "errorMessage" : "The graph does not exist or has been deleted."
}

状态码

状态码

说明

200

请求成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。