调用FailoverDBCluster接口对PolarDB集群进行手动主备切换,您可以指定一个只读节点为新的主节点。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | FailoverDBCluster | 系统规定参数。取值:FailoverDBCluster。 |
DBClusterId | String | 是 | pc-************** | 数据库集群ID。 |
TargetDBNodeId | String | 否 | pi-*********** | 将要切换为主节点的节点ID,如果不填,则系统自动选举。您可以通过接口DescribeDBClusters查询节点ID等信息。 说明
|
ClientToken | String | 否 | 6000170000591aed949d0f54a343f1a4233c1e7d1c5****** | 用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,保证在不同请求间唯一,大小写敏感、不超过64个ASCII字符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | D0CEC6AC-7760-409A-A0D5-E6CD86****** | 请求ID。 |
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=FailoverDBCluster
&DBClusterId=pc-**************
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<FailoverDBClusterResponse>
<RequestId>D0CEC6AC-7760-409A-A0D5-E6CD86******</RequestId>
</FailoverDBClusterResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "D0CEC6AC-7760-409A-A0D5-E6CD86******"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | HaStatusNotSupport | Current DB instance HA status does not support this operation. | 实例的HA状态不支持该操作 |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
访问错误中心查看更多错误码。