キャッシュの消去(DELETE /v1/services/{service_id}/assets)

service_idで指定する配信設定上でキャッシュされたコンテンツを、相対URL指定でエッジサーバ上から消去します。

消去は、HTTPとHTTPS両方に対して適用されます。

大量のファイルを処理する場合、ステータスコード429を返す場合があります。一括で無効化を行いたい場合は、配信設定の編集APIにより、content-refreshビヘイビアを使用してください。

主なステータスコードとX-Message ヘッダーの値を示します。

ステータスコード X-Message
202 Accepted:要求は受け付けられました。

※該当コンテンツがエッジサーバに存在していなくても受け付けられます。
400 Invalid entry for url/action:値が正しくありません
400 Service is undeployed:配信設定が無効状態です
409 Service is in progress:他の処理が進行中です
429 Rate limit exceeded:要求が多すぎるため、しばらく経ってから実行してください

Request Headers

API共通リクエストヘッダーを参照。

Request Parameter

service_id

配信設定を表すservice_id

Data Type Cardinality
String 1..1

action

消去動作
  • delete：キャッシュを削除(default)
  • invalidate：キャッシュを無効化
Data Type Cardinality
String 0..1

url

消去したいURLの相対パス。その配信の配信FQDNと合わせ、およそ1KBが上限です。超過した場合は400 Invalid entry for urlが通知されます。

例)directory/file.jpg

Data Type Cardinality
String 1..1

Request Elements

特にありません。

Response Headers

API共通のレスポンスヘッダーを参照。

X-Estimated-Seconds

キャッシュの消去が反映されるまでのおおよその時間(秒)

Data Type Cardinality
String 1..1

Response Elements

特にありません。

Example of Response


       DELETE /v1/services/d8fdaa40-fa39/assets? action=invalidate&url=solutions/img/img-06.jpg
       
       HTTP/1.1 202 Accepted
       X-Message: Accepted
       X-Estimated-Seconds: 5
       Content-Length: 0