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

创建备份还原点

分享
更新时间: 2020/01/21 GMT+08:00

功能介绍

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

URI

POST /v3/{project_id}/checkpoints

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

checkpoint

VaultBackup object

存储库执行备份参数

表4 VaultBackup

参数

是否必选

参数类型

描述

parameters

CheckpointParam object

参数

vault_id

String

存储库ID

表5 CheckpointParam

参数

是否必选

参数类型

描述

auto_trigger

Boolean

是否自动触发

description

String

备份描述

incremental

Boolean

是否增量备份

name

String

备份名称

resources

Array of strings

待备份的资源id列表:uuid

响应参数

状态码为 200 时:
表6 响应Body参数

参数

参数类型

描述

checkpoint

CheckpointCreate object

还原点信息

表7 CheckpointCreate

参数

参数类型

描述

created_at

String

创建时间

id

String

还原点ID

project_id

String

项目ID

status

String

状态

取值范围:

  • available

  • deleting

  • creating

  • restoring

  • error

vault

CheckpointPlanCreate object

存储库信息

表8 CheckpointPlanCreate

参数

参数类型

描述

id

String

存储库id

name

String

存储库名称

resources

Array of Resource objects

备份对象

skipped_resources

Array of CheckpointCreateSkippedResource objects

备份时跳过的资源列表

表9 Resource

参数

参数类型

描述

extra_info

ResourceExtraInfo object

资源附加信息

id

String

待备份资源id

name

String

待备份资源名称

type

String

待备份资源的类型

取值范围:

  • OS::Nova::Server

  • OS::Cinder::Volume

  • OS::Ironic::BareMetalServer

表10 ResourceExtraInfo

参数

参数类型

描述

exclude_volumes

Array of strings

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

include_volumes

Array of ResourceExtraInfoIncludeVolumes objects

要备份的卷

表11 ResourceExtraInfoIncludeVolumes

参数

参数类型

描述

id

String

卷ID

os_version

String

操作系统类型

表12 CheckpointCreateSkippedResource

参数

参数类型

描述

id

String

资源ID

type

String

资源类型

name

String

资源名称

code

String

错误码

reason

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信息

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

提交反馈 取消

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

跳转到云社区