Changes the primary zone of a PolarDB cluster.

Debugging

Alibaba Cloud provides OpenAPI Explorer to simplify API usage. OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyDBClusterPrimaryZone

The operation that you want to perform. Set the value to ModifyDBClusterPrimaryZone.

DBClusterId String Yes pc-**************

The ID of the cluster for which you want to change the primary zone.

ZoneId String Yes cn-hangzhou-g

The ID of the new primary zone.

Note You can call the DescribeRegions operation to query available zones.
VSwitchId String No vsw-**************

The ID of the vSwitch to which the cluster is connected.

Note If databases in the cluster run the PolarDB O Edition or ApsaraDB PolarDB PostgreSQL-compatible database engine, you must specify this parameter. If databases in the cluster run the ApsaraDB PolarDB MySQL-compatible edition database engine, you do not need to specify this parameter.

Response parameters

Parameter Type Example Description
RequestId String ED12C6FF-3261-4571-AB57-3570F6******

The ID of the request.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/?Action=ModifyDBClusterPrimaryZone
&DBClusterId=pc-**************
&ZoneId=cn-hangzhou-g
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBClusterPrimaryZoneResponse>
<RequestId>ED12C6FF-3261-4571-AB57-3570F6******</RequestId>
</ModifyDBClusterPrimaryZoneResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "ED12C6FF-3261-4571-AB57-3570F6******"
}

Error codes

HttpCode Error code Error message Description
400 ScheduleTaskExist The specified cluster already has a scheduled task. The error code returned because a different task is scheduled to run on the specified cluster.

For a list of error codes, visit the API Error Center.