# 快速入门
本节通过调用云服务器备份的API为某台云服务器创建一次备份。
![](https://support.huaweicloud.com/api-csbs/public_sys-resources/note_3.0-zh-cn.png)
- 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。
 
**涉及API**
当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。
- IAM获取token的API
- CSBS创建资源备份的API
**具体步骤**
1. Token认证，具体操作请参考[构造请求](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0134083760.html)。
2. 获取项目ID，具体操作请参考[获取项目ID](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0136033750.html)。
3. 发送POST请求，请求地址为："https://CSBS的Endpoint//v1/{project_id}/providers/fc4d5750-22e7-4798-8a46-f48f62c4c1da/resources/{resource_id}/action"，其中project_id替换为步骤2中获取到的项目ID，resource_id替换为是云服务器的ID。
4. 在请求消息头中增加"X-Auth-Token"，值为步骤1中获取到的Token。
5. 在请求响应体中传入如下的参数：
   ```
   {
       "protect" : {
           "backup_name" : "database_backup", //备份名称（非必填字符串）
           "description" : "backup for database version 2.2.1 before upgrade."  //备份描述（非必填字符串）
     }
   }
   ```
   请求响应成功后，会返回备份记录id（checkpoint_id），即请求响应体中checkpoint的id。
   若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参考[错误码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0071888297.html)。
   
6. 通过checkpoint_id作为过滤参数查询备份结果，具体接口请参考[查询所有备份](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0059304235.html)，如果备份状态变为可用，代表备份成功。
   请求异常返回值说明请参考[状态码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0134484533.html)。
   
7. 可以从步骤6的请求响应体中获取到备份id，备份完成后，通过备份记录id和备份id可以执行恢复云服务器、删除备份的操作。