將提供的URL清單轉送給Dynamic Media CDN (內容發佈網路)提供者,以使其現有的HTTP回應快取失效。
在透過CDN網路處理此失效請求後,CDN快取失效會強制根據Dynamic Media網路上的目前發佈資料重新驗證這些URL的所有HTTP請求。 未連線至Dynamic Media服務URL結構且直接比對公司建立時指派的Dynamic Media公司根ID的任何URL,都會導致整個請求的API錯誤。 CDN不支援且視為無效的任何無效URL也會導致整個請求的API錯誤。
使用頻率:規則
規範使用此功能頻率的規則由Dynamic Media的CDN合作夥伴控制。 CDN保留降級這些無效回應能力的酌情權,以維持其為使用者提供的最佳服務效能。 如果Dynamic Media收到過度使用此功能的通知,Adobe必須根據每個公司或整個服務來停用此功能。
確認電子郵件
來自Dynamic Media CDN合作夥伴的確認電子郵件可以傳送給清單的建立者或最多5個其他電子郵件地址。 當通知整個CDN網路電子郵件中參照的URL已清除時,API會傳送確認。 單一呼叫 cdnCacheInvalidation
如果提供的URL數量超過Dynamic Media在單一通知中可傳送給CDN合作夥伴的數量,則可傳送多封電子郵件。 目前這表示要求超過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>