Updated on 2025-09-16 GMT+08:00

Deleting Manual Backups in Batches

Function

This API is used to delete manual backups of a DB instance in batches.

URI

DELETE /v3/{project_id}/instances/backups

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token

X-Language

No

String

Language

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

backup_ids

Yes

Array of String

IDs of manual backups to be deleted in batches. No more than 10 manual backups can be deleted at a time.

Response Parameters

Status code: 200

No response parameters

Example Request

DELETE https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/backups
{
  "backup_ids": ["030acca1ad98444fb95a2e3e92d5b82fbr13", "be5b385ef95e48afa1222e9f2a954e58br13"]
}

Example Response

None

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.