删除对象

POST 
/v1/storages/delete-objects

批量删除对象。

此接口受到云存储桶权限配置和身份认证鉴权的控制，请确认请求所属身份有对应资源的操作权限。

关于云存储权限配置，请参考文档：云存储基础权限 和 云存储安全规则。

💡 提示：如云存储操作被基础权限或安全规则所拦截，可能会遇到的错误码： STORAGE_EXCEED_AUTHORITY

💡 提示：如云存储操作被身份鉴权机制所拦截，可能会遇到的错误码： ACTION_FORBIDDEN

Request

application/json

Body

arrayrequired

下载对象请求参数，数组格式

• Array [
cloudObjectId 云端对象ID (string)
• ]

Responses

200

调用成功时返回

Response Headers

• X-Request-Id string

  请求ID

application/json

Schema

Schema

• Array [
oneOf
v1DeleteObjectsResponseItemSuccess
cloudObjectId 云端对象ID (string)
v1DeleteObjectsResponseItemError
code 对该对象的请求出错时返回的错误码 (string)
message 对该对象的请求出错时返回的错误描述 (string)
cloudObjectId 本次请求操作的云端对象ID (string)
• ]

Example (from schema)

[
  {
    "cloudObjectId": "cloud://your-envId.bucket/not-exist",
    "code": "OBJECT_NOT_EXIST",
    "message": "Storage object not exists."
  },
  {
    "cloudObjectId": "cloud://your-envId.bucket/file.jpg"
  }
]

default

通用报错信息，详见 https://docs.cloudbase.net/error-code/service

Response Headers

• X-Request-Id string

  请求ID

application/json

Schema

Schema

code 错误码 (string)
message 错误信息 (string)
requestId 请求 ID (string)

Example (from schema)

{
  "code": "string",
  "message": "string",
  "requestId": "string"
}

InvalidHost

请求地址异常

{
  "code": "INVALID_HOST",
  "message": "xxx",
  "requestId": "xxx"
}

Loading...