刷新预热 api¶
POST 获取预热任务列表 tcdn:domain:query¶
POST /prod-api/acdn/tcdn/content/describePushTasks
当 purgeType 等于 prefetch,选择这个接口 describePushTasks 接口,否则选择 describeContentTasks 接口
Body 请求参数
{
"domain": "lw111.ruisuyun.com",
"pageNum": 1,
"pageSize": 10,
"params": {
"beginTime": "2025-10-15 00:00:00",
"endTime": "2025-10-15 23:59:59"
},
"purgeType": "",
"searchHeader": {}
}
请求参数¶
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| Authorization | header | string | 是 | none | |
| body | body | object | 否 | none | |
| » country | body | string | 否 | none | |
| » domain | body | string | 是 | 域名 | none |
| » pageNum | body | integer(int32) | 是 | 当前页数 | none |
| » pageSize | body | integer(int32) | 否 | 每页显示条目个数 | none |
| » params | body | object | 是 | none | |
| »» beginTime | body | string | 是 | 开始时间 | none |
| »» endTime | body | string | 是 | 结束时间 | none |
| » purgeType | body | string | 否 | 查询类型 | url:表示 URL 刷新 |
| » searchHeader | body | object | 否 | 筛选 | none |
| »» status | body | string | 否 | done:表示完成 |
详细说明¶
» purgeType: url:表示 URL 刷新 path:表示目录刷新 prefetch:表示 URL 预热
当查询类型为 prefetch,purgeType 为空
»» status: done:表示完成 process:表示节点刷新中 fail:表示失败
返回示例
200 Response
201 Response
返回结果¶
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | TableDataInfo |
| 201 | Created | none | Inline |
| 401 | Unauthorized | none | Inline |
| 403 | Forbidden | none | Inline |
| 404 | Not Found | none | Inline |
返回数据结构¶
状态码 200
TableDataInfo
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » code | integer(int32) | false | none | none | |
| » msg | string | false | none | none | |
| » rows | [object] | false | none | none | |
| » total | integer(int64) | false | none | none |
数据模型¶
SearchFilterVo
SearchFilterVo
属性¶
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| label | string | false | none | none | |
| value | [string] | false | none | none |
TableDataInfo
TableDataInfo
属性¶
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| code | integer(int32) | false | none | none | |
| msg | string | false | none | none | |
| rows | [object] | false | none | none | |
| total | integer(int64) | false | none | none |
DescribePushTasksReqVO
{
"country": "string",
"domain": "string",
"endTime": "string",
"filters": [
{
"label": "string",
"value": ["string"]
}
],
"pageNum": 0,
"pageSize": 0,
"params": {
"beginTime": "string",
"endTime": "string"
},
"purgeType": "string",
"searchHeader": {},
"searchValue": "string",
"startTime": "string",
"status": "string",
"tableCul": {
"property1": "string",
"property2": "string"
},
"taskId": "string",
"userId": 0
}
DescribePushTasksReqVO
属性¶
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| country | string | false | none | none | |
| domain | string | true | none | 域名 | none |
| endTime | string | false | none | none | |
| filters | [SearchFilterVo] | false | none | none | |
| pageNum | integer(int32) | true | none | 当前页数 | none |
| pageSize | integer(int32) | false | none | 每页显示条目个数 | none |
| params | object | true | none | none | |
| » beginTime | string | true | none | 开始时间 | none |
| » endTime | string | true | none | 结束时间 | none |
| purgeType | string | false | none | 查询类型 | url:表示 URL 刷新 path:表示目录刷新 prefetch:表示 URL 预热 |
| searchHeader | object | false | none | 筛选 | none |
| searchValue | string | false | none | none | |
| startTime | string | false | none | none | |
| status | string | false | none | none | |
| tableCul | object | false | none | none | |
| » additionalProperties | string | false | none | none | |
| taskId | string | false | none | none | |
| userId | integer(int64) | false | none | none |