Chen, Junjie a03981f7be DCS API 20230220 Version

Reviewed-by: Bobkova, Natalia <natalia.bobkova@t-systems.com>
Co-authored-by: Chen, Junjie <chenjunjie@huawei.com>
Co-committed-by: Chen, Junjie <chenjunjie@huawei.com>

2024-04-22 14:08:39 +00:00

11 KiB

Raw Permalink Blame History

Backing Up a DCS Instance

Function

This API is used to back up a specific DCS instance.

Only master/standby and cluster DCS instances can be backed up and restored, while single-node instances cannot.

URI

POST /v2/{project_id}/instances/{instance_id}/backups

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
instance_id	Yes	String	Instance ID.
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
remark	No	String	Description of DCS instance backup.
backup_format	No	String	Format of the DCS instance backup. Enumeration values: aof rdb

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
backup_id	String	Backup ID.

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Status code: 500

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	Error message. Maximum: 1024
error_code	String	Error code. Maximum: 9
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null. Maximum: 1024

Example Requests

Backing up a specified DCS instance to an AOF file

POST https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/backups

{
  "remark" : "Backup instances",
  "backup_format" : "aof"
}

Example Responses

Status code: 200

The specified DCS instance is backed up successfully.

{
  "backup_id" : "548ceeff-2cbb-47ab-9a1c-7b085a8c08d7"
}

Status Codes

Status Code	Description
200	The specified DCS instance is backed up successfully.
400	Invalid request.
500	Internal service error.

Error Codes

See Error Codes.

Parent topic: Backup and Restoration

11 KiB Raw Permalink Blame History