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
名称 |
类型 |
描述 |
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 |
返回码
请求示例
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
}
}