Consultar arquivos de backup de log - : Central de Documentação do Alibaba Cloud

Se o parâmetro DownloadLink retornar NULL para um arquivo de backup de log, o ApsaraDB RDS não fornecerá uma URL para baixe do arquivo.
Se o parâmetro DownloadLink não retornar NULL para um arquivo de backup de log, o ApsaraDB RDS disponibilizará uma URL para baixar o arquivo. O parâmetro LinkExpiredTime define a expiração dessa URL. Baixe o arquivo antes desse prazo.
Esta operação retorna entradas de log SQL geradas em um intervalo de tempo especificado. O início do intervalo deve ser posterior ou igual ao horário definido pelo parâmetro LogEndTime. Além disso, o fim do intervalo deve ser anterior ou igual ao horário definido pelo parâmetro LogBeginTime.

Nota

Instâncias que executam SQL Server não suportam esta operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeBinlogFiles	A operação a ser executada. Defina o valor como DescribeBinlogFiles.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	O ID da instância.
EndTime	String	Sim	2011-06-20T15:00:00Z	O fim do intervalo de tempo a ser consultado. O horário final deve ser posterior ao horário inicial. Especifique o horário no padrão ISO 8601, no formato aaaa-MM-dd T HH:mm:ss Z. O horário deve estar em UTC.
StartTime	String	Sim	2011-06-01T15:00:00Z	O início do intervalo de tempo a ser consultado. Especifique o horário no padrão ISO 8601, no formato aaaa-MM-dd T HH:mm:ss Z. O horário deve estar em UTC.
PageSize	Integer	Não	30	O número de entradas a serem retornadas em cada página. Valores válidos: de 1 a 100. Valor padrão: 30.
PageNumber	Integer	Não	1	O número da página a ser retornada. Valores válidos: qualquer inteiro positivo diferente de zero. Valor padrão: 1.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalRecordCount	Integer	100	O número total de arquivos de backup de log retornados.
PageNumber	Integer	1	O número da página retornada.
PageRecordCount	Integer	30	A quantidade de arquivos de backup de log retornados na página atual.
Items	Array of BinLogFile		Uma matriz composta por arquivos de backup de log.
BinLogFile
FileSize	Long	2269410	O tamanho do arquivo de backup de log. Unidade: bytes.
LogBeginTime	String	2019-02-09T17:45:21Z	O horário inicial dos dados de log registrados no arquivo de backup de log. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
LogEndTime	String	2019-02-15T13:10:28Z	O horário final dos dados de log registrados no arquivo de log binário. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
DownloadLink	String	http://rdsxxxxx.oss.aliyuncs.com/xxxxxx	A URL para baixe o arquivo de backup de log via HTTP. Se este parâmetro estiver definido como NULL, nenhuma URL estará disponível.
HostInstanceID	String	5841973	O ID da instância que gera o arquivo de backup de log. Use este parâmetro para distinguir entre os arquivos de backup de log gerados por uma instância primária e os arquivos gerados pela instância secundária da instância primária.
LinkExpiredTime	String	2013-06-09T18:00:00Z	O horário de expiração da URL. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
Checksum	String	18358304393468701857	A soma de verificação. O algoritmo CRC64 calcula o valor deste parâmetro.
IntranetDownloadLink	String	http://rdslog-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxxx	A URL para baixe o arquivo de backup de log por uma rede interna.
LogFileName	String	000000040000000000000019	O nome do arquivo de backup de log.
RemoteStatus	String	Completed	O status do arquivo de backup de log no bucket do Object Storage Service (OSS) onde o arquivo está armazenado. Valores válidos: Uploading: O arquivo de backup de log está sendo carregado no bucket do OSS. Completed: O upload do arquivo de backup de log para o bucket do OSS foi concluído.
RequestId	String	ED169A3E-1657-4104-82AB-24EA8CD0DB75	O ID da solicitação.
TotalFileSize	Long	2269410	O tamanho total dos arquivos de backup de log retornados.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=DescribeBinlogFiles
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2011-06-01T15:00:00Z
&EndTime=2011-06-20T15:00:00Z
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeBinlogFilesResponse>
<?xml version="1.0" encoding="UTF-8" ?>
<TotalRecordCount>1</TotalRecordCount>
<PageRecordCount>1</PageRecordCount>
<RequestId>C91A2FEA-DDBE-5BE1-9944-9C8DA6E45334</RequestId>
<PageNumber>1</PageNumber>
<TotalFileSize>439562</TotalFileSize>
<Items>
    <BinLogFile>
        <DownloadLink>http://rdslog********.aliyuncs.com/mysql-bin.000071</DownloadLink>
        <LogBeginTime>2021-10-13T07:44:37Z</LogBeginTime>
        <LinkExpiredTime>2021-10-17T03:16:50Z</LinkExpiredTime>
        <Checksum>261972378**********</Checksum>
        <LogEndTime>2021-10-13T13:44:39Z</LogEndTime>
        <IntranetDownloadLink>http://rdslog********.aliyuncs.com/mysql-bin.000071</IntranetDownloadLink>
        <RemoteStatus>Completed</RemoteStatus>
        <HostInstanceID>1947****</HostInstanceID>
        <LogFileName>mysql-bin.000071</LogFileName>
        <FileSize>439562</FileSize>
    </BinLogFile>
</Items>
</DescribeBinlogFilesResponse>

Formato JSON

{
    "TotalRecordCount": 1,
    "PageRecordCount": 1,
    "RequestId": "C91A2FEA-DDBE-5BE1-9944-9C8DA6E45334",
    "PageNumber": 1,
    "TotalFileSize": "439562",
    "Items": {
        "BinLogFile": [
            {
                "DownloadLink": "http://rdslog********.aliyuncs.com/mysql-bin.000071",
                "LogBeginTime": "2021-10-13T07:44:37Z",
                "LinkExpiredTime": "2021-10-17T03:16:50Z",
                "Checksum": "261972378**********",
                "LogEndTime": "2021-10-13T13:44:39Z",
                "IntranetDownloadLink": "http://rdslog********.aliyuncs.com/mysql-bin.000071",
                "RemoteStatus": "Completed",
                "HostInstanceID": 1947****,
                "LogFileName": "mysql-bin.000071",
                "FileSize": 439562
            }
        ]
    }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ParameterLeastAssociate	Must input at least one optional parameter.	Mensagem de erro retornada porque os parâmetros restoreTime e BackupId da instância não podem estar vazios simultaneamente. Especifique pelo menos um dos parâmetros e tente novamente.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	Mensagem de erro retornada porque a instância não foi encontrada, foi excluída ou não suporta a operação.
400	ParameterAbsence	Necessary parameter is absence.	Mensagem de erro retornada porque os parâmetros obrigatórios não foram especificados.
403	IncorrectDBInstanceEngine	Current DB Instance engine does not support this operation.	Mensagem de erro retornada porque o mecanismo de banco de dados da instância não suporta esta operação.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Mensagem de erro retornada porque o status da instância não suporta esta operação.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Mensagem de erro retornada porque a instância está bloqueada.

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