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:
- Learn how to authenticate this API.
- Obtain the required region and endpoint.
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
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
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
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
- Normal
- Abnormal
For details, see Status Codes.
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot