RefreshDcdnObjectCaches - 重新整理緩衝 - Edge Security Acceleration

介面說明

請求方式：支援 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對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dcdn:RefreshDcdnObjectCaches

none

*domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

無

請求參數

名稱	類型	必填	描述	樣本值
ObjectPath	string	是	單次提交多個 URL 或多個目錄時，使用分行符號（\n）或（\r\n）分隔。單次提交的任務中所有 URL 的網域名稱個數總和需要在 10 個以內。	example.com/example.txt
ObjectType	string	否	重新整理類型。取值範圍： File（預設值）：URL。 Directory：目錄。 Regex：正則重新整理。 IgnoreParams：去參數重新整理。去參數指的是去除請求 URL 中`?`及`?`之後的參數，去參數重新整理指的是使用者先通過介面提交去參數後的 URL，然後使用者提交的待重新整理 URL 將會與已緩衝資源的 URL 進行去參數匹配，如果已緩衝資源的 URL 去參數以後與待重新整理 URL 匹配，那麼 CDN 節點將對緩衝資源執行重新整理處理。說明 URL 重新整理和目錄重新整理的功能說明請參考重新整理和預熱資源。檔案重新整理將直接刪除節點上的資源，當有新請求時回源拉取新資源。其它重新整理類型預設只重新整理發生變更的資源，需要強制重新整理請配置 Force 參數為 true，詳見 Force 參數說明。	File
Force	boolean	否	當回源內容和來源站點資源對比一致時，是否重新整理對應範圍內的資源。預設為 false。 true：重新整理對應範圍內的全部資源。選擇 “重新整理全部資源” 時，如果使用者請求的內容匹配到了對應範圍內的資源，DCDN 節點將會直接回源拉取新資源返回給使用者，並重新緩衝該資源。 false：重新整理對應範圍內發生變更的資源。選擇 “重新整理變更資源” 時，如果使用者請求的內容匹配到了對應範圍內的資源，DCDN 節點將會回源擷取資源的 Last-Modified 資訊，若與當前緩衝資源一致，則直接返回已緩衝資源，若不一致，則回源拉取新資源返回給使用者，並重新緩衝該資源。說明此參數生效範圍：除檔案重新整理外的重新整理類型	false

返回參數

名稱	類型	描述	樣本值
	object
RefreshTaskId	string	重新整理返回的任務 ID。多個 ID 用逗號（,）分隔。	95248880
RequestId	string	請求 ID。	E5BD4B50-7A02-493A-AE0B-97B9024B4135

樣本

正常返回樣本

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	提交太頻繁，請稍候再試

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。