• Cloud Server Backup Service

csbs
  1. Help Center
  2. Cloud Server Backup Service
  3. API Reference
  4. API Description
  5. Backup Management
  6. Deleting a Backup

Deleting a Backup

Function

This API is used to delete a backup.

URI

  • URI format

    DELETE /v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

    provider_id

    Yes

    String

    Backup provider ID, currently fixed at fc4d5750-22e7-4798-8a46-f48f62c4c1da

    checkpoint_id

    Yes

    String

    Backup record ID

Request

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    checkpoint_items

    No

    String

    Indicates the ID list of the backup records to be deleted. If this parameter is not set, all backup records of checkpoint will be deleted.

  • Element description

None

  • Example request
    Deleting all backups in the specified backup record:
    DELETE /v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}
    Deleting a single backup in the specified backup record:
    DELETE /v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}?checkpoint_items={checkpoint_items_id}

Response

  • Element description

    None

  • Example response
    { 
    }

Status Codes

  • Normal

    Status Code

    Description

    200

    OK

  • Abnormal

    Status Code

    Description

    400

    Invalid request parameters.

    401

    Authentication failed.

    403

    No operation permission.

    404

    Requested object not found.

    500

    Service internal error.

    503

    Service unavailable.

Error Codes

For details, see Error Codes.