/api/db/.../backup/status
返回当前备份过程的状态。
REST服务器启动后(监听端口8083),下面的http请求将返回备份过程的当前状态:
http://localhost:8083/api/db/diskdb/backup/status
此输出与 mco_async_backup_progress_info() 函数的输出等同。它包含以下字段:(有关这些字段的详细说明,请参阅 mco_backup_progress_info_t 结构的文档)
- phase:空闲(IDLE)、循环(LOOPING)、完成(FINALIZING)或恢复(RESTORE)
- max_passes:最大循环次数
- max_steps:最大步骤数
- pass_no:当前循环次数
- step_no:当前步骤数
此外,此端点的输出包含异步对象,该对象具有以下字段,这些字段与 mco_async_backup_progress_info_t 结构中的字段相对应(除了 active 标志,该标志不在结构中,用于指示当前异步备份任务是否正在运行):
- active
- file_name
- last_label
- type
- compression_level
- last_error_code
- last_error_msg
最后,以下字段报告数据库中增量备份支持的可用性(由 MCO_DB_INCREMENTAL_BACKUP 标志指示):
- incremental_enabled:启用增量备份
示例
当备份程序未运行时:
{
"incremental_enabled": true,
"phase": "IDLE",
"max_passes": 0,
"max_steps": 0,
"pass_no": 0,
"step_no": 0,
{
"active": false,
"file_name": mull,
"last_label": null,
"type": "AUTO",
"compression_level": 0,
"last_error_code": 0,
"last_error_msg": null
}
}
当异步备份程序启动时,输出可能类似于以下内容。请注意,尽管阶段字段显示为“空闲”(意味着在请求时未执行任何备份操作),但异步备份程序仍处于活动状态,这由活动标志指示:
{
"incremental_enabled": true,
"phase": "IDLE":,
"max_passes": 0,
"max_steps": 0,
"pass_no": 0,
"step_no": 0,
"async":
{
"active": true,
"file_name": "database.bkp",
"last_label": "AUTOBACKUP00001",
"type": "AUTO",
"compression_level": 0,
"last_error_code": 0,
"last_error_msg": ""
}
}