调用DescribeBinlogFiles接口查询Binlog日志。

  • 当DownloadLink为NULL时，表示RDS没有提供下载链接URL；
  • 当DownloadLink不为NULL时，用户可以根据此URL下载备份文件，此URL已设置过期时间LinkExpiredTime，请在过期时间之前下载。
  • 返回的日志列表为日志记录结束时间在查询开始时间之后，并且日志记录开始时间在查询结束时间之前的所有日志，即LogEndTime>=StartTime and LogBeginTime<=EndTime。
    说明 本接口不适用于SQL Server实例。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeBinlogFiles

系统规定参数，取值：DescribeBinlogFiles。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

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

查询结束时间，大于查询开始时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

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

查询开始时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

PageSize Integer 否 30

每页记录数，取值：30~100。默认值：30。

PageNumber Integer 否 1

页码，取值：大于0且不超过Integer的最大值。

默认值：1。

返回数据

名称 类型 示例值 描述
TotalRecordCount Integer 100

Binlog文件总数。
PageNumber Integer 1

页码。
PageRecordCount Integer 30

当前页Binlog文件个数。
Items Array

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文件记录的结束时间。格式：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": []
	},
	"PageNumber": 1,
	"TotalRecordCount": 0,
	"TotalFileSize": "0",
	"RequestId": "ED169A3E-1657-4104-82AB-24EA8CD0DB75",
	"PageRecordCount": 0
}

错误码

访问错误中心查看更多错误码。