Delete objects

POST 
/v1/storages/delete-objects

Batch delete objects.

This API is subject to cloud storage bucket permission configuration and identity authentication and authorization. Ensure the requesting identity has the necessary permissions for the corresponding resources.

For cloud storage permission configuration, see Cloud Storage Basic Permissions and Cloud Storage Security Rules.

💡 Tip: If cloud storage operations are blocked by basic permissions or security rules, you may encounter the error code: STORAGE_EXCEED_AUTHORITY

💡 Tip: If cloud storage operations are blocked by the identity authentication mechanism, you may encounter the error code: ACTION_FORBIDDEN

Request

application/json

Body

arrayrequired

Delete object request parameters, array format

• Array [
cloudObjectId Cloud object ID (string)
• ]

Responses

200

Returned when the call is successful

Response Headers

• X-Request-Id string

  Request ID

application/json

Schema

Schema

• Array [
oneOf
v1DeleteObjectsResponseItemSuccess
cloudObjectId Cloud object ID (string)
v1DeleteObjectsResponseItemError
code Error code returned when the request for this object fails (string)
message Error description returned when the request for this object fails (string)
cloudObjectId Cloud object ID operated in this request (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

General error information, see https://docs.cloudbase.net/error-code/service for details

Response Headers

• X-Request-Id string

  Request ID

application/json

Schema

Schema

code Error code (string)
message Error message (string)
requestId Request ID (string)

Example (from schema)

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

InvalidHost

Invalid request address

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

Loading...