Todos os produtos
Search
Central de documentação

:Consultar arquivos de backup de log entre regiões

Última atualização: Jun 26, 2026

Use a operação DescribeCrossRegionLogBackupFiles para consultar os arquivos de backup de log entre regiões de uma instância do ApsaraDB RDS.

Para mais informações sobre como consultar os arquivos de backup de dados entre regiões de uma instância RDS, consulte DescribeCrossRegionBackups.

Antes de chamar esta operação, verifique se a instância executa uma das seguintes versões de mecanismo de banco de dados e edições do RDS:

  • MySQL 8.0 no RDS High-availability Edition (com SSDs locais)

  • MySQL 5.7 no RDS High-availability Edition (com SSDs locais)

  • MySQL 5.6

Depuração

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

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDescribeCrossRegionLogBackupFiles

A operação a ser executada. Defina o valor como DescribeCrossRegionLogBackupFiles.

DBInstanceIdStringSimrm-uf6wjk5xxxxxxxxxx

O ID da instância.

EndTimeStringSim2019-06-15T12:10:00Z

O fim do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

RegionIdStringSimcn-hangzhou

O ID da região da instância. Chame a operação DescribeRegions para obter a lista de regiões mais recente.

StartTimeStringSim2019-05-30T12:10:00Z

O início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

CrossBackupRegionStringNãocn-shanghai

O ID da região de destino onde os arquivos de backup entre regiões da instância estão armazenados. Chame a operação DescribeCrossRegionBackupDBInstance para obter a lista de regiões mais recente.

PageSizeIntegerNão30

Número de entradas a retornar por página. Valores válidos:

  • 30
  • 50
  • 100

Valor padrão: 30.

PageNumberIntegerNão1

Número da página a retornar. A numeração começa em 1.

Valor padrão: 1.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

DBInstanceId

String

rm-uf6wjk5xxxxxxxxxx

O ID da instância.

StartTime

String

2019-05-30T12:10:00Z

Início do intervalo de tempo consultado. Segue o padrão ISO 8601 no formato aaaa-MM-dd T hh:mm:ss Z, em UTC.

EndTime

String

2019-06-15T12:10:00Z

Fim do intervalo de tempo consultado. Segue o padrão ISO 8601 no formato aaaa-MM-dd T hh:mm:ss Z, em UTC.

TotalRecordCount

Integer

100

Número total de entradas retornadas.

PageNumber

Integer

1

Número da página retornada. A numeração começa em 1.

Valor padrão: 1.

PageRecordCount

Integer

30

Quantidade de arquivos de backup de log entre regiões na página atual.

RegionId

String

cn-hangzhou

O ID da região da instância.

RequestId

String

DAC241E8-28E6-49DA-BFB0-B2DD090885C1

O ID da solicitação.

Items

Array of Item

Matriz composta pelos arquivos de backup de log entre regiões.

Item

CrossBackupRegion

String

cn-shanghai

ID da região de destino onde o arquivo de backup de log entre regiões está armazenado.

CrossDownloadLink

String

http://rdsddrlog-zb.oss-cn-zhangjiakou.aliyuncs.com/xxxxx

URL externa para baixe o arquivo de backup de log entre regiões.

CrossIntranetDownloadLink

String

http://rdsddrlog-zb.oss-cn-zhangjiakou-internal.aliyuncs.com/xxxxx

URL interna para baixe o arquivo de backup de log entre regiões.

CrossLogBackupId

Integer

14567

O ID do arquivo de backup de log entre regiões.

CrossLogBackupSize

Long

5312836

Tamanho do arquivo de backup de log entre regiões. Unidade: bytes.

InstanceId

Integer

8161055

O ID da instância.

LinkExpiredTime

String

2019-06-30T15:00:00Z

Horário de expiração da URL de download do arquivo de backup de log entre regiões. Segue o padrão ISO 8601 no formato aaaa-MM-dd T hh:mm:ss Z, em UTC.

LogBeginTime

String

2019-05-30T12:10:00Z

Hora de início do arquivo de backup de log entre regiões. Segue o padrão ISO 8601 no formato aaaa-MM-dd T hh:mm:ss Z, em UTC.

LogEndTime

String

2019-05-30T20:10:00Z

Hora de término do arquivo de backup de log entre regiões. Segue o padrão ISO 8601 no formato aaaa-MM-dd T hh:mm:ss Z, em UTC.

LogFileName

String

cn-hangzhou_rm-bpxxxxx_7198739_mysql-bin.000230

Nome do arquivo de backup de log entre regiões.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/? Action=DescribeCrossRegionLogBackupFiles
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&StartTime=2019-05-30T12:10:00Z
&EndTime=2019-06-15T12:10:00Z
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeCrossRegionLogBackupFilesResponse>
  <Items>
            <Item>
                  <LinkExpiredTime>2019-06-02T07:36:18Z</LinkExpiredTime>
                  <CrossBackupRegion>cn-zhangjiakou</CrossBackupRegion>
                  <LogEndTime>2019-06-01T06:11:49Z</LogEndTime>
                  <LogBeginTime>2019-06-01T00:11:44Z</LogBeginTime>
                  <InstanceId>7198743</InstanceId>
                  <CrossLogBackupSize>770014</CrossLogBackupSize>
                  <CrossDownloadLink>http://rdsddrlog-zb.oss-cn-zhangjiakou.aliyuncs.com/xxxxxx</CrossDownloadLink>
                  <CrossIntranetDownloadLink>http://rdsddrlog-zb.oss-cn-zhangjiakou-internal.aliyuncs.com/xxxxx</CrossIntranetDownloadLink>
            </Item>
      </Items>
      <PageNumber>1</PageNumber>
      <TotalRecordCount>52</TotalRecordCount>
      <DBInstanceId>rm-xxxxx</DBInstanceId>
      <RegionId>cn-hangzhou</RegionId>
      <RequestId>A9723BCE-F32F-4F05-9922-8371C0842FA7</RequestId>
      <EndTime>EndTime=2019-06-15T12:10:00Z</EndTime>
      <StartTime>2019-05-30T12:10:00Z</StartTime>
      <PageRecordCount>10</PageRecordCount>
</DescribeCrossRegionLogBackupFilesResponse>

Formato JSON

{"Items":{
    "Item":[{
    "LinkExpiredTime":"2019-06-02T07:36:18Z",
    "CrossBackupRegion":"cn-zhangjiakou",
    "LogEndTime":"2019-06-01T06:11:49Z",
    "LogBeginTime":"2019-06-01T00:11:44Z",
    "InstanceId":7198743,
    "CrossLogBackupSize":770014,
    "CrossDownloadLink":"http://rdsddrlog-zb.oss-cn-zhangjiakou.aliyuncs.com/xxxxxx",
    "CrossIntranetDownloadLink":"http://rdsddrlog-zb.oss-cn-zhangjiakou-internal.aliyuncs.com/xxxxx"}
    ]},
    "PageNumber":1,
    "TotalRecordCount":52,
    "DBInstanceId":"rm-xxxxx",
    "RegionId":"cn-hangzhou",
    "RequestId":"A9723BCE-F32F-4F05-9922-8371C0842FA7",
    "EndTime":"EndTime=2019-06-15T12:10:00Z",
    "StartTime":"2019-05-30T12:10:00Z",
    "PageRecordCount":10}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidStartTime.Format

Specified start time is not valid.

Mensagem de erro retornada quando a hora de início especificada é inválida.

400

InvalidEndTime.Format

Specified end time is not valid.

Mensagem de erro retornada quando a hora de término especificada é inválida.

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