調(diào)用DescribeBinlogFiles接口查詢Binlog日志。

  • 當DownloadLink為NULL時，表示RDS沒有提供下載鏈接URL；
  • 當DownloadLink不為NULL時，用戶可以根據(jù)此URL下載備份文件，此URL已設(shè)置過期時間LinkExpiredTime，請在過期時間之前下載。
  • 返回的日志列表中包含日志記錄結(jié)束時間在查詢開始時間之后，并且日志記錄開始時間在查詢結(jié)束時間之前的所有日志。
說明 本接口不適用于SQL Server實例。

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeBinlogFiles

系統(tǒng)規(guī)定參數(shù)，取值：DescribeBinlogFiles。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

實例ID。
EndTime String 是 2011-06-20T15:00:00Z

查詢結(jié)束時間，大于查詢開始時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

StartTime String 是 2011-06-01T15:00:00Z

查詢開始時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

PageSize Integer 否 30

每頁記錄數(shù)，取值：30~100。默認值：30。

PageNumber Integer 否 1

頁碼，取值：大于0且不超過Integer的最大值。

默認值：1。

返回數(shù)據(jù)

名稱 類型 示例值 描述
TotalRecordCount Integer 100

Binlog文件總數(shù)。
PageNumber Integer 1

頁碼。
PageRecordCount Integer 30

當前頁Binlog文件個數(shù)。
Items Array of BinLogFile

Binlog明細列表。
BinLogFile
FileSize Long 2269410

Binlog文件大小，單位：Byte。
LogBeginTime String 2019-02-09T17:45:21Z

Binlog文件記錄的開始時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

LogEndTime String 2019-02-15T13:10:28Z

Binlog文件記錄的結(jié)束時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

DownloadLink String http://rdsxxxxx.oss.aliyuncs.com/xxxxxx

支持HTTP協(xié)議的下載鏈接URL，NULL表示沒有下載鏈接。
HostInstanceID String 5841973

Binlog所在實例編號，用戶區(qū)分該Binlog日志產(chǎn)生于主實例或備實例。
LinkExpiredTime String 2013-06-09T18:00:00Z

URL過期時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

Checksum String 18358304393468701857

校驗和，采用CRC64算法。
IntranetDownloadLink String http://rdslog-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxxx

內(nèi)網(wǎng)下載鏈接URL。
LogFileName String 000000040000000000000019

Binlog文件名稱。
RemoteStatus String Completed

OSS的存儲狀態(tài)。返回值：

  • Uploading：上傳中
  • Completed：上傳完成
RequestId String ED169A3E-1657-4104-82AB-24EA8CD0DB75

請求ID。
TotalFileSize Long 2269410

Binlog文件總大小。

示例

請求示例

http(s)://rds.aliyuncs.com/?Action=DescribeBinlogFiles
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2011-06-01T15:00:00Z
&EndTime=2011-06-20T15:00:00Z
&<公共請求參數(shù)>

正常返回示例

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>

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
            }
        ]
    }
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 ParameterLeastAssociate Must input at least one optional parameter. 還原時間或備份集不能同時為空，請設(shè)置后重試。
404 InvalidDBInstance.NotFound Specified instance does not exist or not support. 指定的實例不存在指定的實例被刪除或者實例不支持當前操作。
400 ParameterAbsence Necessary parameter is absence. 必要的參數(shù)未傳。
403 IncorrectDBInstanceEngine Current DB Instance engine does not support this operation. 操作失敗，數(shù)據(jù)庫引擎不支持。
403 IncorrectDBInstanceState Current DB instance state does not support this operation. 操作失敗，該實例狀態(tài)下不支持此操作。
403 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. 操作失敗，實例處于鎖定狀態(tài)。

訪問錯誤中心查看更多錯誤碼。