アセットのパージ
警告
パージツールおよびAPIは、Rendering APIを使用して配信されるアセットにのみ適用されます。Video APIを使用して配信されるアセットはパージされません。
Imgix上のアセットを削除または更新する必要がある場合は、キャッシュからパージできます。アセットをパージする一般的な理由は以下の通りです:
- 古いまたは不要なアセットがImgixソース経由で配信されている(例:DMCAに準拠して削除が必要)。
- ソース内のアセットを更新したいが、ファイル名の変更ができない。
ご注意ください: アップデートされたアセットの完全な準拠を確保するには、ファイル名を変更して新しいパスを与えるのが最も確実です。アセットのパージは必要な場合にのみ推奨されます。
以下のキャッシュはImgixシステムの外にあるため、パージでは削除されません:
- お客様のソース(Amazon S3、Google Cloud Storageなど)
- Imgix CDNに加えて使用しているサードパーティのCDN
- エンドユーザーのブラウザキャッシュ
- Imgixとエンドユーザー間のISPキャッシュ
そのため、エンドユーザーが古いアセットを見る可能性は依然としてあります。パージ操作に関して支援が必要な場合は、サポートまでご連絡ください。
パージリクエストの実行
パージは、アセット(例:https://assets.imgix.net/dogs.png
)をImgixのキャッシュから削除します。これにより、すべての派生バージョン(例:https://assets.imgix.net/dogs.png?w=400
など)もクリアされます。オリジンソース内の元画像は影響を受けません。
-
パージリクエストの前に、オリジンからアセットを削除または置き換えてください。 検証処理はすべて、オリジン画像が変更されたことを前提としています。
-
パラメータなしでアセットのベースパス(例:
you.imgix.net/your-image.png
)を使用してPurge APIを呼び出します。方法については#methodsをご参照ください。リクエストはすべての派生を一括でパージします。- APIは正常に受信された場合は
200
ステータスコードを返しますが、これは処理完了を意味しません。
- APIは正常に受信された場合は
-
再度アセットを取得して結果を確認します:
- アセットを削除していた場合は、
404
エラーが返るはずです。 - アセットを置き換えた場合は、更新されたバージョンが返されるはずです。
- アセットを削除していた場合は、
Imgix全体でのパージは通常迅速に完了しますが、完了までの時間を保証するものではないため、確認テストを強く推奨します。
パージが内部的にどのように機能するかについて詳しく知りたい方は、以下のImgixブログ記事をご覧ください:What Happens When You Purge an Asset
パージリクエストの方法
ダッシュボードからパージする
Imgixダッシュボードのツールビューを使用するのが、最も簡単なパージ方法です。Purge Single AssetセクションにアセットのImgix URLを貼り付け、Purgeボタンをクリックします。
パージ前に、非ASCII文字をURLエンコードしてください。たとえば、ファイル名にスペースが含まれる場合は、%20
に置き換えます(例:https://assets.imgix.net/image file.png
→ https://assets.imgix.net/image%20file.png
)。
指定された正確なパスのみがパージされます。上記の例では https://assets.imgix.net/image%20file.png
がパージされますが、https://assets.imgix.net/image+file.png
はパージされません。
curlを使ってパージする
コマンドライン操作に慣れている場合、curlが最も迅速です。APIキーを作成または取得し、以下の例に挿入してください(キーにはPurge
権限が必要です)。
POST /api/v1/purge HTTP/1.1
Host: api.imgix.com
Content-Type: application/vnd.api+json
Authorization: Bearer <api-key>
{
"data": {
"attributes": {
"url": "<url-to-purge>",
"source_id": "<source-id>"
},
"type": "purges"
}
}
サブ画像のパージ markやblendとして使用される画像(いわゆる「サブ画像」)は、以下の方法でパージする必要があります:
sub-image: true 属性を追加
URL属性にサブ画像をパラメータとして含める
例:
POST /api/v1/purge HTTP/1.1
Host: api.imgix.com
Authorization: Bearer <api-key>
Content-Type: application/vnd.api+json
{
"data": {
"attributes": {
"url": "<url-to-purge>?mark=<mark-image>&blend=<blend-image>",
"sub_image": true,
"source_id": "<source-id>"
},
"type": "purges"
}
}
Purge APIの詳細やその他の例については、APIドキュメントをご覧ください。
Video APIで配信されるアセットのパージ Video APIで動画を配信・ストリーミングしている場合、パージツールは使用できません。
代わりに以下の方法で動画を削除または更新してください:
オリジンから動画を削除する(72時間以内に削除されます)。
削除を早めるには、Management APIのrefreshエンドポイントを使ってステータスを更新できます。
DMCA削除などの緊急対応では、support@imgix.comまでご連絡ください。
トラブルシューティング パージ後に変更がすぐに反映されない場合、以下を確認してください。
変更が反映されない場合 ブラウザキャッシュのクリア:ローカルキャッシュをクリアすると最新のアセットが取得されます。
プライベートモードで確認:キャッシュの影響を受けずに確認できます。
URLの正確さを確認:パージ対象のURLが一致していることを確認してください。
Web Folder または Web Proxy ソースで画像の代わりにHTMLが表示される オリジンがHTMLページを返している場合、Imgixはそのまま返却します(200 OK)。
これは仕様通りの動作であり、アセットが存在しないか、オリジンが誤って構成されていることを示します。
オリジンで画像ファイルが正しく返ることを確認し、可能であれば正しいMIMEタイプで返すようにしてください。
CDNがImgixの前段にある場合のパージ CDNをImgixの前に配置している場合は、両者が別々のキャッシュ層を持っていることを理解する必要があります。まずCDNをパージし、その後Imgixをパージすることで、完全なキャッシュクリアが保証されます。
最初にCDNのキャッシュをパージします。 CDNのAPIまたは管理画面を使用して該当URLを無効化します。
次にImgixキャッシュをパージします。 Purge APIまたはダッシュボードから操作できます。
順序を逆にすると、CDNが古いデータを返す可能性があり、ユーザーに正しく反映されません。
それでも問題が解決しない場合は、サポートまでご連絡ください。