文档首页> 云备份 CBR> API参考（阿布扎比区域）> API> 还原点> 创建备份还原点
更新时间：2022-02-22 GMT+08:00
查看PDF

创建备份还原点

功能介绍

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

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

是否自动触发,true:自动触发，false：非自动触发。

缺省值：false

description

否

String

备份描述

最小长度：0

最大长度：255

incremental

否

Boolean

是否增量备份，true:增量备份，false：非增量备份。

缺省值：true

name

否

String

备份名称

最小长度：1

最大长度：64

resources

否

Array of strings

待备份的资源id列表:uuid

resource_details

否

Array of Resource objects
表6 Resource

参数

是否必选

参数类型

描述

extra_info

否

ResourceExtraInfo object

资源附加信息

id

是

String

待备份资源id

name

是

String

待备份资源名称，长度限制：0-255

最小长度：0

最大长度：255

type

是

String
表7 ResourceExtraInfo

参数

是否必选

参数类型

描述

exclude_volumes

否

Array of strings

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

include_volumes

否

Array of ResourceExtraInfoIncludeVolumes objects

要备份的卷
表8 ResourceExtraInfoIncludeVolumes

参数

是否必选

参数类型

描述

id

是

String

卷ID，仅支持uuid

os_version

否

String

操作系统类型

响应参数

状态码： 200

表9 响应Body参数

参数

参数类型

描述

checkpoint

CheckpointCreate object

还原点信息
表10 CheckpointCreate

参数

参数类型

描述

created_at

String

创建时间，例如:"2020-02-05T10:38:34.209782"

id

String

还原点ID

project_id

String

项目ID

status

String

状态:available,deleting,creating,restoring,error

枚举值：

  • available

  • deleting

  • creating

  • restoring

  • error

vault

CheckpointPlanCreate object

存储库信息

extra_info

CheckpointExtraInfoResp object
表11 CheckpointPlanCreate

参数

参数类型

描述

id

String

存储库id

name

String

存储库名称

resources

Array of CheckpointResourceResp objects

备份对象

skipped_resources

Array of CheckpointCreateSkippedResource objects

备份时跳过的资源列表
表12 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

backup_size

String

副本大小

backup_count

String

副本数量
表13 CheckpointCreateSkippedResource

参数

参数类型

描述

id

String

资源ID

type

String

资源类型

name

String

资源名称

code

String

请参见错误码。

reason

String

跳过原因，例如：该资源正在备份中。
表14 CheckpointExtraInfoResp

参数

参数类型

描述

name

String

备份名称

description

String

备份描述

retention_duration

Integer

备份保留天数

请求示例

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

执行备份返回的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信息

错误码

请参见错误码。

父主题： 还原点