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

快速入门

本节通过调用一系列VBS的API创建云硬盘备份。

  • 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。

涉及API

当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

  • IAM获取token的API
  • VBS创建备份的API

具体步骤

  1. Token认证,具体操作请参考如何调用API
  2. 发送“POST https://VBS的Endpoint/v2/项目ID/cloudbackups”。
  3. 在Request Header中增加“X-Auth-Token”。
  4. 在Request Body中传入参数如下:
    {
        "backup": {
            "volume_id": "c68ae7fb-0aa5-4a97-ab01-ed02c5b7e768",
            "name": "backup1",
            "description": "Backup_Demo",
            "tags":[{
                "key":"key",
                "value":"value"
             }]
        }
    }

    请求响应成功后,返回job_id。

    若请求失败,则会返回错误码及对应的错误信息说明,详细错误码信息请参考错误码

  1. 根据job_id查询job详情,具体操作请参考查询job的状态

    查询job详情返回状态status为“SUCCESS”,则表示云硬盘备份创建成功。

    请求异常返回值说明请参考错误码

  2. 查询job详情的body体中可以获取到backup_id,即备份ID,根据获取到的备份ID可对备份进行查询、删除、恢复等操作。