DescribeReadDBInstanceDelay操作を呼び出すと、プライマリApsaraDB RDSインスタンスとその読み取り専用インスタンス間のデータ・レプリケーションのレイテンシーを照会することができます。

この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

  • プライマリインスタンスは、MySQLまたはPostgreSQLデータベースエンジンを実行する必要があります。
  • プライマリインスタンスは、読み取り専用インスタンスにアタッチする必要があります。

デバッグ

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

リクエストパラメーター

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

実行したい操作。 値をDescribeReadDBInstanceDelayに設定します。
DBInstanceId String 必須 rm-bpxxxxxxx

プライマリインスタンスのID。
ReadInstanceId String 必須 rr-bpxxxxxxx

読み取り専用インスタンスのID。

レスポンスパラメーター

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

プライマリインスタンスのID。
DelayTime Integer 0

プライマリインスタンスと読み取り専用インスタンス間のデータレプリケーションのレイテンシ。
項目 アイテムの配列

レイテンシ情報で構成される配列。
項目
DBInstanceId String rm-bpxxxxxxx

プライマリインスタンスのID。
ReadDBInstanceNames List "ReadDBInstanceName": ["rr-bpxxxxx"]

読み取り専用インスタンスに関する情報で構成される配列。

説明 このパラメーターは、プライマリインスタンスがMySQLデータベースエンジンを実行している場合にのみ返されます。
ReadDelayTimes List "ReadDelayTime": ["0"]

レイテンシで構成される配列。

説明 このパラメーターは、プライマリインスタンスがMySQLデータベースエンジンを実行している場合にのみ返されます。
ReadonlyInstanceDelay ReadonlyInstanceDelayの配列

先行書き込みログ (WAL) レイテンシに関する情報で構成される配列。

説明 このパラメーターは、プライマリインスタンスがPostgreSQLデータベースエンジンを実行している場合にのみ返されます。
ReadonlyInstanceDelay
FlushLag String 0

WALデータの永続化の待ち時間に許容される期間。 単位：秒。
FlushLatency String 0

WALデータの永続化の待ち時間に許容されるデータサイズ。 単位：MB。
ReadDBInstanceName String rr-bpxxxxxxx

読み取り専用インスタンスのID。
ReplayLag String 0

WALデータの再生のレイテンシに許容される期間。 単位：秒。
再生レイテンシ String 0

WALデータの再生時のレイテンシに許容されるデータサイズ。 単位：MB。
SendLatency String 0

WALデータの送信時のレイテンシに許容されるデータサイズ。 単位：MB。
WriteLag String 0

WALデータのライトバックのレイテンシに許容される期間。 単位：秒。
WriteLatency String 0

WALデータのライトバックのレイテンシに許容されるデータサイズ。 単位：MB。
ReadDBInstanceId String rr-bpxxxxxxx

読み取り専用インスタンスのID。
RequestId String F1BDDEA8-452D-450B-AB10-CD5C5BAFC5DF

リクエストの ID です。

例

リクエストの例

http(s)://rds.aliyuncs.com/? Action=DescribeReadDBInstanceDelay
&RegionId=cn-hangzhou
&DBInstanceId=rm-bpxxxxxxx
&ReadInstanceId=rr-bpxxxxxxx
&<Common request parameters>

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

XML 形式

<DescribeReadDBInstanceDelayResponse>
  <RequestId>11152741-D854-4E18-920E-64E75D484D57</RequestId>
  <DBInstanceId>rm-bpxxxxx</DBInstanceId>
  <Items>
        <Items>
              <ReadDBInstanceNames>
                    <ReadDBInstanceName>rr-bpxxxxx</ReadDBInstanceName>
              </ReadDBInstanceNames>
              <ReadDelayTimes>
                    <ReadDelayTime>0</ReadDelayTime>
              </ReadDelayTimes>
              <DBInstanceId>rm-bpxxxxx</DBInstanceId>
              <ReadonlyInstanceDelay>
        </ReadonlyInstanceDelay>
        </Items>
  </Items>
  <DelayTime>0</DelayTime>
</DescribeReadDBInstanceDelayResponse>

JSON 形式

{
    "RequestId": "11152741-D854-4E18-920E-64E75D484D57" 、
    "DBInstanceId": "rm-bpxxxxx" 、
    "Items": {
        "Items": [
            {
                "ReadDBInstanceNames": {
                    "ReadDBInstanceName": [
                        "rr-bpxxxxx"
                    ]
                },
                "ReadDelayTimes": {
                    "ReadDelayTime": [
                        "0"
                    ]
                },
                "DBInstanceId": "rm-bpxxxxx" 、
                "ReadonlyInstanceDelay": {
                    "ReadonlyInstanceDelay": []
                }
            }
        ]
    },
    "DelayTime": "0"
}

エラーコード

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