Help Center/ GeminiDB/ API Reference/ APIs v3 (Recommended)/ Backups and Restorations/ Deleting Manual Backups in Batches
Updated on 2025-12-04 GMT+08:00
View PDF
Share

Deleting Manual Backups in Batches

Function

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

Authorization Information

Each account has permissions to call all APIs, but IAM users must have the required permissions specifically assigned.

  • If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    gaussdbfornosql:instance:deleteBackup

    Write

    -

    -

    nosql:backup:delete

    -

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 Requests

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

Example Responses

None

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.

Parent topic: Backups and Restorations