You need to enable JavaScript to run this app.
RDS for MySQL

RDS for MySQL

Copy page
Download PDF
Managing instances
SwitchDrInstanceToMaster
Copy page
Download PDF
SwitchDrInstanceToMaster

Call the SwitchDrInstanceToMaster API to promote a disaster recovery instance to a primary instance.

Request type

Asynchronous request.

Request parameters

Name
Type
Required
Example
Description
InstanceId
String
Yes
mysql-d2772ba1****
Disaster recovery instance ID.

Response parameters

null

Sample request

POST /?Action=SwitchDrInstanceToMaster&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "InstanceId": "mysql-d2772ba1****"
}

Sample response

{
    "ResponseMetadata": {
        "RequestId": "2024120522060385AF665EDE9F2DA7C23B-51150e",
        "Action": "SwitchDrInstanceToMaster",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {}
}

Error codes

For more details, refer to Error codes.

Last updated: 2025.07.07 15:52:01