获取备份列表-九游平台
功能介绍
获取备份列表。
接口约束
该接口支持查询全量和增量备份。
uri
- uri格式
get /v3/{project_id}/backups?instance_id={instance_id}&backup_id={backup_id}&backup_type={backup_type}&offset={offset}&limit={limit}&begin_time={begin _time}&end_time={end_time}
- 参数说明
表1 参数说明 名称
是否必选
参数类型
说明
project_id
是
string
参数解释：
租户在某一region下的项目id。
获取方法请参见获取项目id。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
string
参数解释：
实例id。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
backup_id
否
string
参数解释：
备份id。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
backup_type
否
string
参数解释：
备份类型。
约束限制：
不涉及。
取值范围：
- “auto”：自动全量备份。
- “manual”：手动全量备份。
- “fragment”：差异全量备份。
- “incremental”：自动增量备份。
默认取值：
不涉及。
status
否
string
参数解释：
备份状态。
约束限制：
不涉及。
取值范围：
- “building”：备份中。
- “completed”：备份完成。
- “failed”：备份失败。
默认取值：
不涉及。
offset
否
integer
参数解释：
索引位置，偏移量。
约束限制：
不涉及。
取值范围：
从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。
默认取值：
0
limit
否
integer
参数解释：
查询记录数。
约束限制：
不涉及。
取值范围：
默认为100，不能为负数，最小值为1，最大值为100。
默认取值：
100
begin_time
否
string
参数解释：
查询开始时间。
约束限制：
“begin_time”有值时，“end_time”必选。
取值范围：
格式为“yyyy-mm-ddthh:mm:ssz”。
其中，t指某个时间的开始；z指时区偏移量，例如北京时间偏移显示为 0800。
默认取值：
不涉及。
end_time
否
string
参数解释：
查询结束时间。
约束限制：
“end_time”有值时，“begin_time”必选。
取值范围：
格式为“yyyy-mm-ddthh:mm:ssz”，且大于查询开始时间。
其中，t指某个时间的开始；z指时区偏移量，例如北京时间偏移显示为 0800。
默认取值：
不涉及。
请求参数
无。
请求示例
get https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/backups?instance_id=43e4feaab48f11e89039fa163ebaa7e4in01&backup_id=c0c9f155c7b7423a9d30f0175998b63bbr01&backup_type=auto&offset=0&limit=10&begin_time=2018-08-06t10:41:14 0800&end_time=2018-08-16t10:41:14 0800
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
backups
array of objects
参数解释：
备份列表。详情请参见表3。
total_count
integer
参数解释：
总记录数。
取值范围：
不涉及。
表3 backups字段数据结构说明 名称
参数类型
说明
id
string
参数解释：
备份id。
取值范围：
不涉及。
name
string
参数解释：
备份名称。
取值范围：
不涉及。
type
string
参数解释：
备份类型。
取值范围：
- “auto”：自动全量备份。
- “manual”：手动全量备份。
- “fragment”：差异全量备份。
- “incremental”：自动增量备份。
size
long
参数解释：
备份大小，单位：kb。
取值范围：
不涉及。
status
string
参数解释：
备份状态。
取值范围：
- building: 备份中。
- completed: 备份完成。
- failed：备份失败。
- deleting：备份删除中。
begin_time
string
参数解释：
备份开始时间。
- 全量备份类型下，指备份开始时间。
- mysql增量备份类型，指备份文件中上一轮增备任务的最后一个事务的提交时间。
取值范围：
格式为“yyyy-mm-ddthh:mm:ssz”。其中，t指某个时间的开始；z指时区偏移量，例如北京时间偏移显示为 0800。
end_time
string
参数解释：
备份结束时间。
- 全量备份类型下，指备份结束时间。
- mysql增量备份类型，指备份文件中最后一个事务的提交时间。
取值范围：
格式为“yyyy-mm-ddthh:mm:ssz”，其中，t指某个时间的开始；z指时区偏移量，例如北京时间偏移显示为 0800。
datastore
object
参数解释：
数据库版本信息。详情请参见表4。
instance_id
string
参数解释：
备份所在实例id。
取值范围：
不涉及。
associated_with_ddm
boolean
参数解释：
是否已被ddm实例关联。
取值范围：
不涉及。
表4 datastore字段数据结构说明 名称
参数类型
说明
type
string
参数解释：
数据库引擎。
取值范围：
mysql
version
string
参数解释：
数据库版本。
取值范围：
5.7、8.0
- 正常响应样例
{ "backups": [{ "id": "43e4feaab48f11e89039fa163ebaa7e4br01", "name": "xxxx.xxx", "type": "auto", "size": 2803, "status": "completed", "begin_time": "2018-08-06t12:41:14 0800", "end_time": "2018-08-06t12:43:14 0800", "datastore": { "type": "mysql", "version": "5.7" }, "instance_id": "a48e43ff268f4c0e879652d65e63d0fbin01", "associated_with_ddm": false }], "total_count": 1 } - 异常响应
请参见异常请求结果。
状态码
- 正常
200
- 异常
请参见状态码。
相关文档
意见反馈
文档内容是否对您有帮助？
如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨
