プライマリApsaraDB for RDSインスタンスとそのセカンダリインスタンス間でサービスを切り替えます。

この操作により、Basic EditionにないRDSプライマリインスタンスとセカンダリインスタンスの間でサービスが切り替えられます。 切り替え後、セカンダリインスタンスはプライマリになり、すべてのビジネストラフィックを運びます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
アクション String 必須 SwitchDBInstanceHA

実行したい操作。 値をSwitchDBInstanceHAに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxxxxx

プライマリインスタンスのID。

NodeId String 必須 349054

セカンダリインスタンスの一意のID。 DescribeDBInstanceHAConfigを呼び出して、セカンダリインスタンスIDを照会できます。

フォース String 任意 いいえ

強制切り替えを有効にするかどうかを指定します。 有効な値:

  • はい
  • なし

デフォルト値: No

EffectiveTime String 任意 即時

切り替えが有効になる時刻。 有効な値:

  • Immediate: 切り替えはすぐに有効になります。
  • MaintainTime: 切り替えはメンテナンス期間中に有効になります。

デフォルト値: Immediate

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

リクエストの ID です。

リクエストの例

http(s)://rds.aliyuncs.com/? アクション=SwitchDBInstanceHA
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&NodeId=349054
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<SwitchDBInstanceHAResponse>
<RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
</SwitchDBInstanceHAResponse>

JSON 形式

{
    "RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
  }

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。