1. パージの種類
挙動の異なる2種類のパージを実行可能です。
パージ | 処理の挙動 | アクセス時の挙動 |
---|---|---|
instant purge | キャッシュを強制的に削除します。 | オリジンからコンテンツを取得します。 |
soft purge | キャッシュを「期限切れ」状態にします。 | オリジンに更新の有無を問い合わせて更新があれば再取得(更新がなければキャッシュ上のコンテンツを再利用)します。 |
上記以外のパージ種類についてはこちらをご確認ください。
2. サービスIDの取得方法 *
*サービスID・APIキーの取得方法はこちらのページにも詳細を記載しています。
CDNのサービスを作成いただくと、CDNの一覧にサービスが表示されます。
新規サービスの作成については、ご利用ガイド「CDNの利用方法:新規サービスの作成」で確認できます。
サービス名をクリックします。
次のようにポップアップが表示されますので、こちらでサービスIDを確認します。
こちらが、CDNのサービスIDとなります。
CDNの設定画面の基本設定のIDを確認します。
3. API KEYの取得方法
APIをリクエストする際に必要となるAPI KEYは下記の手順にて確認します。
1-1.CDNサービスをご利用の場合
メニューから「API」をクリックします。
1-2.他のIDCFサービスをご利用の場合(参考)
メニューから「API」または「申し込み情報」をクリックします。次の画面に遷移後、改めて「連携アカウント」をクリックします。
2.連携アカウントのFastly
Fastlyのタブをクリック後、下記の画面からAPI KEYの取得ができます。
API KEYは秘密鍵になりますので大切に保管してください。
4.API呼び出し例
下記のようなコマンドにて様々なAPIが活用できます。
消したいキャッシュのURLに対してPURGEメソッドをリクエスト(認証不要)
実際の設定例
1 2 | $ curl -X PURGE http: //www.example.com/image.jpg |
実行結果例
1 2 | { "status" : "ok" , "id" : "11959-1620304722-176045" } |
※ソフトパージの場合は -H "Fastly-Soft-Purge:1" を追加
サロゲートキー(キャッシュキー)で指定
実際の設定例
1 2 3 4 5 | $ curl -X POST https: //cdn.idcfcloud.com/api/v1/service/(SERVICE_ID)/purge \ -d '{"surrogate_keys":["/foo/index.html", "/bar/*", "/*.jpg"]}' \ -H "X-IDCF-CDN-APIKEY: (API_KEY)" \ -H "Accept: application/json" |
実行結果例
1 2 | { "\/foo\/index.html" : "11936-1620242967-510762" , "\/bar\/*" : "11936-1620242967-510763" , "\/*.jpg" : "11936-1620242967-510763" } |
※ソフトパージの場合は -H "Fastly-Soft-Purge:1" を追加
全キャッシュ削除
実際の設定例
1 2 | $ curl -X PURGE http: //www.example.com/image.jpg |
実行結果例
1 2 | { "status" : "ok" , "id" : "11959-1620304722-176045" } |
5.URL指定のパージ処理に認証をかける方法
URL指定のパージ処理に認証をかける方法をご紹介します。
設定方法
vcl_recv に下記VCLを追加します。
1 2 3 4 5 | if ( req.request == "FASTLYPURGE" ) { # Header rewrite Fastly Purge : 10 set req.http.Fastly-Purge-Requires-Auth = "1" ; } |
パージ方法
上記VCLによりPURGEメソッドは拒否されるようになるので、パージしたい場合はAPI KEYを添えてPOSTメソッドで呼び出します。
実際の設定例
1 2 3 4 5 | $ curl -X POST \ https: //cdn.idcfcloud.com/api/v1/service/3eVLUhRFQlxS6BTHEVBEdr/purge/https://xxxxxxxxx.cdn.jp.idcfcloud.com/img/example.jpg \ -H "X-IDCF-CDN-APIKEY: xXxxXXxxxXXxxxXXxxXxx" |
実行結果例
1 2 | { "status" : "ok" , "id" : "99999-9999999999-99999999" } |
以上でご説明は完了です。CDNに関するその他情報はこちらで確認できます。