すべてのプロダクト
Search
ドキュメントセンター

:自動プライマリ /セカンダリ切り替えのクエリ設定

最終更新日:Mar 07, 2025

ApsaraDB for RDSインスタンスの自動プライマリ /セカンダリ切り替え機能のステータスを照会します。

プライマリ /セカンダリの切り替え後、プライマリインスタンスはセカンダリに降格され、セカンダリインスタンスはプライマリに昇格されます。 詳細については、「RDS MySQLマスターインスタンスとスレーブインスタンス間のサービスの手動または自動切り替え」をご参照ください。

この操作を呼び出す前に、インスタンスがHigh-availability Edition、Enterprise Edition、またはCluster Editionを実行していることを確認してください。

デバッグ

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

リクエストパラメーター

パラメーターデータ型必須説明
ActionString必須DescribeHASwitchConfig

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

DBInstanceIdString必須rm-uf6wjk5xxxxxxxxxx

インスタンスの ID です。

RegionIdString必須cn-hangzhou

インスタンスが属するリージョンのID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。

レスポンスパラメーター

パラメーターデータ型説明
HAConfigStringManual

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

  • 自動: プライマリ /セカンダリの自動切り替え機能が有効になっています。 障害が発生した場合、システムはプライマリインスタンスからセカンダリインスタンスにサービスを自動的に切り替えます。
  • Manual: プライマリ /セカンダリの自動切り替え機能は一時的に無効になっています。
ManualHATimeString2019-08-29T15:00:00Z

自動プライマリ /セカンダリ切り替え機能が再び有効になる時刻。 時刻は UTC である必要があります。

RequestIdString4FDF4B79-2741-4C5F-8C76-4B953FC5C2B1

リクエストの ID。

リクエストの例

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

成功レスポンスの例

XML 形式

<DescribeHASwitchConfigResponse>
   <ManualHATime>2019-08-29T15:00:00Z</ManualHATime>
   <RequestId>4FDF4B79-2741-4C5F-8C76-4B953FC5C2B1</RequestId>
   <HAConfig> マニュアル </HAConfig>
</DescribeHASwitchConfigResponse> 

JSON 形式

{
    "ManualHATime": "2019-08-29T15:00:00Z" 、
    "RequestId": "4FDF4B79-2741-4C5F-8C76-4B953FC5C2B1" 、
    "HAConfig": "マニュアル"
} 

エラーコード

エラーコードの一覧は、「API エラーセンター」をご参照ください。