查询Binlog合并下载文件 - ListPackLogInfos
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| rds:binlog:get | read | instance | g:EnterpriseProjectId g:ResourceTag/<tag-key> | - | - |
接口约束
该接口仅支持MySQL。
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一region下的project ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
表2 参数说明 参数
是否必选
参数类型
描述
offset
否
Integer
参数解释：
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。
约束限制：
不涉及。
取值范围：
大于等于0的整数。
默认取值：
默认为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”字段指定。
取值范围：
不涉及。
size_unit
String
参数解释：
文件单位。
取值范围：
KB
status
String
参数解释：
Binlog合并下载文件的状态。
取值范围：
- Active：正常。
- Running：运行中。
query_start_time
Long
参数解释：
合并时间段起始毫秒时间戳。
取值范围：
不涉及。
query_end_time
Long
参数解释：
合并时间段结束毫秒时间戳。
取值范围：
不涉及。
file_name
String
参数解释：
文件名。
取值范围：
不涉及。
- 正常响应样例
{ "total_count": 100, "pack_log_infos": [ { "id": "815635c7-22ff-4d84-8be5-89602c8c154d", "instance_id": "e67d9956f8d143ab85dcff32484b68d8in01", "size": 982, "size_unit": "KB", "status": "Active", "query_start_time": 1715234525000, "query_end_time": 1715235844000, "file_name": "ef561226aee54ba89a2ee752cd9de2fx_e67d9956f8d143ab85dcff32484b68d8in01_PackLog_815635c7-22ff-4d84-8be5-89602c8c154d_1715067022363_.tar.gz" } ] } - 异常响应
请参见异常响应结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
