cdnCacheInvalidation cdncacheinvalidation

提供された URL のリストをDynamic Media CDN(コンテンツ配布ネットワーク)プロバイダーに転送して、HTTP 応答の既存のキャッシュを無効にします。

cdnCacheInvalidation:概要 section-4f70d2bc79d64288b961836ab17e9690

CDN キャッシュの無効化により、CDN ネットワークを介して無効化要求が処理された後、これらの URL に対するすべての HTTP 要求が、Dynamic Mediaネットワーク上の現在の公開済みデータに対して再検証されます。 Dynamic Mediaサービスの URL 構造に接続されておらず、会社の作成時に割り当てられたDynamic Media会社のルート ID と直接一致する URL は、リクエスト全体の API エラーの原因となります。 CDN が無効と見なすことをサポートしていない無効な URL は、また、リクエスト全体の API エラーになります。

使用頻度:ルール

この機能の使用頻度を制御するルールは、Dynamic Mediaの CDN パートナーが制御します。 CDN は、ユーザーに対するサービスの最適なパフォーマンスを維持するために、これらの無効化の応答性を低下させるための裁量を保持します。 Dynamic Mediaにこの機能の過剰使用が通知された場合、Adobeは、会社単位で、またはサービス全体をまたいで、この機能を無効にする必要があります。

確認メール

Dynamic Media CDN パートナーからの確認 E メールは、リストの作成者に送信することも、他の 5 つまでの E メールアドレスに送信することもできます。 API は、電子メールで参照されている URL がクリアされたことを CDN ネットワーク全体に通知すると、確認を送信します。 への 1 回の呼び出し cdnCacheInvalidation は、提供された URL の数が、Dynamic Mediaが 1 回の通知で CDN パートナーに配信できる数を超えた場合に、複数の電子メールを送信できます。 現在のところ、リクエストが 100 個を超える場合に該当しますが、CDN パートナーのリクエストに基づいて変更される可能性があります。

次の日からサポート

6.0

認証済みユーザータイプ section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

パラメーター section-bd1ed2b7419945d19a2ebd5668499f72

入力 ( cdnCacheInvalidationParam)

名前
種類
必須
説明
companyHandle
xsd:string
はい
無効にする URL と関連付けられている会社へのハンドル。
urlArray
types:UrlArray
はい
CDN キャッシュから無効にする URL の最大 1,000 個のリスト。 無効にするには、すべての URL にDynamic Media会社のルート ID が含まれている必要があります。

出力( cdnCacheInvalidationReturn)

名前
種類
必須
説明
invalidationHandle
xsd:string
はい

パージリクエストを参照するハンドル。

The cdnCacheInvalidation API は、ほぼ即座にキャッシュを無効化するようになりました(約 5 秒)。 そのため、通常、無効化ステータスに対するポーリングは必要なくなりました。

estimatedSeconds
xsd:int
はい
パージリクエストが完了するまでの推定秒数。 クライアントは、この時間待ってからステータスをポーリングする必要があります。

section-f414361a58e84dfcbbac30a358d02125

この例では、CDN キャッシュで無効化する 4 つの 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