角色切換
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DBClusterId |
string |
是 |
叢集 ID。 |
pc-************** |
| TargetDBNodeId |
string |
否 |
將要切換為主節點的節點 ID，如果不填，則系統自動選舉。您可以通過介面 DescribeDBClusters 查詢節點 ID 等資訊。 |
pi-*********** |
| RollBackForDisaster |
boolean |
否 |
是否是故障切換後的回切至原主可用性區域，取值範圍如下：
|
false |
| ClientToken |
string |
否 |
用於保證請求的等冪性，防止重複提交請求。由用戶端產生該參數值，保證在不同請求間唯一，大小寫敏感、不超過 64 個 ASCII 字元。 |
6000170000591aed949d0f54a343f1a4233c1e7d1c5****** |
| TargetZoneType |
string |
否 |
是否是主可用性區域內主備切換，取值如下：
|
Primary |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求 ID。 |
925B84D9-CA72-432C-95CF-738C22****** |
樣本
正常返回樣本
JSON格式
{
"RequestId": "925B84D9-CA72-432C-95CF-738C22******"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | HaStatusNotSupport | Current DB instance HA status does not support this operation. | 執行個體的HA狀態不支援該操作 |
| 400 | InvalidDBNodeId.Malformed | The specified parameter DBNodeId is not valid. | 指定的參數DBNodeId無效。 |
| 400 | InvalidDBType.Malformed | The Specified DBType is not valid. | 指定的資料庫類型無效. |
| 400 | UnsupportHighFrequenceSwitchOver | The instance has switch over too frequent within ten minutes. | 當前切換過於頻繁，建議5分鐘後重試 |
| 400 | UnsupportWitchUnhealthyReplication | The action is unsupported with unhealthy replication. | 當前複製關係異常，不支援切換 |
| 403 | OperationDenied.DBNodeType | The operation is not permitted due to type of node. | 操作失敗，節點類型不允許此操作。 |
| 403 | OperationDenied.ClusterCategory | The operation is not permitted due to cluster category. | 該叢集不支援此產品系列。 |
| 404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 當前的記錄中不存在提供的DBClusterId。 |
| 404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | 指定的參數DBClusterId無效 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。