調用DescribeBinlogFiles介面查看Binlog日誌。

  • 當DownloadLink為NULL時，表示RDS沒有提供下載連結URL；
  • 當DownloadLink不為NULL時，使用者可以根據此URL下載備份檔案，此URL已設定到期時間LinkExpiredTime，請在到期時間之前下載。
    说明 本介面不適用於SQL Server執行個體。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeBinlogFiles

系統規定參數，取值：DescribeBinlogFiles。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

執行個體ID。
StartTime String 是 2011-06-01T15:00:00Z

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

EndTime String 是 2011-06-20T15:00:00Z

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

PageSize Integer 否 30

每頁記錄數，取值：

  • 30；
  • 50；
  • 100。

預設值：30。

PageNumber Integer 否 1

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

預設值：1。

AccessKeyId String 否 LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

返回資料

名稱 類型 樣本值 描述
TotalRecordCount Integer 100

Binlog檔案總數。
PageNumber Integer 1

頁碼。
PageRecordCount Integer 30

當前頁Binlog檔案個數。
Items

Binlog明細列表。
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檔案記錄的結束時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

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

支援HTTP協議的下載連結URL，NULL表示沒有下載連結。
HostInstanceID String 5841973

Binlog所在執行個體編號，使用者區分該Binlog日誌產生於主執行個體或備執行個體。
LinkExpiredTime String 2013-06-09T18:00:00Z

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

Checksum String 18358304393468701857

校正和。
IntranetDownloadLink String http://rdslog-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxxx

內網下載連結URL。
LogFileName String 000000040000000000000019

Binlog檔案名稱。
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
&<公用請求參數>

正常返回樣本

XML 格式 

<DescribeBinlogFilesResponse>
	  <Items></Items>
	  <PageNumber>1</PageNumber>
	  <TotalRecordCount>0</TotalRecordCount>
	  <TotalFileSize>0</TotalFileSize>
	  <RequestId>ED169A3E-1657-4104-82AB-24EA8CD0DB75</RequestId>
	  <PageRecordCount>0</PageRecordCount></DescribeBinlogFilesResponse>

JSON 格式 

{
	"Items":{
		"BinLogFile":[]
	},
	"TotalRecordCount":0,
	"PageNumber":1,
	"TotalFileSize":"0",
	"RequestId":"ED169A3E-1657-4104-82AB-24EA8CD0DB75",
	"PageRecordCount":0
}

錯誤碼

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