Todos os produtos
Search
Central de documentação

:Consultar latência de replicação de dados

Última atualização: Jun 26, 2026

Use a operação DescribeReadDBInstanceDelay para consultar a latência de replicação de dados entre uma instância primária do ApsaraDB RDS e sua instância somente leitura.

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

  • A instância primária deve usar o mecanismo de banco de dados MySQL ou PostgreSQL.

  • A instância primária deve ter uma instância somente leitura associada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeReadDBInstanceDelay

Operação a ser executada. Defina o valor como DescribeReadDBInstanceDelay.

DBInstanceId

String

Sim

rm-bpxxxxxxx

ID da instância primária.

ReadInstanceId

String

Sim

rr-bpxxxxxxx

ID da instância somente leitura.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
DBInstanceIdStringrm-bpxxxxxxx

ID da instância primária.

DelayTimeInteger0

Latência de replicação de dados entre a instância primária e a instância somente leitura.

ItemsArray of Items

Matriz com informações de latência.

Items
DBInstanceIdStringrm-bpxxxxxxx

ID da instância primária.

ReadDBInstanceNamesList"ReadDBInstanceName": ["rr-bpxxxxx"]

Matriz com informações sobre a instância somente leitura.

Nota Este parâmetro é retornado apenas quando a instância primária usa o mecanismo de banco de dados MySQL.
ReadDelayTimesList"ReadDelayTime": ["0"]

Matriz com valores de latência.

Nota Este parâmetro é retornado apenas quando a instância primária usa o mecanismo de banco de dados MySQL.
ReadonlyInstanceDelayArray of ReadonlyInstanceDelay

Matriz com informações sobre a latência do WAL (Write-Ahead Log).

Nota Este parâmetro é retornado apenas quando a instância primária usa o mecanismo de banco de dados PostgreSQL.
ReadonlyInstanceDelay
FlushLagString0

Tempo permitido para latência na persistência de dados WAL. Unidade: segundos.

FlushLatencyString0

Volume de dados permitido para latência na persistência de dados WAL. Unidade: MB.

ReadDBInstanceNameStringrr-bpxxxxxxx

ID da instância somente leitura.

ReplayLagString0

Tempo permitido para latência na reprodução de dados WAL. Unidade: segundos.

ReplayLatencyString0

Volume de dados permitido para latência na reprodução de dados WAL. Unidade: MB.

SendLatencyString0

Volume de dados permitido para latência no envio de dados WAL. Unidade: MB.

WriteLagString0

Tempo permitido para latência na gravação de dados WAL. Unidade: segundos.

WriteLatencyString0

Volume de dados permitido para latência na gravação de dados WAL. Unidade: MB.

ReadDBInstanceIdStringrr-bpxxxxxxx

ID da instância somente leitura.

RequestIdStringF1BDDEA8-452D-450B-AB10-CD5C5BAFC5DF

ID da solicitação.

Exemplos

Solicitações de exemplo

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

Respostas de sucesso de exemplo

Formato 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>

Formato 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"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.