请求示例 执行存储库资源自动备份，生成备份还原点。 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 表8 响应Body参数 参数 参数类型 描述 checkpoint CheckpointCreate object 备份还原点信息 表9 CheckpointCreate 参数 参数类型 描述 created_at String 创建时间，例如:"2020-02-05T10:38:34.209782"。 id String 还原点ID。 获取方法请参见"创建备份还原点", "查询所有备份"。 project_id String 项目ID。 获取方法请参见"获取项目ID"。 status String 还原点状态，取值范围如下： available: 可用 deleting: 删除中 protecting: 保护中 deleted: 已删除 error-deleting:删除异常 error: 异常 vault CheckpointPlanCreate object 存储库信息 extra_info CheckpointExtraInfoResp object 扩展信息 表10 CheckpointPlanCreate 参数 参数类型 描述 id String 存储库ID。 获取方法请参见"获取存储库ID"。 name String 存储库名称，最大支持64字符，只能由中文、字母、数字、“_”、“-”组成。 resources Array of CheckpointResourceResp objects 备份对象 skipped_resources Array of CheckpointCreateSkippedResource objects 备份时跳过的资源列表 表11 CheckpointResourceResp 参数 参数类型 描述 extra_info String 资源附加信息 id String 待备份资源id，需要该资源已经绑定到该存储库中，且属于可备份的状态。 获取方法请参见"查询存储库绑定资源信息"，"查询资源可保护性"。 name String 待备份资源名称，长度限制：0-255字符。 protect_status String 保护状态，取值范围如下： available: 可用 error: 异常 protecting: 保护中 restoring: 恢复中 removing: 删除中 resource_size String 资源已分配容量，单位为GB。取值范围不涉及。 type String 待备份资源的类型: OS::Nova::Server：云服务器； OS::Cinder::Volume：云硬盘；OS::Ironic::BareMetalServer：裸金属服务器；OS::Sfs::Turbo：SFS Turbo文件系统；OS::Workspace::DesktopV2： 云桌面 。默认取值不涉及。 backup_size String 备份副本大小。单位GB。取值范围不涉及，默认取值不涉及。 backup_count String 副本数量，取值范围不涉及，默认取值不涉及。 表12 CheckpointCreateSkippedResource 参数 参数类型 描述 id String 资源ID，格式为UUID。可根据待备份的资源类型查询对应的资源情况。 type String 资源类型，取值范围如下： OS::Nova::Server：云服务器；OS::Cinder::Volume：云硬盘；OS::Ironic::BareMetalServer：裸金属服务器；OS::Sfs::Turbo：SFS Turbo文件系统；OS::Workspace::DesktopV2：云桌面 name String 待备份资源名称，长度限制：0-255字符。 code String 请参见错误码。 reason String 跳过原因，例如：该资源正在备份中。 表13 CheckpointExtraInfoResp 参数 参数类型 描述 name String 备份名称，最大支持64字符，只能由数字、中文、英文大小写字母，以及下划线"_"和中横线 "-" 字符构成。 description String 备份描述，取值范围不涉及。 retention_duration Integer 备份保留天数，取值范围不涉及。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 sync 是 SyncParam object 本次同步还原点内容 表3 SyncParam 参数 是否必选 参数类型 描述 auto_trigger 是 Boolean 是否自动触发。默认为false。 true:自动触发 false：非自动触发 vault_id 是 String 混合 云存储 库ID。默认取值不涉及。 获取方法请参见"获取存储库ID"。