CDN キャッシュのパージ cdn-purge-cache

パージでは、Adobe CDN キャッシュからオブジェクトが削除されるので、その後のリクエストはキャッシュから提供されるのではなく、キャッシュミスとして接触チャネルに向かいます。
AEM as a Cloud Service を使用すると、API 呼び出しのパージで使用できる API トークンのパージを設定できます。Cloud Manager 設定パイプライン認証ディレクティブを使用してこのトークンを設定する方法については、CDN 資格情報および認証の設定を参照してください。

サポートされているパージには、次の 3 つのバリエーションがあります。

すべてのパージバリエーションで次の点は共通しています。

パージキーの設定と CDN キャッシュパージの実行に焦点を当てたチュートリアルを参照してください。

単一 URL パージ single-purge

次の手順で、一度に 1 つのリソースをパージできます。

curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com/resource-path" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H 'X-AEM-Purge: soft'

上記の例に示すように、オプション ​で、キャッシュされたオブジェクトに対して CDN で​ ハード ​パージ（デフォルト）を実行するか​ ソフト ​パージを実行するかを指定できます。

デフォルトのハードパージでは、コンテンツがオリジンから取得されるまで、新しいリクエストはコンテンツには直ちにアクセスできなくなります。ソフトパージでは、コンテンツが古いとマークされますが、クライアントには引き続き提供されるので、コンテンツがオリジンから取得されるまで待つ必要はありません。

代理キーによるパージ surrogate-key-purge

代理キーは、一連のコンテンツをパージするために使用する一意の ID です。応答に Surrogate-Key ヘッダーを追加し、コンテンツに適用されます。1 つ以上の代理キーをパージ API 呼び出しで参照できます。

curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H "Surrogate-Key: my-surrogate-key"
-H "X-AEM-Purge: soft" #optional

複数の Surrogate-Key はスペースで区切ります。単一 URL パージと同様に、ハードパージかソフトパージのどちらかを設定できます。

完全パージ full-purge

キャッシュされたすべてのリソースの完全パージは、次の手順で実行できます。

curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H "X-AEM-Purge: all"

X-AEM-Purge ヘッダーには「all」値を含める必要があることに注意してください。

顧客管理 CDN とのインタラクション

顧客管理 CDN の場合は、X-Forwarded-Host と X-AEM-Edge-Key も指定する必要があります。

curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com/resource-path" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H 'X-AEM-Edge-Key: <my_edge_key>' \
-H 'X-Forwarded-Host: <my_forwarded_domain>'

Apache／Dispatcher レイヤーとのインタラクション apache-layer

コンテンツ配信フローで説明されているように、キャッシュの有効期限が切れている場合、CDN は Apache／Dispatcher レイヤーからコンテンツを取得します。つまり、CDN でリソースをパージする前に、コンテンツの新しいバージョンを Dispatcher でも確実に入手できるようにする必要があります。詳しくは、Dispatcher キャッシュの無効化も参照してください。