文档首页/ 云硬盘备份 VBS/ API参考（巴黎）/ 快速入门
更新时间：2022-02-22 GMT+08:00
查看PDF
分享

快速入门

本节通过调用一系列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可对备份进行查询、删除、恢复等操作。