画像のパージ

注意

パージツールと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ステータスコードを返します。これはパージが完了したことを意味しません。
結果をテストするために、画像を再度取得します。
- 画像を削除した場合、404エラーを受け取るはずです。
- 画像を置き換えた場合、更新されたバージョンが得られるはずです。

パージは通常、imgixシステム全体で迅速に完了しますが、完成時間を保証するものではないので、テストが強く推奨されます。

画像をパージしたときに何が起こるかの詳細については、次のimgixブログ投稿をご覧ください：What Happens When You Purge an Asset

パージリクエストの方法

ダッシュボードからのパージ

imgixダッシュボード内のthe Tools viewを使用するのが、画像をパージする最も簡単な方法です。パージしたい画像のimgix URLをPurge Single Assetセクションのテキストボックスに貼り付けて、Purgeをクリックします。

Screenshot-Purging single asset from Dashboard

パージする前に、安全でない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を入力します。

curl -X POST 'https://api.imgix.com/api/v1/purge' \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data-raw '{ "data": { "attributes": { "url": "<url-to-purge>" }, "type": "purges" } }'

Pythonを使用したパージ

以下はPythonとRequestsライブラリを使用して画像をパージする例です。

import requests
import json
API_KEY = ""  # API key can be found at https://dashboard.imgix.com/api-keys
API_ENDPOINT = "https://api.imgix.com/api/v1/purge"
imgix_url = "https://assets.imgix.net/examples/couple.jpg"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/vnd.api+json",
}
payload = {
    "data": {
        "type": "purges",
        "attributes": {
            "url": imgix_url,
            "source_id": "5ebee107e9c05c0001d9c2d3",
            "sub_image": False,
        }
    }
}
requests.post(url=API_ENDPOINT, headers=headers, data=json.dumps(payload))

サブ画像のパージ

markまたはblendとして使用される画像（「サブ画像」とも呼ばれます）は、サブ画像属性を含めてパージする必要があります。以下の例はコマンドラインを通じてサブ画像のパージを実行します。

curl -X POST 'https://api.imgix.com/api/v1/purge' \
  --header 'Content-Type: application/vnd.api+json' \
  --header 'Authorization: Bearer <api-key>' \
  --data-raw '{ "data": { "attributes": { "url": "<url-to-purge>", "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に連絡して動画を取り下げてください。

画像の保護アカウントの設定とアナリティクス