# 创建缓存刷新预热任务
#### 场景描述
本章节指导用户通过API创建缓存刷新、预热任务，API的调用方法请参见[如何调用API](https://support.huaweicloud.com/api-cdn/cdn_02_0019.html)。
#### 涉及API
- 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。
- [创建预热缓存任务](https://support.huaweicloud.com/api-cdn/CreatePreheatingTasks.html)：将源站资源预热到CDN节点。
- [创建刷新缓存任务](https://support.huaweicloud.com/api-cdn/CreateRefreshTasks.html)：将CDN节点缓存资源刷新。
 
#### 操作步骤
1. [获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)，用于调用创建缓存刷新、预热接口时进行认证鉴权，具体操作请参考[构造请求](https://support.huaweicloud.com/api-cdn/cdn_02_0029.html)。
   - ***username和*** ***domainname***可以在"华为云控制台\>右上方账号名称\>我的凭证"页面获取。
   
   - 请求URL：POST https://iam.myhuaweicloud.com/v3/auth/tokens
   
   - 请求头消息：Content-Type：application/json
   
   - 请求体：
     ```
     {
     "auth": {
     "identity": {
     "methods": ["password"],
     "password": {
     "user": {
     "name": "name",           --用户名
     "password": "password",       --密码
     "domain": {
     "name": "domainname"    --用户所属的账号名称
     }
     }
     }
     },
     "scope": {
     "domain": {
     "name": "domainname"    --用户所属的账号名称
     }
     }
     }
       }
     ```
     
   
   
   如下图所示，红框中的信息为获取用户Token。
   ![](https://support.huaweicloud.com/api-cdn/zh-cn_image_0000001174839410.png)
   ![](https://support.huaweicloud.com/api-cdn/public_sys-resources/note_3.0-zh-cn.png)
   您还可以在在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=IAM&api=KeystoneCreateUserTokenByPassword)中运行调试获取Token。
   
2. **创建预热缓存任务**
   1. 选择**POST** 请求方法并输入请求URI。
      ```
      POST  https://cdn.myhuaweicloud.com/v1.0/cdn/content/preheating-tasks
      ```
      
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 在Request Body中传入参数如下：
      ```
      {
         "preheating_task": {
             "urls": [
                 "https://www.bxxx/1.txt",
                 "https://www.bxxx/2.txt"
             ]
         }
       }
      ```
      
   
   4. 响应示例。
      ```
      {
       "preheating_task": "7620240"
       }
      ```
      
   
   5. 若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。
    
3. **创建刷新缓存任务**
   1. 选择**POST** 请求方法并输入请求URI。
      ```
      POST  https://cdn.myhuaweicloud.com/v1.0/cdn/content/refresh-tasks
      ```
      
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 在Request Body中传入参数如下：
      ```
      {
         "refresh_task": {
             "type": "file",
             "urls": [
                 "https://www.bxxx/1.txt",
                 "https://www.bxxx/2.txt"
             ]
          }
       }
      ```
      
   
   4. 响应示例。
      ```
      {
       "refresh_task": "7620242"
       }
      ```
      
   
   5. 若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。