パージ
性能上の理由から、imgix はできるだけ長い間オリジンアセットをキャッシュしようとしますが、オリジンのアセットが変更された場合は、imgix が最新バージョンを取得するためにそれをパージしたいかもしれません。こちらをクリックして パージの概要をご覧ください。
パージリクエストが成功した場合、200 ステータスコードが返されます。同じ画像 URL に対するパージリクエストは、少なくとも 10 秒間隔を空ける必要があります。それ以外の場合、重複したパージリクエストがあることを示す 409 ステータスコードが返されます。パージリクエストは重複していても成功します。
mark を持つ画像や blend を持つ画像は、それが更新される必要がない限り、特別な方法でパージする必要はありません。その場合は、以下のサブイメージのパージセクションを参照してください。
パージ操作
パージ操作には Purge 権限が必要です。
| エンドポイント | メソッド | 説明 |
|---|---|---|
purge | POST | imgix キャッシュからアセットを削除する |
パージ属性
| フィールド | タイプ | 必須？ | 説明 |
|---|---|---|---|
url | String | Yes | パージするアセットの完全修飾URL。パラメーターは渡す必要はありません。パージはベースURLのすべての派生コピーを削除します。URLのドメインは、現在のアカウントに関連付けられているものである必要があります。 |
サブイメージのパージ
mark として使用される画像や blend として使用される画像を「サブイメージ」と呼びます。mark や blend を適用された画像を「親画像」と呼びます。オリジンでサブイメージが更新された場合、親画像が更新されたサブイメージを取り込むために、サブイメージをパージする必要があります。
サブイメージをパージするには、source_id も必要です。サブイメージのパージは、サブイメージを mark として使用する親画像もパージします。
サブイメージのパージ属性
| フィールド | タイプ | 必須？ | 説明 |
|---|---|---|---|
url | String | Yes | パージするサブイメージの完全修飾 URL。 |
sub_image | Boolean | Yes | url がサブイメージを参照しているかどうか。 |
source_id | String | Yes | サブイメージの親画像が関連付けられているソースの ID。 |
パージの例
画像アセットのパージ
POST /api/v1/purge
{
"data": {
"attributes": {
"url": "https://assets.imgix.net/examples/bridge.jpg"
},
"type": "purges"
}
}{
"data": {
"attributes": {
"purge_id": "a794e260-3776-4efe-9878-35acec6980b6"
},
"id": "a794e260-3776-4efe-9878-35acec6980b6",
"type": "purges"
},
"included": [],
"jsonapi": {
"version": "1.0"
},
"meta": {
...
}
}サブイメージのパージ
POST /api/v1/purge
{
"data": {
"attributes": {
"url": "https://assets.imgix.net/examples/bridge.jpg",
"sub_image": true,
"source_id": "5b81e81539ddc50001a5d955"
},
"type": "purges"
}
}{
"data": {
"attributes": {
"purge_id": "63bb029f-6d0a-4e46-9d33-7183c7b536ef"
},
"id": "63bb029f-6d0a-4e46-9d33-7183c7b536ef",
"type": "purges"
},
"included": [],
"jsonapi": {
"version": "1.0"
},
"meta": {
...
}
}