更新时间:2022-02-22 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

是否自动触发,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信息

错误码

请参见错误码