cdnCacheInvalidation

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

cdnCacheInvalidation:について

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

使用頻度：ルール

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

確認Eメール

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

次の日からサポート

6.0

許可されたユーザーの種類

  • IpsAdmin
  • IpsCompanyAdmin

パラメータ

Input ( cdnCacheInvalidationParam)

名前 種類 必須 説明

companyHandle

xsd:string

はい

無効にするURLと関連付けられている会社へのハンドル。

urlArray

型：UrlArray[がた：UrlArray]

はい

CDNキャッシュから無効化する最大1000個のURLのリスト。 無効化するDynamic Media会社のルートIDをすべてのURLに含める必要があります。

Output( cdnCacheInvalidationReturn)

名前 種類 必須 説明

invalidationHandle

xsd:string

はい

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

cdnCacheInvalidation APIは、ほぼ即座にキャッシュを無効化します（約5秒）。 したがって、通常、無効化ステータスのポーリングは不要になりました。

estimatedSeconds

xsd:int

はい

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

例

この例では、4つのURLをCDNキャッシュで無効化します。 応答には、操作の成功の概要カウントと、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>

このページ