更新时间:2023-12-20 GMT+08:00

查询全量备份列表

功能介绍

查询备份列表。

URI

GET /v3/{project_id}/backups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的project ID。

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

表2 Query参数

参数

是否必选

参数类型

描述

instance_id

String

实例ID。

backup_id

String

备份ID。

通过创建手动备份中返回的响应参数“backup”获取。

backup_type

String

备份类型。

取值范围:

  • auto:自动全量备份。
  • manual:手动全量备份。

offset

String

索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

limit

String

查询记录数。默认为100,不能为负数,最小值为1,最大值为100。

begin_time

String

查询开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

end_time

String

查询结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”,且大于查询开始时间。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

name

String

备份名称。

instance_name

String

实例名称。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

String

请求语言类型。默认en-us。

取值范围:

  • en-us
  • zh-cn

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

backups

Array of backups objects

备份信息。

total_count

Long

备份文件的总数。

表5 backups

参数

参数类型

描述

id

String

备份ID。

name

String

备份名称。

begin_time

String

备份开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

end_time

String

备份结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。

status

String

备份状态。

取值范围:

  • BUILDING:备份中。
  • COMPLETED:备份完成。
  • FAILED:备份失败。
  • AVAILABLE:备份可用。

take_up_time

Integer

备份花费时间,单位是minutes。

type

String

备份类型。

取值范围:

  • auto:自动全量备份。
  • manual:手动全量备份。

size

Long

备份大小,单位是MB。

datastore

MysqlDatastore object

数据库信息。

instance_id

String

实例ID。

instance_name

String

实例名称。

backup_level

String

备份级别。当开启一级备份开关时,返回该参数。

取值范围:

  • 0:备份正在创建中或者备份失败。
  • 1:一级备份。
  • 2:二级备份。

description

String

备份文件描述信息。

表6 MysqlDatastore

参数

参数类型

描述

type

String

数据库引擎。

version

String

数据库版本。

数据库支持的详细版本信息,可通过查询数据库引擎的版本获取。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

查询时间段内(2020-07-06~2020-07-16)的自动备份列表。

GET https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/backups?instance_id=43e4feaab48f11e89039fa163ebaa7e4br01&backup_id=c0c9f155c7b7423a9d30f0175998b63bbr01&backup_type=auto&offset=0&limit=10&begin_time=2020-07-06T10:41:14+0800&end_time=2020-07-16T10:41:14+0800

响应示例

状态码: 200

Success.

{
  "backups" : [ {
    "id" : "1fe4feaab48f11e6654hfa163eba87e4b66u",
    "name" : "GaussDBforMySQL-gauss-e747-20200705185048266",
    "begin_time" : "2018-08-06T12:41:14+0800",
    "end_time" : "2018-08-06T12:45:14+0800",
    "take_up_time" : 2,
    "status" : "COMPLETED",
    "type" : "auto",
    "size" : 2803,
    "datastore" : {
      "type" : "GaussDB(for MySQL)",
      "version" : "8.0"
    },
    "instance_id" : "43e4feaab48f11e89039fa163ebaa7e4br01",
    "instance_name" : "GaussDBforMySQL-gauss-e747",
    "backup_level" : "2"
  } ],
  "total_count" : 1
}

状态码

请参见状态码

错误码

请参见错误码