调用SwitchOverGlobalDatabaseNetwork接口切换全球数据库网络（GDN）中的主从集群。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SwitchOverGlobalDatabaseNetwork

系统规定参数。取值：SwitchOverGlobalDatabaseNetwork。

RegionId String 否 cn-qingdao

地域ID。
DBClusterId String 否 pc-wz9fb5nn44u1d****

GDN中需要切换为主集群的集群ID。

您可以调用DescribeGlobalDatabaseNetwork接口查看GDN中的集群ID。

GDNId String 是 gdn-bp1fttxsrmv*****

GDN ID。
Forced Boolean 否 false

是否强制切换GDN的主从集群。取值范围：

  • true：表示强制切换GDN的主从集群。
  • false：表示不强制切换GDN的主从集群。
ResourceGroupId String 否 rg-************

资源组ID。

返回数据

名称 类型 示例值 描述
RequestId String 67F2E75F-AE67-4FB2-821F-A81237EACD15

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=SwitchOverGlobalDatabaseNetwork
&RegionId=cn-hangzhou
&DBClusterId=pc-wz9fb5nn44u1d****
&GDNId=gdn-bp1fttxsrmv*****
&公共请求参数

正常返回示例

XML格式 

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

<SwitchOverGlobalDatabaseNetworkResponse>
    <RequestId>67F2E75F-AE67-4FB2-821F-A81237EACD15</RequestId>
</SwitchOverGlobalDatabaseNetworkResponse>

JSON格式 

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

{
  "RequestId" : "67F2E75F-AE67-4FB2-821F-A81237EACD15"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的DBClusterId。

访问错误中心查看更多错误码。