更新时间:2024-05-08 GMT+08:00

创建预热缓存任务

功能介绍

创建预热任务。

URI

POST /v1.0/cdn/preheatingtasks

参数说明请参见表1

表1 参数说明

名称

是否必选

参数类型

描述

enterprise_project_id

String

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

请求消息

请求参数

请求参数如表2所示。

表2 请求参数

名称

是否必须

参数类型

描述

urls

Array of strings

输入示例:http://abc.com/image/1.png,多个URL之间需要用逗号分隔,目前不支持对目录的预热,单个url的长度限制为10240字符,单次最多输入1000个url。

请求示例

请求路径示例

POST https://cdn.myhuaweicloud.com/v1.0/cdn/preheatingtasks?enterprise_project_id=0
{
    "preheatingTask":{
        "urls":[
            "http://www.example1.com/index.html",
            "http://www.example2.com/web"
            ]
        }
}

响应消息

响应参数

响应参数如表3所示。

表3 响应参数

名称

参数类型

描述

id

String

任务id。

task_type

String

任务的类型, 其值可以为refresh| preheating。

status

String

预热结果。task_done表示预热成功

,task_inprocess表示预热中。

processing

Integer

处理中的url个数。

succeed

Integer

成功处理的url个数。

failed

Integer

处理失败的url个数。

total

Integer

总共的任务个数。

create_time

Integer

任务创建时间,相对于UTC 1970-01-01到当前时间相隔的毫秒数。

urls

Array of strings

预热的url。

响应示例
{
  "preheatingTask" : {
    "id" : "ff8080*********************c6e",
    "status" : "task_inprocess",
    "processing" : 2,
    "succeed" : 0,
    "failed" : 0,
    "urls" : [ "http://www.example1.com/index.html", "http://www.example2.com/web" ],
    "task_type" : "preheating",
    "total" : 2,
    "create_time" : 0
  }
}

状态码

状态码请参见状态码

错误码

请参见错误码