ドキュメントAEMDynamic Media Image Production System API

cdnCacheInvalidation cdncacheinvalidation

最終更新日： 2025年8月14日

作成対象：

  • Developer
  • Admin

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

cdnCacheInvalidation：概要 section-4f70d2bc79d64288b961836ab17e9690

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

使用頻度：ルール

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

確認メール

Dynamic Media CDN パートナーからの確認メールは、リストの作成者または他の最大5つのメールアドレスに送信できます。 このAPIは、メールで参照されているURLがクリアされたことをCDN ネットワーク全体に通知したときに確認を送信します。 指定されたURLの数が、1つの通知で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が含まれている必要があります。

Output （cdnCacheInvalidationReturn）

名
タイプ
が必要
説明
無効化ハンドル
xsd:string
はい

パージ要求を参照するハンドル。

cdnCacheInvalidation APIは、ほぼ即座に（約5秒）キャッシュを無効化するようになりました。 そのため、無効化ステータスのポーリングは一般的に不要になります。

推定秒数
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
dynamic-media-developer-resources-help-aem-ips-api