刷新節點上的文件內容。被刷新的文件緩存將立即失效,新的請求將回源獲取最新的文件,支持URL批量刷新。
接口說明
- 請求方式:支持 POST 請求,參數用 form 表單顯示。
- 相關接口:刷新預熱類接口包含 RefreshObjectCaches 刷新接口和 PushObjectCache 預熱接口。
- 單用戶調用頻率:50 次/秒。
- 如果您需要自動化刷新或預熱,請參見刷新預熱自動化腳本。
注意事項
- 提交刷新任務并成功執行后,CDN 節點上對應的緩存資源將會失效,當您再次發起訪問請求時,節點會回源站拉取所需資源,并重新緩存在節點上,因此大批量提交刷新任務會清空較多緩存,導致回源帶寬和請求突增,增加源站壓力。
- 刷新任務從提交到生效,大約需要 5~6 分鐘,如果文件或者目錄配置的緩存過期時間少于 5 分鐘,您無需執行刷新操作,等待文件或者目錄緩存超時更新即可。
- 使用 RAM 用戶來執行刷新或預熱操作的,需要先獲得授權,請參見授予 RAM 用戶刷新預熱權限完成授權。
URL 刷新配額
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
cdn:RefreshObjectCaches | none | *Domain acs:cdn:*:{#accountId}:domain/{#DomainName} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ObjectPath | string | 是 |
| http://example.com/image/1.png http://aliyundoc.com/image/2.png |
ObjectType | string | 否 | 刷新類型。取值范圍:
說明
| File |
Force | boolean | 否 | 是否直接刪除 CDN 節點上的緩存。默認為 false。
說明
此參數生效范圍:使用目錄刷新、正則刷新、去參數刷新這三種刷新方式的時候可以生效。
| false |
返回參數
示例
正常返回示例
JSON
格式
{
"RefreshTaskId": "704222901",
"RequestId": "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}
錯誤碼
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. | - |
400 | QuotaExceeded.Refresh | Your refresh attempts have exceeded the daily limit. | 刷新數量超過日quota限額。 |
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 | - |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-11-19 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-10-17 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |