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