文档首页 > > API参考> API> 还原点> 创建备份还原点

创建备份还原点

分享
更新时间: 2019/10/09 GMT+08:00

功能介绍

对存储库执行备份,生成备份还原点

URI

POST /v3/{project_id}/checkpoints

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

checkpoint

VaultBackup object

存储库执行备份参数

表3 VaultBackup

参数

是否必选

参数类型

描述

parameters

CheckpointParam object

参数

vault_id

String

存储库ID

表4 CheckpointParam

参数

是否必选

参数类型

描述

auto_trigger

Boolean

是否自动触发

description

String

备份描述

incremental

Boolean

是否增量备份

name

String

备份名称

resources

Array of strings

待备份的资源id列表:uuid

响应参数

状态码为 200 时:

表5 响应Body参数

参数

参数类型

描述

checkpoint

CheckpointCreate object

还原点信息

表6 CheckpointCreate

参数

参数类型

描述

created_at

String

创建时间

id

String

还原点ID

project_id

String

项目ID

status

String

状态

vault

CheckpointPlanCreate object

存储库信息

表7 CheckpointPlanCreate

参数

参数类型

描述

id

String

存储库id

name

String

存储库名称

resources

Array of Resource objects

备份对象

skipped_resources

Array of CheckpointCreateSkippedResource objects

备份时跳过的资源列表

表8 CheckpointCreateSkippedResource

参数

参数类型

描述

id

String

资源ID

type

String

资源类型

name

String

资源名称

code

String

错误码

reason

String

跳过原因

表9 Resource

参数

参数类型

描述

extra_info

ResourceExtraInfo object

资源附加信息

id

String

待备份资源id

name

String

待备份资源名称

type

String

待备份资源的类型

表10 ResourceExtraInfo

参数

参数类型

描述

exclude_volumes

Array of strings

需要排除备份的卷id。仅虚拟机磁盘级备份有效

include_volumes

Array of ResourceExtraInfoIncludeVolumes objects

要备份的卷

表11 ResourceExtraInfoIncludeVolumes

参数

参数类型

描述

id

String

卷ID

os_version

String

操作系统类型

请求示例

{
	"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 时:

{
	"checkpoint":{
		"status":"protecting",
		"created_at":"2019-05-10T07:59:12.733403",
		"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

执行备份返回的checkpoint信息

错误码

状态码

错误码

描述

解决方案

100

6113

该存储库状态不支持备份

  

400

1001

保管库正在执行备份

  

400

6114

存储库使用容量超出总容量

  

400

9900

参数检查失败

  
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区