查询Binlog合并下载文件 - ListPackLogInfos
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
rds:binlog:get |
read |
instance |
g:EnterpriseProjectId g:ResourceTag/<tag-key> |
- |
- |
接口约束
该接口仅支持MySQL。
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一region下的project ID。
获取方法请参见获取项目ID。
约束限制：
非空。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID，此参数是实例的唯一标识。
约束限制：
不涉及。
取值范围：
只能由英文字母、数字组成，长度为36个字符。
默认取值：
不涉及。
表2 参数说明 参数
是否必选
参数类型
描述
offset
否
Integer
参数解释：
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。
约束限制：
不涉及。
取值范围：
必须为数字，不能为负数。
默认取值：
默认为0（偏移0条数据，表示从第一条数据开始查询）。
limit
否
Integer
参数解释：
查询记录数。
约束限制：
不涉及。
取值范围：
不能为负数，最小值为1，最大值为100。
默认取值：
10
请求消息
无。
请求示例
查询Binlog合并下载文件。
GET https://{Endpoint}/v3/54623db08b174c858ba779d2aa7923a3/instances/aa650a108f034e83b24486fd1ff7be2fin01/packlog/infos?offset=0&limit=10
响应消息
- 正常响应要素说明
表3 要素说明 名称
参数类型
说明
total_count
Integer
参数解释：
Binlog合并下载文件数量。
取值范围：
不涉及。
pack_log_infos
Array of objects
参数解释：
Binlog合并下载文件信息。
详情请参见表4。
表4 pack_log_infos元素结构说明 名称
参数类型
说明
id
String
参数解释：
文件唯一ID标识。
取值范围：
不涉及。
instance_id
String
参数解释：
实例ID。
取值范围：
不涉及。
size
Double
参数解释：
文件大小。
取值范围：
不涉及。
size_unit
String
参数解释：
文件大小单位。
取值范围：
不涉及。
status
String
参数解释：
状态。
取值范围：
不涉及。
query_start_time
Long
参数解释：
合并时间段起始时间戳。
取值范围：
不涉及。
query_end_time
Long
参数解释：
合并时间段结束时间戳。
取值范围：
不涉及。
file_name
String
参数解释：
文件名。
取值范围：
不涉及。
- 正常响应样例
{ "statistics": [ { "keyword": "SELECT~FROM~table~WHERE~id", "raw_sql_text": "select *from db1", "ids": [ 123, 124, 125, 126 ], "count": 4, "total_time": 14, "avg_time": 3.5, "max_time": 5, "strategy": "top3_average", "advice_concurrency": "5" } ] } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
