ロールの切り替え
今すぐお試しください
テスト
RAM 認証
リクエスト構文
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 |
応答本文。 |
||
| RequestId |
string |
リクエスト ID。 |
925B84D9-CA72-432C-95CF-738C22****** |
例
成功レスポンス
JSONJSON
{
"RequestId": "925B84D9-CA72-432C-95CF-738C22******"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | HaStatusNotSupport | Current DB instance HA status does not support this operation. | |
| 400 | InvalidDBNodeId.Malformed | The specified parameter DBNodeId is not valid. | |
| 400 | InvalidDBType.Malformed | The Specified DBType is not valid. | |
| 400 | UnsupportHighFrequenceSwitchOver | The instance has switch over too frequent within ten minutes. | |
| 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. | |
| 404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。