將提供的URL清單轉送至Dynamic Media CDN(內容分送網路)提供者,使其現有的HTTP回應快取失效。
CDN快取失效會強制這些URL的所有HTTP請求,在透過CDN網路處理此無效請求後,就會根據Dynamic Media網路上目前發佈的資料重新驗證。 任何未連線至Dynamic Media服務URL結構且在建立公司時直接符合指派給Dynamic Media公司的根ID的URL,都會導致整個請求的API錯誤。 任何CDN不支援且認為無效的URL,也會導致整個請求的API錯誤。
使用頻率:規則
Dynamic Media的CDN合作夥伴可控制使用此功能頻率的規則。 CDN仍可自行決定降低這些無效判定的回應速度,以維持其服務對使用者的最佳效能。 如果Dynamic Media收到過度使用此功能的通知,我們需要針對每個公司或整個服務使用停用此功能。
確認電子郵件
Dynamic Media CDN合作夥伴的確認電子郵件可傳送給清單的建立者,或最多5個其他電子郵件地址。 當通知整個CDN網路已清除電子郵件中參考的URL時,API會傳送確認。 如果提供的URL數量超過Dynamic Media可在單一通知上傳送給CDN合作夥伴的數量,則對cdnCacheInvalidation
的單一呼叫可傳送多封電子郵件。 目前則是當請求超過100個URL時,但可能會根據CDN合作夥伴的請求而有所變更。
支援時間
6.0
IpsAdmin
IpsCompanyAdmin
輸入 ( cdnCacheInvalidationParam
)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
companyHandle |
xsd:string |
是 |
與URL連結之公司的控制代碼,要使其失效。 |
urlArray |
類型:UrlArray |
是 |
從CDN快取失效的最多1000個URL清單。 所有URL都必須包含要失效的Dynamic Media公司根ID。 |
輸出( cdnCacheInvalidationReturn
)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
invalidationHandle |
xsd:string |
是 |
引用清除請求的句柄。 cdnCacheInvalidation API現在幾乎立即讓快取失效(~5秒)。 因此,無效狀態的輪詢通常不再需要。 |
estimatedSeconds |
xsd:int |
是 |
完成清除請求的估計秒數。 用戶端應等待此時間再進行輪詢狀態。 |
此範例會要求CDN快取中的四個URL失效。 回應包含作業成功的摘要計數,以及直接從CDN提供的錯誤詳細資訊清單,以協助用戶端使用此功能。
getCdnCacheInvalidationStatus
作業.
請求
<cdnCacheInvalidationParam xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
<companyHandle>c|6</companyHandle>
<urlArray>
<items>http://s7d7.scene7.com/is/image/JJEsquire/11008047?$thumbnail$</items>
<items>http://s7d7.scene7.com/is/image/JJEsquire/11008047?$product$</items>
<items>http://s7d7.scene7.com/is/image/JJEsquire/11008047?$large$</items>
<items>http://s7d7.scene7.com/is/image/JJEsquire/ImageSetConfigDefaults?req=userdata</items>
</urlArray>
</cdnCacheInvalidationParam>
回答
<cdnCacheInvalidationReturn xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
<successCount>4</successCount>
<warningCount>0</warningCount>
<errorCount>0</errorCount>
</cdnCacheInvalidationReturn>