RefreshVodObjectCaches - 重新整理緩衝 -

介面說明

目前服務地址僅支援：華東 2（上海）。
同一帳號每天最多可提交重新整理 URL 請求共 2000 條，重新整理目錄共 100 個。
重新整理預熱類介面包含 RefreshVodObjectCaches 重新整理介面和 PreloadVodObjectCaches 預熱介面。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:RefreshVodObjectCaches

update

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
ObjectPath	string	是	預熱檔案 URL。多個 URL 使用分行符號（\n 或\r\n）分隔。	abc.com/image/1.png
ObjectType	string	否	重新整理的類型。取值： File（預設值）：檔案重新整理。 Directory：目錄重新整理。 Regex：正則重新整理。 IgnoreParams：去參數重新整理。去參數指的是去除請求 URL 中?及?之後的參數，去參數重新整理指的是使用者先通過介面提交去參數後的 URL，然後使用者提交的待重新整理 URL 將會與已緩衝資源的 URL 進行去參數匹配，如果已緩衝資源的 URL 去參數以後與待重新整理 URL 匹配，那麼 CDN 節點將對緩衝資源執行重新整理處理。	File
Force	boolean	否	當回源內容和來源站點資源對比後不一致時，是否重新整理對應目錄下的資源。預設為 false。 true：重新整理對應目錄下的全部資源。選擇 “重新整理全部資源” 時，如果使用者請求的內容匹配到了目錄下的資源，CDN 節點將會直接回源拉取新資源返回給使用者，並重新緩衝該資源。 false：重新整理對應目錄下發生變更的資源。選擇 “重新整理變更資源” 時，如果使用者請求的內容匹配到了目錄下的資源，CDN 節點將會回源擷取資源的 Last-Modified 資訊，若與當前緩衝資源一致，則直接返回已緩衝資源，若不一致，則回源拉取新資源返回給使用者，並重新緩衝該資源。	false

返回參數

名稱	類型	描述	樣本值
	object
RefreshTaskId	string	重新整理返回的任務 ID。多個任務 ID 用半形逗號（,）分隔。重新整理返回的任務 ID 會按照以下兩條規則對重新整理任務做合并：同一個網域名稱、同一秒鐘提交的重新整理任務（URL 顆粒度）會被合并為同一個 RefreshTaskId。同一個網域名稱、同一秒鐘提交的重新整理任務（URL 顆粒度）如果超過 2000 條，那麼會按照每 2000 條合并為一個 RefreshTaskId 的方式處理。	70422*****2904
RequestId	string	請求 ID。	D61E4801-EAFF-4A63-****-FBF6CE1CFD1C

樣本

正常返回樣本

JSON格式

{
  "RefreshTaskId": "70422*****2904",
  "RequestId": "D61E4801-EAFF-4A63-****-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.
400	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	超出當日重新整理額度限制。
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.	參數ObjectPath無效。
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.
404	InvalidDomain.NotFound	The domain provided does not belong to you.
404	InvalidDomain.Offline	The domain provided is offline.

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

變更歷史

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