调用ModifyDBClusterPrimaryZone变更PolarDB集群的主可用区。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyDBClusterPrimaryZone | 系统规定参数。取值:ModifyDBClusterPrimaryZone。 |
DBClusterId | String | 是 | pc-************** | 集群ID。 说明 您可以调用DescribeDBClusters接口查看目标地域下所有的集群信息,包括集群ID。 |
ZoneId | String | 是 | cn-hangzhou-g | 新的主可用区ID。 说明 可通过接口DescribeRegions查看可用的可用区。 |
VSwitchId | String | 否 | vsw-************** | 目标可用区的虚拟交换机(VSwitch)ID。 说明
|
PlannedStartTime | String | 否 | 2021-01-14T09:00:00Z | 开始执行定时(即在目标时间段内执行)变更主可用区任务的最早时间。格式为 说明
|
PlannedEndTime | String | 否 | 2021-01-14T09:30:00Z | 开始执行目标定时任务的最晚时间。格式为 说明
|
FromTimeService | Boolean | 否 | false | 立即执行或定时执行更换主可用区。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | ED12C6FF-3261-4571-AB57-3570F6****** | 请求ID。 |
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=ModifyDBClusterPrimaryZone
&DBClusterId=pc-**************
&ZoneId=cn-hangzhou-g
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyDBClusterPrimaryZoneResponse>
<RequestId>ED12C6FF-3261-4571-AB57-3570F6******</RequestId>
</ModifyDBClusterPrimaryZoneResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "ED12C6FF-3261-4571-AB57-3570F6******"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | ScheduleTaskExist | The specified cluster already has a scheduled task. | 当前集群已存在待执行的定时任务。 |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
访问错误中心查看更多错误码。