Updated on 2026-07-16 GMT+08:00

Deleting a Manual Backup

Function

This API is used to delete a manual backup. Before calling this API:

Debugging

You can debug this API in API Explorer.

URI

DELETE /v3/{project_id}/backups/{backup_id}

Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID of a tenant in a region.

To obtain the value, see Obtaining a Project ID.

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are allowed.

Default Value

N/A

backup_id

Yes

String

Definition

Backup ID, which uniquely identifies a backup. You can obtain the backup ID by calling Querying Backups.

Constraints

N/A

Range

The value must be in UUID format, exactly 36 characters long, and contain only letters and digits.

Default Value

N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token.

You can obtain the token by calling the IAM API used to obtain a user token.

After a response is returned, the value of X-Subject-Token in the response header is the token.

Constraints

N/A

Range

N/A

Default Value

N/A

X-Language

No

String

Definition

Language.

Constraints

N/A

Range

  • zh-cn: Chinese
  • en-us: English

Default Value

en-us

Response Parameters

Table 3 Response body parameters

Parameter

Type

Description

backup_id

String

Definition

Backup ID.

Range

N/A

backup_name

String

Definition

Backup file name.

Range

N/A

Example Request

Deleting a manual backup

DELETE https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/backups/e28d08754b1a490fb2b3540ed013a7fbbr14

Example Response

Manual backup deleted.

{ 
  "backup_id" : "85755cb697234111bfc4970795ca9018br14", 
  "backup_name" : "backup-d6e1" 
}

Status Codes

Error Codes

For details, see Error Codes.