ModifyHASwitchConfig操作を呼び出して、ApsaraDB RDSインスタンスの自動プライマリ /セカンダリ切り替え機能を有効または無効にすることができます。
切り替えが完了すると、元のプライマリRDSインスタンスがセカンダリRDSインスタンスとして実行されます。 詳細については、「プライマリとセカンダリのApsaraDB RDS For MySQLインスタンス間のワークロードの切り替え」をご参照ください。
この操作を呼び出す前に、インスタンスがRDS Basic Editionを実行していないことを確認してください。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | 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 エラーセンター」をご参照ください。