Help Center/ Distributed Cache Service/ API Reference (Kuala Lumpur Region)/ APIs V2 (Recommended)/ Backup and Restoration/ Restoring a DCS Instance
Updated on 2025-11-17 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Restoring a DCS Instance

Function

This API is used to restore the backup data to 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}/restores

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

backup_id

Yes

String

Backup ID.

remark

No

String

Description of DCS instance restoration.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

restore_id

String

ID of the restoration record.

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_msg

String

Definition:

Error message.

Range:

N/A

error_code

String

Definition:

Error code.

Range:

For details, see Error Codes.

error_ext_msg

String

Definition:

Extended error information. This parameter is not used currently and is set to null.

Range:

N/A

Status code: 500

Table 5 Response body parameters

Parameter

Type

Description

error_msg

String

Definition:

Error message.

Range:

N/A

error_code

String

Definition:

Error code.

Range:

For details, see Error Codes.

error_ext_msg

String

Definition:

Extended error information. This parameter is not used currently and is set to null.

Range:

N/A

Example Requests

Restoring the backup files of the DCS instance

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

{
  "backup_id" : "8ba256cb-e5ac-44f6-a3da-c03d8f0e5029",
  "remark" : "restore instance"
}

Example Responses

Status code: 200

Successful

{
  "restore_id" : "a6155972-800c-4170-a479-3231e907d2f6"
}

Status Codes

Status Code

Description

200

Successful

400

Invalid request.

500

Internal service error.

Error Codes

See Error Codes.

Parent topic: Backup and Restoration