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

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

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

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

単一 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」値を含める必要があることに注意してください。

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

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