- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 混合云备份特性指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
- 故障排除
-
常见问题
- 概念类
- 计费类
-
备份类
- 备份时,需要停止服务器吗?
- 包含数据库的服务器是否可以备份?
- 如何区分备份是自动备份还是手动备份?
- 备份支持选择磁盘的某个分区进行备份吗?
- 服务器能否跨区域备份?
- 如何通过云服务器备份实现云服务器数据跨区域迁移?
- 可以将两个磁盘的数据备份至一个磁盘上吗?
- 如何同区域同可用区的复制一个磁盘?
- 支持在存储库之间进行备份迁移吗?
- 删除资源后还可以使用备份恢复数据吗?
- 单个资源可以创建多少个备份?
- 删除全量备份后,还可以使用增量备份恢复数据吗?
- 备份时可以终止备份吗?
- 如何减小备份占用空间?
- 如何查看每个备份的大小?
- 如何查看备份中的数据?
- 备份会保存多久?
- 如何对资源进行周期性全备?
- 如何查询自己哪些资源还未配置备份?
- 数据备份时是否对网络带宽有要求?
- 一个存储库绑定多个资源时,备份保留策略如何生效?
- 数据库服务器备份和云数据库备份有什么区别?
- 容量类
- 恢复类
- 策略类
- 优化类
- 其他类
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
创建备份还原点
功能介绍
对存储库执行备份,生成备份还原点
URI
POST /v3/{project_id}/checkpoints
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
checkpoint |
是 |
VaultBackup object |
存储库执行备份参数 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
auto_trigger |
否 |
Boolean |
是否自动触发,true:自动触发,false:非自动触发。 |
description |
否 |
String |
备份描述 |
incremental |
否 |
Boolean |
是否增量备份,true:增量备份,false:非增量备份。 |
name |
否 |
String |
备份名称,只能由数字、中文、英文大小写字母,以及下划线"_"和中横线 "-" 字符构成。 |
resources |
否 |
Array of strings |
待备份的资源id列表:uuid |
resource_details |
否 |
Array of Resource objects |
资源详情 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
extra_info |
否 |
ResourceExtraInfo object |
资源附加信息 |
id |
是 |
String |
待备份资源id |
name |
否 |
String |
待备份资源名称,长度限制:0-255 |
type |
是 |
String |
待备份资源的类型: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo, OS::Workspace::DesktopV2 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
checkpoint |
CheckpointCreate object |
还原点信息 |
参数 |
参数类型 |
描述 |
---|---|---|
created_at |
String |
创建时间,例如:"2020-02-05T10:38:34.209782" |
id |
String |
还原点ID |
project_id |
String |
项目ID |
status |
String |
状态
|
vault |
CheckpointPlanCreate object |
存储库信息 |
extra_info |
CheckpointExtraInfoResp object |
扩展信息 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
存储库id |
name |
String |
存储库名称 |
resources |
Array of CheckpointResourceResp objects |
备份对象 |
skipped_resources |
Array of CheckpointCreateSkippedResource objects |
备份时跳过的资源列表 |
参数 |
参数类型 |
描述 |
---|---|---|
extra_info |
String |
资源附加信息 |
id |
String |
待备份资源id |
name |
String |
待备份资源名称 |
protect_status |
String |
保护状态
|
resource_size |
String |
资源已分配容量,单位为GB |
type |
String |
待备份资源的类型: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo, OS::Workspace::DesktopV2 |
backup_size |
String |
副本大小 |
backup_count |
String |
副本数量 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
资源ID |
type |
String |
资源类型 |
name |
String |
资源名称 |
code |
String |
请参见错误码。 |
reason |
String |
跳过原因,例如:该资源正在备份中。 |
请求示例
执行存储库资源自动备份,生成备份还原点。
POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/checkpoints { "checkpoint" : { "parameters" : { "auto_trigger" : true, "description" : "backup_description", "incremental" : true, "name" : "backup_name", "resources" : [ "94eba8b2-acc9-4d82-badc-127144cc5526" ] }, "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce" } }
响应示例
状态码:200
OK
{ "checkpoint" : { "status" : "protecting", "created_at" : "2019-05-10T07:59:12.733+00:00", "vault" : { "skipped_resources" : [ ], "id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce", "resources" : [ { "name" : "ecs-1f0f-0002", "resource_size" : 40, "protect_status" : "available", "type" : "OS::Nova::Server", "id" : "94eba8b2-acc9-4d82-badc-127144cc5526" } ], "name" : "vault-be94" }, "project_id" : "4229d7a45436489f8c3dc2b1d35d4987", "id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664", "extra_info" : { "retention_duration" : -1, "name" : "backup_name", "description" : "backup_description" } } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。