调用DescribeBinaryLogList接口查询Binlog日志。

  • binlog文件默认保存15天。
  • 返回的日志列表中包含日志记录结束时间在查询开始时间之后，并且日志记录开始时间在查询结束时间之前的所有日志。
  • 当DownloadLink不为NULL时，用户可以根据此URL下载备份文件，此URL自生成后2天内有效，请在过期时间之前下载。

调试

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

请求参数

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

系统规定参数。取值：DescribeBinaryLogList。

RegionId String 是 cn-hangzhou

实例所在地域ID。
PageNumber Integer 否 1

分页获取当前binlog列表时，需填写当前页码，默认从第1页开始。
PageSize Integer 否 30

每页获取binlog数量，默认填写30。
DBInstanceName String 是 pxc-hz1fds

当前实例名称。
StartTime String 是 2021-09-09 10:27:46

查询binlog列表开始时间。
EndTime String 是 2021-11-09 10:27:46

查询binlog列表结束时间。

返回数据

名称 类型 示例值 描述
RequestId String 2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9

请求ID。
PageNumber Integer 1

当前查询的页码。
PageSize Integer 30

当前页显示的binlog数量。
TotalNumber Integer 100

查询到的binlog文件总数。
LogList Array of LogList

binlog文件列表。
EndTime String 2021-11-09 10:27:46

当前binlog结束时间。
ModifiedTime String 2021-11-09 10:27:46

最后更新时间。
UploadHost String 10.110.88.9

备份host。
UploadStatus Integer 2

备份状态：

  • 0：未备份；
  • 1：备份中；
  • 2：已备份。
DownloadLink String http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&OSSAccessKeyId=LT13fds12dsaf****&Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D

文件下载链接，2天内有效。
BeginTime String 2021-09-09 10:27:46

日志开始时间。
LogSize Long 536870912

当前日志文件大小。
FileName String binlog.000001

binlog文件名称。
CreatedTime String 2021-09-09 10:27:46

文件创建时间。
PurgeStatus Integer 0

清理状态：

  • 0：未删除；
  • 1：已删除。
Id Long 100

当前记录的唯一ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeBinaryLogList
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=30
&DBInstanceName=pxc-hz1fds
&StartTime=2021-09-09 10:27:46
&EndTime=2021-11-09 10:27:46
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeBinaryLogListResponse>
    <RequestId>2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>30</PageSize>
    <TotalNumber>100</TotalNumber>
    <LogList>
        <EndTime>2021-11-09 10:27:46</EndTime>
        <ModifiedTime>2021-11-09 10:27:46</ModifiedTime>
        <UploadHost>10.110.88.9</UploadHost>
        <UploadStatus>2</UploadStatus>
        <DownloadLink>http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&amp;OSSAccessKeyId=LT13fds12dsaf****&amp;Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D</DownloadLink>
        <BeginTime>2021-09-09 10:27:46</BeginTime>
        <LogSize>536870912</LogSize>
        <FileName>binlog.000001</FileName>
        <CreatedTime>2021-09-09 10:27:46</CreatedTime>
        <PurgeStatus>0</PurgeStatus>
        <Id>100</Id>
    </LogList>
</DescribeBinaryLogListResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9",
  "PageNumber" : 1,
  "PageSize" : 30,
  "TotalNumber" : 100,
  "LogList" : [ {
    "EndTime" : "2021-11-09 10:27:46",
    "ModifiedTime" : "2021-11-09 10:27:46",
    "UploadHost" : "10.110.88.9",
    "UploadStatus" : 2,
    "DownloadLink" : "http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&OSSAccessKeyId=LT13fds12dsaf****&Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D",
    "BeginTime" : "2021-09-09 10:27:46",
    "LogSize" : 536870912,
    "FileName" : "binlog.000001",
    "CreatedTime" : "2021-09-09 10:27:46",
    "PurgeStatus" : 0,
    "Id" : 100
  } ]
}

错误码

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