更新时间:2022-02-22 GMT+08:00

创建资源备份

功能介绍

选择资源直接备份。

URI

  • URI

    POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/{resource_id}/action

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目ID

    获取方法请参见获取项目ID

    provider_id

    String

    备份提供商ID,当前取值固定值:fc4d5750-22e7-4798-8a46-f48f62c4c1da。用于区分备份对象是服务器或磁盘。

    resource_id

    String

    备份服务器的ID。服务器ID请参见《弹性云服务器API参考》获取。

    文中所有备份提供商ID的当前取值均为:“fc4d5750-22e7-4798-8a46-f48f62c4c1da”。

请求

  • 要素说明
    表2 要素说明

    参数

    是否必选

    参数类型

    描述

    protect

    protect_param

    备份参数。

    详情请参见表3

  • protect_param 字段数据结构说明
    表3 protect_param 字段数据结构说明

    参数

    是否必选

    参数类型

    描述

    backup_name

    String

    备份名称,长度限制:1- 255,只能由中文、字母、数字、“_”、“-”组成。

    description

    String

    备份描述,长度限制:0- 255,除了“<”、“>”不能输入,其它字符均可。

    incremental

    Boolean

    备份执行的类型,取值为True代表执行增量备份,取值为False代表执行全量备份。如果是首次备份,则无论是否指定该参数或者该参数取任意值,总是执行全量备份;如果非首次备份,指定该参数为False代表本次执行全量备份,不指定该参数或者该参数取值为True代表本次执行增量备份。

    resource_type

    String

    备份对象的实体对象类型。

    当前的取值仅支持:OS::Nova::Server,该值代表备份对象为云服务器。如果不传递该参数则默认备份对象为云服务器。

    extra_info

    Dict

    备份对象的附加信息。

  • 请求样例
    POST 
    https://{endpoint}/v1/b942cc8342734d15bcb246babb1953cf/providers/fc4d5750-22e7-4798-8a46-f48f62c4c1da/resources/9506416d-db6c-406e-8bca-c0f43793d914/action
    {
        "protect" : {
        "backup_name" : "backup",
        "description" : "backup des",
        "extra_info" : {
        }
        
      }
    }

响应

  • 要素说明
    表4 要素说明

    参数

    参数类型

    描述

    checkpoint

    protect_resp

    备份响应。

    详情请参见表5

  • protect_resp 字段数据结构说明
    表5 protect_resp 字段数据结构说明

    参数

    参数类型

    描述

    status

    String

    备份状态,

    Enum:[ waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting,deleted]

    created_at

    String

    创建时间,如:"2017-04-18T01:21:52.701973"

    id

    String

    备份记录ID

    resource_graph

    String

    资源图,备份子备份包含关系结构图

    project_id

    String

    项目ID

    获取方法请参见获取项目ID

    protection_plan

    plan_resp

    备份计划信息

    详情请参见表6

    extra_info

    String

    额外添加信息

  • plan_resp 字段数据结构说明
    表6 plan_resp 字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    备份策略ID。

    name

    String

    备份策略名称。

    resources

    List<resource>

    备份对象列表。

    详情请参见表7

  • resource 字段数据结构说明
    表7 resource 字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    待备份对象ID

    type

    String

    备份对象的实体对象类型虚拟机:OS::Nova::Server

    name

    String

    备份对象名称

    extra_info

    Dict

    备份对象的附加信息

  • 响应样例
    {
      "checkpoint" : {
        "status" : "protecting",
        "created_at" : "2017-04-18T01:21:52.701973",
        "id" : "4468f4b8-7c78-4222-a2ca-346b5d557dd2",
        "resource_graph" : null,
        "project_id" : "b942cc8342734d15bcb246babb1953cf",
        "extra_info" : null,
        "protection_plan" : {
          "id" : "fake_04f8ea0f-2000-4389-a5ce-93a3e20d0faf",
          "resources" : [ {
            "type" : "OS::Nova::Server",
            "id" : "9506416d-db6c-406e-8bca-c0f43793d914",
            "name" : "resource_9506416d-db6c-406e-8bca-c0f43793d914",
            "extra_info" : {
        }
          } ],
          "name" : "server protect plan for 9506416d-db6c-406e-8bca-c0f43793d914"
        }
      }
    }

状态码

  • 正常

    状态码

    说明

    200

    OK

  • 异常

    状态码

    说明

    400

    请求参数不合法

    401

    鉴权失败

    403

    没有操作权限

    404

    请求对象不存在

    500

    服务内部错误

    503

    服务不可用

错误码

请参考错误码