
# 快速入门
本节通过调用一系列VBS的API创建云硬盘备份。
![](https://support.huaweicloud.com/api-vbs/public_sys-resources/note_3.0-zh-cn.png)
- 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。
 
#### 涉及API
当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。
- IAM获取token的API
- VBS创建备份的API
 
#### 具体步骤
1. Token认证，具体操作请参考[如何调用API](https://support.huaweicloud.com/api-vbs/zh-cn_topic_0061309466.html)。
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。
   若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参考[错误码](https://support.huaweicloud.com/api-vbs/zh-cn_topic_0022472083.html)。
   

5. 根据job_id查询job详情，具体操作请参考[查询job的状态](https://support.huaweicloud.com/api-vbs/zh-cn_topic_0020237251.html)。
   查询job详情返回状态status为"SUCCESS"，则表示云硬盘备份创建成功。
   请求异常返回值说明请参考[错误码](https://support.huaweicloud.com/api-vbs/zh-cn_topic_0022472083.html)。
   
6. 查询job详情的body体中可以获取到backup_id，即备份ID，根据获取到的备份ID可对备份进行查询、删除、恢复等操作。
 
