删除对象

DELETE/v2/storage/buckets/{bucket}/objects/{key}

删除单个对象，支持批量前缀删除。

Bearer Token storage:write api.demo.acme-cloud.dev

请求参数

共 3 项

bucket 必填路径

string

桶名称

key 必填路径

string

对象键，需 URL 编码

响应

3 种状态

204 No Content

该状态码无响应体（No Content）

代码示例

cURL

curl -i -X DELETE 'https://api.demo.acme-cloud.dev/v2/storage/buckets/acme-assets/objects/uploads%2F2026%2Favatar.png' \
  -H 'Accept: application/json'

注意事项

删除不存在的对象也返回 204（幂等），但会在响应头 X-Deleted-Versions 中体现实际删除数量。