調用RefreshDcdnObjectCaches刷新節點上的文件內容、刷新指定URL內容至Cache節點。支持URL批量刷新。
接口說明
- 請求方式:支持 POST 請求,參數用 form 表單顯示。
- 相關接口:刷新預熱類接口包含 RefreshDcdnObjectCaches 刷新接口和 PreloadDcdnObjectCaches 預熱接口。
- URL 刷新配額(每日):默認情況下,一個賬號每日最多可以提交 10000 條 URL 刷新和 100 個目錄刷新,目錄刷新包含子目錄。如果您的阿里云賬號的日帶寬峰值大于 200 Mbps,您可以通過配額管理申請提升每日配額,阿里云將根據您業務的實際需求進行評估和配置。
- 每次請求最多支持提交 1000 條 URL 刷新或者 100 個目錄刷新。
- 單個域名每分鐘最多支持提交 10000 條 URL 刷新。
- 單用戶調用頻率:30 次/秒。
注意事項
- 提交刷新任務并成功執行后,DCDN 節點上對應的緩存資源將會失效,當您再次發起訪問請求時,節點會回源站拉取所需資源,并重新緩存在節點上,因此大批量提交刷新任務會清空較多緩存,導致回源帶寬和請求突增,增加源站壓力。
- 刷新任務從提交到生效,大約需要 5~6 分鐘,如果文件或者目錄配置的緩存過期時間少于 5 分鐘,您無需執行刷新操作,等待文件或者目錄緩存超時更新即可。
- 使用 RAM 用戶來執行刷新或預熱操作的,需要先獲得授權,請參見授予 RAM 用戶刷新預熱權限完成授權。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ObjectPath | string | 是 |
| example.com/example.txt |
ObjectType | string | 否 | 刷新類型。取值范圍:
說明
| File |
Force | boolean | 否 | 當回源內容和源站資源對比一致時,是否刷新對應范圍內的資源。默認為 false。
說明
此參數生效范圍:除文件刷新外的刷新類型
| false |
返回參數
示例
正常返回示例
JSON
格式
{
"RefreshTaskId": "95248880",
"RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | SingleRequest.OverLimit | A maximum of 1000 URLs are supported for each request. | - |
400 | InvalidObjectType.Malformed | The specified ObjectType is invalid. | 不支持該ObjectType,請重新輸入。 |
400 | InvalidObjectPath.Malformed | The specified ObjectPath is invalid. | ObjectPath錯誤,請填寫正確的ObjectPath。 |
400 | QuotaExceeded.Refresh | Your refresh attempts have exceeded the daily limit. | 超出當日刷新限制。今日刷新數已用完。您可以通過刷新接口查詢今日的刷新次數。 |
400 | InvalidExtensiveDomain.ValueNotSupported | The specified ExtensiveDomain is not supported. | 不支持泛域名。 |
400 | QuotaPerMinuteExceeded.Refresh | You tried to refresh too frequently; please try again later. | 刷新太頻繁,請稍后再試。 |
400 | TooMany.Refresh | The refresh queue is full; please try again later. | 域名正在刷新的個數已經達到上限,請稍后再試。 |
429 | TooManyRequests | Too many requests, please try again later | 提交太頻繁,請稍候再試 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-10-17 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-07-03 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |