缓存预热。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SiteId |
integer |
否 |
站点 ID，可通过调用 ListSites 接口获取。 |
123456789**** |
| Content |
array |
否 |
预热对象。 |
|
|
string |
否 |
单个预热对象。 重要 URL 的 hostname 必须是当前站点（SiteId 指定）下 Proxied=true 的 DNS 记录名（RecordName），可通过 ListRecords API（传入 SiteId）查询获取。使用未配置的域名将返回 InvalidParameter.RecordNotBelongToSite 错误。 |
http://a.com/1.jpg?b=1 |
|
| Headers |
object |
否 |
预热请求默认携带的 header 是 Accept-Encoding:gzip，如果您需要预热请求携带其他 header，或者实现多副本预热，那么可以使用该参数来实现自定义预热 header。 |
|
|
string |
否 |
请求头。 |
Accept-Encoding:gzip |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID |
9732E117-8A37-49FD-A36F-ABBB87556CA7 |
| TaskId |
string |
任务 ID，当您创建预热任务时，会返回任务 ID。 |
16401427840 |
示例
正常返回示例
JSON格式
{
"RequestId": "9732E117-8A37-49FD-A36F-ABBB87556CA7",
"TaskId": "16401427840"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | 请同时提供开始时间和结束时间。 |
| 400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | 您填入的结束时间早于开始时间，请检查后重试。 |
| 400 | DomainNameOverLimit | A maximum of 500 domains are supported for each request. | 一次最多只支持500个域名，请减少域名重新请求。 |
| 400 | InvalidTime | The query time cannot exceed the last 3 days. | 查询时间不能超过最近3天。 |
| 400 | MissingParameter.ObjectType | The ObjectType parameter is required if DomainName or ObjectType is specified. | 请填写ObjectType参数。 |
| 400 | InvalidStationParameter | The specified Station is invalid. | 指定的节点参数无效。 |
| 400 | TooManyRequests | Too many requests.Please try again later. | 请求过于频繁，请稍后重试。 |
| 400 | InvalidTaskId.Malformed | The specified taskId is invalid. | 指定的任务ID无效。 |
| 400 | InvalidParameters.InvalidUrls | The specified urls are invalid. | 请求的URL参数无效。 |
| 400 | QuotaExceeded | You attempts have exceeded the daily limit. | 超出当日配额限制。今日提交数量已用完。您可以通过配额接口查询今日的可使用次数。 |
| 400 | InvalidParameter.RecordNotBelongToSite | The record name passed in does not belong to the current site. | 传入的记录名不属于当前站点。 |
| 400 | PreloadQueueFull | The prefetch queue is full. Try again later. | 预热队列已满，需要等待队列消化后再重试。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。