ModifyHASwitchConfig操作を呼び出して、ApsaraDB RDSインスタンスの自動プライマリ /セカンダリ切り替え機能を有効または無効にすることができます。

切り替えが完了すると、元のプライマリRDSインスタンスがセカンダリRDSインスタンスとして実行されます。 詳細については、「プライマリとセカンダリのApsaraDB RDS For MySQLインスタンス間のワークロードの切り替え」をご参照ください。

この操作を呼び出す前に、インスタンスがRDS Basic Editionを実行していないことを確認してください。

デバッグ

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

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 String 必須 ModifyHASwitchConfig

実行する操作です。 値をModifyHASwitchConfigに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxxxxx

インスタンスの ID です。

RegionId String 必須 cn-hangzhou

インスタンスのリージョン ID です。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

HAConfig String 任意 Manual

自動プライマリ /セカンダリ切り替え機能のステータス。 有効な値:

  • 自動: プライマリ /セカンダリの自動切り替え機能が有効になっています。 障害が発生した場合、システムは自動的にワークロードをインスタンスからセカンダリインスタンスに切り替えます。
  • 手動: プライマリ /セカンダリの自動切り替え機能は無効です。 障害が発生した場合、ワークロードをインスタンスからセカンダリインスタンスに手動で切り替える必要があります。

デフォルト値: Auto

説明 このパラメーターを Manualに設定した場合、 ManualHATimeパラメーターを指定する必要があります。
ManualHATime String 任意 2019-08-29T15:00:00Z

自動プライマリ /セカンダリ切り替え機能が有効になるまでの時間。 最大で、このパラメーターは7日後に23:59:59に設定できます。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時間は UTC にする必要があります。

説明 このパラメーターは、 HAConfigパラメーターを Manualに設定した場合にのみ有効になります。

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String B6AE1448-D846-4831-B1C7-CFF3E99D5470

リクエストの ID です。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=ModifyHASwitchConfig
&RegionId=cn-hangzhou
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&HAConfig=マニュアル
&ManualHATime=2019-08-28T15:00:00
&<共通リクエストパラメーター>

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

XML 形式

<ModifyHASwitchConfigResponse>
   <RequestId>B6AE1448-D846-4831-B1C7-CFF3E99D5470</RequestId>
</ModifyHASwitchConfigResponse>

JSON 形式

{
    "RequestId": "B6AE1448-D846-4831-B1C7-CFF3E99D5470"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
400 HaConfig. フォーマット HaConfigの値はautoまたはmanualでなければなりません HAConfigパラメーターの値が無効な場合に返されるエラーメッセージ。 HAConfigパラメーターは、AutoまたはManualに設定する必要があります。
400 HaConfigIsNull HaConfigはnullです。 HAConfigパラメーターの値がNullの場合に返されるエラーメッセージ。

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