文件Dynamic Media Image Production System API

cdnCacheInvalidation cdncacheinvalidation

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
  • 管理員

將提供的URL清單轉送給Dynamic Media CDN （內容發佈網路）提供者，以使其現有的HTTP回應快取失效。

cdnCacheInvalidation：關於 section-4f70d2bc79d64288b961836ab17e9690

在透過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會傳送確認。 如果提供的URL數目超過Dynamic Media在單一通知上可傳送給CDN合作夥伴的數目，則對cdnCacheInvalidation的單一呼叫可傳送多封電子郵件。 目前這表示要求超過100個URL，但可能根據CDN合作夥伴的要求而有所變更。

自 ​起便支援

6.0

授權的使用者型別 section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

參數 section-bd1ed2b7419945d19a2ebd5668499f72

輸入 ( cdnCacheInvalidationParam)

名稱
型別
需要
描述
companyHandle
xsd：string
是
與要失效的URL連結的公司控制代碼。
urlArray
型別：UrlArray
是
要從CDN快取中失效的1000個URL清單。 所有URL都必須包含Dynamic Media公司根ID，才能失效。

輸出( cdnCacheInvalidationReturn)

名稱
型別
需要
描述
invalidationHandle
xsd：string
是

參照清除請求的控點。

cdnCacheInvalidation API現在幾乎立即讓快取失效（~5秒）。 因此，通常不再需要輪詢失效狀態。

estimatedSeconds
xsd：int
是
預計完成清除要求的秒數。 使用者端應等待此時間，再輪詢狀態。

範例 section-f414361a58e84dfcbbac30a358d02125

此範例要求在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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681