云数据库 RDS

产品文档

云数据库 RDS

describeBinlogs

描述

获取MySQL实例中binlog的详细信息
- 仅支持 MySQL, Percona, MariaDB

请求方式

GET

请求地址

https://rds.jdcloud-api.com/v1/regions/{regionId}/instances/{instanceId}/binlogs

名称 类型 是否必需 默认值 描述
regionId String True 地域代码,取值范围参见《各地域及可用区对照表》
instanceId String True RDS 实例ID,唯一标识一个RDS实例

请求参数

名称 类型 是否必需 默认值 描述
pageNumber Integer False 显示数据的页码,默认为1,取值范围:[-1,∞)。pageNumber为-1时,返回所有数据页码;超过总页数时,显示最后一页。
pageSize Integer False 每页显示的数据条数,默认为10,取值范围:10、20、30、50、100
startTime String False 查询开始时间,格式为:YYYY-MM-DD HH:mm:ss,开始时间到结束时间不超过三天
endTime String False 查询结束时间,格式为:YYYY-MM-DD HH:mm:ss,开始时间到结束时间不超过三天

返回参数

名称 类型 描述
result Result

Result

名称 类型 描述
totalCount Integer 总记录数
binlogs Binlog[ ] 备份集合

Binlog

名称 类型 描述
binlogBackupId String binlog日志备份ID
binlogName String binlog日志名称
binlogSizeKB Long binlog日志大小,单位KB
binlogStartTime String binlog开始时间,格式为:YYYY-MM-DD HH:mm:ss
binlogEndTime String binlog结束时间,格式为:YYYY-MM-DD HH:mm:ss

返回码

返回码 描述
200 OK

请求示例

GET

public void testDescribeBinlogs() {
    DescribeBinlogsRequest request = new DescribeBinlogsRequest();
    request.setInstanceId("mysql-wp4e9ztap2");
    request.setRegionId("cn-north-1");
    request.setStartTime("2020-01-07 14:08:00");
    request.setEndTime("2020-01-07 14:09:00");
    DescribeBinlogsResponse response = rdsClient.describeBinlogs(request);
    System.out.println(new Gson().toJson(response));
}

返回示例

{
    "requestId": "bpa39u79di4knqu1cp5nhwt2nnuui5d8", 
    "result": {
        "binlogs": [
            {
                "binlogBackupId": "bceed098-0c5d-48a1-9625-4126e32bed29", 
                "binlogEndTime": "2020-01-07T14:13:50", 
                "binlogName": "mysql-bin.002009", 
                "binlogSizeKB": 281, 
                "binlogStartTime": "2020-01-07T14:08:49"
            }, 
            {
                "binlogBackupId": "200a08e4-d9ca-47ac-9347-6f442d8acfb5", 
                "binlogEndTime": "2020-01-07T14:08:49", 
                "binlogName": "mysql-bin.002008", 
                "binlogSizeKB": 281, 
                "binlogStartTime": "2020-01-07T14:03:48"
            }
        ], 
        "totalCount": 2
    }
}
更新时间:2020-01-19 16:57:34
feedback