Help Center/ Document Database Service/ API Reference/ APIs V3.0 (Recommended)/ Backup and Restoration/ Deleting a Manual Backup
Updated on 2025-10-24 GMT+08:00
View PDF

Deleting a Manual Backup

Function

This API is used to delete a manual backup for a DB instance.

URI

  • URI format

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

  • URI example

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/backups/8d9586c40b33449a815518d4635a2cd9br02

Table 1 Path parameters

Name

Mandatory

Type

IN

Description

project_id

Yes

string

path

Definition

Project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID.

Constraints

N/A

Range

N/A

Default Value

N/A

backup_id

Yes

string

path

Definition

Backup file ID.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

Table 2 Request header parameters

Name

Mandatory

Type

IN

Description

X-Auth-Token

Yes

string

header

Definition

User token obtained from IAM. For details, see Authentication.

Constraints

N/A

Range

N/A

Default Value

N/A

Response Parameters

Table 3 Response body parameters

Name

Mandatory

Type

Description

job_id

Yes

String

Definition

Task ID.

Range

N/A

Example Requests

DELETE https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/backups/afbf982b46ca421e9118f7db916058b5br02

Example Responses

{
    "job_id": "fcaab90b-960d-4441-b73d-a5b2532c5ec5"
}

Status Code

For more information, see Status Code.

Error Code

For more information, see Error Code.

Parent topic: Backup and Restoration