画像のパージ
注意
パージツールとAPIは、Rendering APIを使用して提供される画像のみをパージします。Video APIを使用して提供される画像はパージされません。
imgix上で画像を削除または更新する必要がある場合、キャッシュから画像をパージできます。画像をパージする一般的な理由は以下のとおりです:
- 古くなったり、不要な画像がimgixソースを通じて提供されている場合(例:DMCAの準拠のために削除が必要)。
- ソース内の画像を更新したいが、ファイル名の変更ができない場合。
ご注意ください: 更新された画像の準拠を完全に保証するには、ファイル名を変更して画像の新しいパスを設定することが最善です。画像のパージは、絶対に必要な場合のみ推奨されます。
パージは、imgixシステムの外部にある次のいずれからも画像を削除しません:
- あなたのソース(Amazon S3、Google Cloud Storageなど)
- Imgix CDNに加えて使用している可能性のある他の第三者CDN
- 最終ユーザーのブラウザキャッシュ
- imgixと最終ユーザーの間のISPキャッシュ
このため、最終ユーザーが時折古い画像を見ることがあります。パージ操作についての支援が必要な場合は、Supportにご連絡ください。
パージリクエストの作成
パージは画像(例:https://assets.imgix.net/dogs.png
)を私たちのキャッシュから削除し、そのすべての派生形もクリアします(https://assets.imgix.net/dogs.png?w=400
など)。元画像はパージ操作によって影響を受けません。
-
パージリクエストをトリガーする前に、元の場所で画像を削除または置き換えます。 その後のすべての検証ステップは、元画像の状態が変更されたことに依存します。
-
パラメータなしで画像の基本パスのみを使用して、Purge APIを呼び出します(例:
you.imgix.net/your-image.png
)。これにより、この画像のすべての派生形がパージされるため、個々に行う必要はありません。下記の[#methods]で異なる方法について説明します。- APIは正常に受信された場合に
200
ステータスコードを返します。これはパージが完了したことを意味しません。
- APIは正常に受信された場合に
-
結果をテストするために、画像を再度取得します。
- 画像を削除した場合、
404
エラーを受け取るはずです。 - 画像を置き換えた場合、更新されたバージョンが得られるはずです。
- 画像を削除した場合、
パージは通常、imgixシステム全体で迅速に完了しますが、完成時間を保証するものではないので、テストが強く推奨されます。
画像をパージしたときに何が起こるかの詳細については、次のimgixブログ投稿をご覧ください:What Happens When You Purge an Asset
パージリクエストの方法
ダッシュボードからのパージ
imgixダッシュボード内のthe Tools viewを使用するのが、画像をパージする最も簡単な方法です。パージしたい画像のImgix URLをPurge Single Assetセクションのテキストボックスに貼り付けて、Purgeをクリックします。
パージする前に、安全でないASCII文字をエンコードしてください。URLエンコーディングは、安全でないASCII文字を”%“に続いて2桁の16進数で置き換えます。たとえば、ファイル名にスペースが含まれている場合は、スペースを%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を使用したパージ
コマンドラインの使用に慣れている場合は、アセットをパージする最も迅速な方法です。まず、API Keys ページで API キーを確認または作成 してください。API キーには Purge
権限 が必要です。その後は、以下の例のように、API キーとパージしたいアセットの URL を入力するだけです。
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"
}
}
パージAPIについての詳細やその他の例については、Purge API documentationをご覧ください。
動画APIで配信される動画のパージ
Video APIを使用して動画を配信およびストリーミングしている場合、パージサービスおよびツールは動画画像には機能しません。
代わりに、サイト上の動画を削除または更新するには:
- 動画を元の場所から削除すると、72時間以内に動画が削除されます。
- 動画の削除を速めるために、Management APIのrefresh endpointを使用して、元の場所から削除された動画の状態をリフレッシュすることができます。
- DMCAの取り下げの場合は、support@imgix.comに連絡して動画を取り下げてください。