Updated on 2025-08-11 GMT+08:00

Enabling DR Drill

Function

This API is used to enable DR drill on the DR instance.

During the DR drill, the DR instance provides services and the incremental data is temporarily cached in the primary instance. After the drill is complete, the DR instance can perform incremental replay based on the temporarily stored incremental data. If the cached incremental data exceeds the value of this parameter, the DR instance will replay all data after the drill is complete. Before calling this API:

Constraints

This function is supported only when streaming DR is used and the DB engine version is V2.0-3.200 or later.

URI

POST /v3.5/{project_id}/instances/{instance_id}/disaster-recovery/simulation-start

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

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

instance_id

Yes

Definition

Instance ID, which uniquely identifies an instance.

Constraints

N/A

Range

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

Default Value

N/A

Request Parameters

Table 2 Parameter description

Parameter

Mandatory

Type

Description

xlog_keep_ratio

No

Integer

Definition

Ratio of the log cache space to the available disk space.

Constraints

This parameter does not take effect for DR instances.

Range

1–99

Default Value

10 for the primary instance

disaster_type

Yes

String

Definition

DR type.

Constraints

N/A

Range

stream: streaming DR.

Default Value

N/A

Response Parameters

Table 3 Response body parameters

Parameter

Type

Description

job_id

String

Definition

Job ID.

Range

N/A

Example Request

POST https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3.5/0483b6b16e954cb88930a360d2c4e663/instances/c04c789b6baa4b6dbcc139c5226f3a2cin14/disaster-recovery/simulation-start
{ 
	"xlog_keep_ratio":50,
        "disaster_type" : "stream" 
}

Example Response

{ 
    "job_id":"8bf0175e-562e-45f6-942a-2e2c72c577d7" 
}

Status Codes

Error Codes

For details, see Error Codes.