更新时间:2024-03-21 GMT+08:00

创建预热缓存任务

功能介绍

创建预热任务。

URI

POST /v1.0/cdn/content/preheating-tasks

表1 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

当用户开启企业项目功能时,该参数生效,表示在当前企业项目下添加缓存预热任务,"all"代表所有项目。注意:当使用子帐号调用接口时,该参数必传。

您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

preheating_task

PreheatingTaskRequestBody object

缓存预热设置。

表4 PreheatingTaskRequestBody

参数

是否必选

参数类型

描述

zh_url_encode

Boolean

是否对url中的中文字符进行编码后预热,false代表不开启,true代表开启,开启后仅预热转码后的URL。

urls

Array of strings

需要预热的URL必须带有“http://”或“https://”,多个URL用逗号分隔,目前不支持对目录的预热,单个url的长度限制为4096字符,单次最多输入1000个url。

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

preheating_task

String

任务ID。

请求示例

POST https://cdn.myhuaweicloud.com/v1.0/cdn/content/preheating-tasks?enterprise_project_id=0

{
  "preheating_task" : {
    "urls" : [ "https://www.bxxx/1.txt", "http://www.bxxx/2.txt" ]
  }
}

响应示例

状态码: 200

OK

{
  "preheating_task" : "7620242"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码