导出数据库备份(ExportDatabaseBackupFromBackupStorage)
从备份服务器导出数据库备份。
API请求
URLs
PUT zstack/v1/database-backups/{databaseBackupUuid}/backup-storage/{backupStorageUuid}/actions
Headers
Authorization: OAuth the-session-uuid
Body
{
"exportDatabaseBackupFromBackupStorage": {},
"systemTags": [],
"userTags": []
}
Note: 上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。
Curl示例
curl -H "Content-Type: application/json" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X PUT -d '{"exportDatabaseBackupFromBackupStorage":{}}' http://localhost:8080/zstack/v1/database-backups/6dae84793fc53f5b82034dd9a44c554b/backup-storage/cc9127f6af0e32c888044f49048788a1/actions
参数列表
名字 | 类型 | 位置 | 描述 | 可选值 | 起始版本 |
---|---|---|---|---|---|
backupStorageUuid | String | url | 镜像存储UUID | 3.0.0 | |
databaseBackupUuid | String | url | 数据库备份UUID | 3.0.0 | |
systemTags (可选) | List | body | 3.0.0 | ||
userTags (可选) | List | body | 3.0.0 |
API返回
返回示例
{
"databaseBackupUrl": "http://127.0.0.1:8001/path/zstack-db-backup.gz"
}
名字 | 类型 | 描述 | 起始版本 |
---|---|---|---|
databaseBackupUrl | String | 被导出备份的访问地址 | 3.0.0 |
error | ErrorCode | 错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error | 3.0.0 |
#error
名字 | 类型 | 描述 | 起始版本 |
---|---|---|---|
code | String | 错误码号,错误的全局唯一标识,例如SYS.1000, HOST.1001 | 3.0.0 |
description | String | 错误的概要描述 | 3.0.0 |
details | String | 错误的详细信息 | 3.0.0 |
elaboration | String | 保留字段,默认为null | 3.0.0 |
opaque | LinkedHashMap | 保留字段,默认为null | 3.0.0 |
cause | ErrorCode | 根错误,引发当前错误的源错误,若无原错误,该字段为null | 3.0.0 |
SDK示例
Java
SDK
ExportDatabaseBackupFromBackupStorageAction action = new ExportDatabaseBackupFromBackupStorageAction();
action.backupStorageUuid = "cc9127f6af0e32c888044f49048788a1";
action.databaseBackupUuid = "6dae84793fc53f5b82034dd9a44c554b";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
ExportDatabaseBackupFromBackupStorageAction.Result res = action.call();
Python
SDK
ExportDatabaseBackupFromBackupStorageAction action = ExportDatabaseBackupFromBackupStorageAction()
action.backupStorageUuid = "cc9127f6af0e32c888044f49048788a1"
action.databaseBackupUuid = "6dae84793fc53f5b82034dd9a44c554b"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
ExportDatabaseBackupFromBackupStorageAction.Result res = action.call()