更新时间:2024-01-25 GMT+08:00
分享

查看所有备份列表(1.0.0)

功能介绍

查询备份列表。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目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 ID下的所有图的备份列表。请求失败时,该字段为空。

表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表示不加密,默认值为false。

请求示例

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

响应示例

状态码: 200

OK

{
    "backupCount": 3,
    "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.21",
            "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
        },
        {
            "id": "604bfb46-04dd-45fc-a9ae-df24a0705b9d",
            "name": "ges060802_nodelete-20210608135523",
            "backupMethod": "manual",
            "graphId": "9b9a05c2-0cdb-41ac-b55f-93caffb0519a",
            "graph_name": "ges060802_nodelete",
            "graphStatus": "400",
            "graphSizeTypeIndex": "0",
            "dataStoreVersion": "2.2.23",
            "arch": "x86_64",
            "status": "success",
            "startTimestamp": 1623160524000,
            "startTime": "2021-06-08T13:55:24",
            "endTimestamp": 1623160577000,
            "endTime": "2021-06-08T13:56:17",
            "size": 1,
            "duration": 53,
            "encrypted": false
        }
    ]
}

状态码: 400

Bad Request

{
  "errorCode" : "GES.7006",
  "errorMessage" : "The underlying graph engine has internal error."
}

状态码

状态码

说明

200

请求成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。

相关文档