呼叫本介面將來源網站的內容主動預熱到 L2 Cache 節點上，首次存取可直接命中快取，緩解來源網站壓力。
介面說明
目前服務地址僅支援：華東 2（上海）。
同一帳號每天最多可提交預熱 URL 請求共 500 條，目前不支援目錄層級的預熱。
重新整理預熱類介面包含 RefreshVodObjectCaches 重新整理介面和 PreloadVodObjectCaches 預熱介面。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vod:PreloadVodObjectCaches |
update |
*All Resource
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ObjectPath |
string |
是 |
預熱檔案 URL。多個 URL 使用換行符號（\n 或 \r\n）分隔。 |
vod.test.com/test.txt |
| Area |
string |
否 |
預熱區域，取值：domestic、overseas。 |
domestic |
| L2Preload |
boolean |
否 |
是否直接預熱到 L2 節點。取值：
|
true |
| WithHeader |
string |
否 |
預熱請求預設攜帶的 header 是 Accept-Encoding:gzip，如果您需要預熱請求攜帶其他 header，或者實現多副本預熱，那麼可以使用該參數來實現自訂預熱 header。請以 JSON 字串格式提交。 |
{ "Accept-Encoding": [ "gzip, deflate, br" ] } |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回結果。 |
||
| PreloadTaskId |
string |
預熱返回的工作 ID。多個工作 ID 用半形逗號（,）分隔。 |
9524**** |
| RequestId |
string |
請求 ID。 |
E5BD4B50-7A02-493A-*****-97B9024B4135 |
樣本
正常返回樣本
JSON格式
{
"PreloadTaskId": "9524****",
"RequestId": "E5BD4B50-7A02-493A-*****-97B9024B4135"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | SingleRequest.OverLimit | A maximum of 1000 URLs are supported for each request. | |
| 400 | QuotaExceeded.Preload | Your refresh attempts have exceeded the daily limit. | |
| 400 | InvalidObjectPath.Malformed | The specified ObjectPath is invalid. | |
| 400 | InvalidExtensiveDomain.ValueNotSupported | The specified ExtensiveDomain is not supported. | |
| 400 | PreloadQueueFull | The warming queue is full; please try again later. | |
| 400 | InvalidCustomHeader | Parse preload header failed. | |
| 404 | InvalidDomain.Offline | The domain provided is offline. | |
| 404 | InvalidDomain.NotFound | The domain provided does not belong to you. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。