创建缓存刷新预热任务

场景描述

本章节指导用户通过API创建缓存刷新、预热任务，API的调用方法请参见如何调用API。

涉及API

当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。
创建预热缓存任务：将源站资源预热到CDN节点。
创建刷新缓存任务：将CDN节点缓存资源刷新。

操作步骤

获取用户Token，用于调用创建缓存刷新、预热接口时进行认证鉴权，具体操作请参考构造请求。
- 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。
创建预热缓存任务
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. 若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参见错误码。
创建刷新缓存任务
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. 若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参见错误码。