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

查询刷新预热任务

功能介绍

查询刷新预热任务。

URI

GET /v1.0/cdn/historytasks

表1 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子帐号调用接口时,该参数必传。

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

page_size

Integer

单页最大数量,取值范围为1-10000。page_size和page_number必须同时传值。默认值30。

page_number

Integer

当前查询第几页,取值范围为1-65535。默认值1。

status

String

任务状态。 task_inprocess 表示任务处理中,task_done表示任务完成。

start_date

Long

查询起始时间,相对于UTC 1970-01-01到当前时间相隔的毫秒数。

end_date

Long

查询结束时间,相对于UTC 1970-01-01到当前时间相隔的毫秒数。

order_field

String

用来排序的字段,支持的字段有“task_type”:任务的类型,“total”:url总数,“processing”:处理中的url个数, “succeed”:成功处理的url个数,“failed”:处理失败的url个数,“create_time”:任务的创建时间。order_field和order_type必须同时传值,否则使用默认值"create_time" 和 "desc":降序。

order_type

String

desc:降序,或者asc:升序。默认值desc。

file_type

String

文件类型,file:文件;directory:目录。

task_type

String

任务类型,refresh:刷新任务;preheating:预热任务。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

total

Integer

总共的任务个数。

tasks

Array of TasksObject objects

日志列表数据

表4 TasksObject

参数

参数类型

描述

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

url总数。

create_time

Long

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

file_type

String

文件类型,file:文件;directory:目录。

请求示例

GET https://cdn.myhuaweicloud.com/v1.0/cdn/historytasks?status=task_inprocess&page_size=30&page_number=1&enterprise_project_id=0

响应示例

状态码: 200

OK

{
  "total" : 2,
  "tasks" : [ {
    "id" : "ff8080xxxxxxxxxxxxd816ff0128",
    "status" : "task_inprocess",
    "processing" : 2,
    "succeed" : 0,
    "failed" : 0,
    "task_type" : "refresh",
    "total" : 2,
    "create_time" : 1534240233215,
    "file_type" : "file"
  }, {
    "id" : "ff8080xxxxxxxxxxx4fe64797",
    "status" : "task_inprocess",
    "processing" : 1,
    "succeed" : 0,
    "failed" : 0,
    "task_type" : "refresh",
    "total" : 1,
    "create_time" : 1534240219944,
    "file_type" : "file"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码