调用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。

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