キャッシュの消去(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

を参照。

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

を参照。

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