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

:高可用性モードの照会

最終更新日:Mar 07, 2025

DescribeDBInstanceHAConfig操作を呼び出して、ApsaraDB RDSインスタンスの高可用性モードとデータレプリケーションモードを照会できます。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceId String 必須 rm-uf6wjk5xxxxxx

インスタンスの ID です。

レスポンスパラメーター

項目 データ型 例: 説明 
DBInstanceId String rm-uf6wjk5xxxxxx

インスタンスの ID です。

HAMode String RPO

インスタンスの高可用性モード。 有効な値:

  • RPO: データの一貫性が好ましい。 インスタンスはデータの信頼性を確保し、データ損失を最小限に抑えます。 データの一貫性に関する要件が高い場合は、このモードを選択します。
  • RTO: サービスの可用性が優先されます。 インスタンスは、サービスの可用性を確保するために、最も早い機会にデータベースサービスを復元します。 サービスの可用性に関する要件が高い場合は、このモードを選択します。
説明 このパラメーターは、MySQLを実行するインスタンスに対してのみ返されます。
SyncMode String 同期

インスタンスのデータレプリケーションモード。 詳細については、「ApsaraDB RDS For MySQLインスタンスのデータレプリケーションモードの変更」をご参照ください。 有効な値:

  • 同期: 同期モード
  • Semi-sync: 半同期モード
  • Async: 非同期モード
説明 このパラメーターは、MySQLを実行するインスタンスに対してのみ返されます。
HostInstanceInfos NodeInfoの配列

プライマリインスタンスとセカンダリインスタンスに関する情報で構成される配列。

NodeInfo
NodeId String 3397027

インスタンスの ID です。

NodeType String マスター

インスタンスのロール。 有効な値:

  • Master: プライマリインスタンスロール
  • Slave: セカンダリインスタンスのロール
RegionId String cn-hangzhou

インスタンスのリージョン ID です。

ZoneId String cn-hangzhou-d

インスタンスのゾーン ID。

SyncStatus String NotAvailable

インスタンスの同期ステータス。 有効な値:

  • NotAvailable: 同期が失敗します。 これは、障害が発生することを意味する。
  • Syncing: 同期中です。 この場合、プライマリ /セカンダリの切り替えによりデータが失われる可能性があります。
  • Synchronized: 同期が完了しました。
  • NotSupport: データベースエンジンまたはバージョンには、プライマリインスタンスとセカンダリインスタンス間の同期は含まれません。
LogSyncTime String 2018-05-05T15:15:00Z

セカンダリインスタンスがプライマリインスタンスからログを受信した時刻。 時間は、yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

DataSyncTime String 2018-05-05T15:15:00Z

セカンダリインスタンスがプライマリインスタンスからのデータの同期を完了した時刻。 時間は、yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

リクエストの ID です。

リクエストの例

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

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

XML 形式

<DescribeDBInstanceHAConfigResponse>
  <RequestId>103D4ACC-F2F9-4A7E-9ACC-14B0A25613E0</RequestId>
  <DBInstanceId>rm-uf6wjk5xxxxxx</DBInstanceId>
  <HAMode>RPO</HAMode>
  <HostInstanceInfos>
        <NodeInfo>
              <DataSyncTime></DataSyncTime>
              <ZoneId>cn-hangzhou-h</ZoneId>
              <LogSyncTime></LogSyncTime>
              <NodeType> スレーブ </NodeType>
              <NodeId>13567431</NodeId>
              <SyncStatus>NotSupport</SyncStatus>
              <RegionId>cn-hangzhou</RegionId>
        </NodeInfo>
        <NodeInfo>
              <DataSyncTime></DataSyncTime>
              <ZoneId>cn-hangzhou-h</ZoneId>
              <LogSyncTime></LogSyncTime>
              <NodeType> マスター </NodeType>
              <NodeId>14565107</NodeId>
              <SyncStatus>NotSupport</SyncStatus>
              <RegionId>cn-hangzhou</RegionId>
        </NodeInfo>
  </HostInstanceInfos>
  <SyncMode> セミシンク </SyncMode>
</DescribeDBInstanceHAConfigResponse>

JSON 形式

{
"RequestId": "103D4ACC-F2F9-4A7E-9ACC-14B0A25613E0" 、"DBInstanceId": "rm-uf6wjk5xxxxxx" 、"HAMode": "RPO" 、"HostInstanceInfos": {
"NodeInfo": [
{
"DataSyncTime": "" 、"ZoneId": "cn-hangzhou-h" 、"LogSyncTime": "" 、"NodeType": "スレーブ" 、"NodeId": "13567431" 、"SyncStatus": "NotSupport" 、"RegionId": "cn-hangzhou"
},
{
"DataSyncTime": "" 、"ZoneId": "cn-hangzhou-h" 、"LogSyncTime": "" 、"NodeType": "マスター" 、"NodeId": "14565107" 、"SyncStatus": "NotSupport" 、"RegionId": "cn-hangzhou"
}
]
},
"SyncMode": "セミシンク"
}

エラーコード

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