文档中心>日志服务

消费数据

最近更新时间:2020-07-31 11:10:19

我的收藏

功能描述

本接口用于消费读取日志。根据游标(cursor)、数量(count)获取对应主题分区上的日志数据。

请求

请求示例

GET /pulllogs?topic_id=xxxxxxxx-xxxx-xxxx-xxxx&partition_id=1&cursor=xxxxxxxxx&count=10 HTTP/1.1
Host: <Region>.cls.tencentyun.com
Authorization: <AuthorizationString>

请求头

除公共头部外,无特殊请求头部。

请求参数

参数名
类型
位置
是否必须
描述
topic_id
string
query
日志主题 ID
partition_id
int
query
消费的主题分区编号
cursor
string
query
游标值,base64编码,表示从当前位置开始读取数据
count
int
query
单次消费的 LogGroup 个数,最多1000个(一个 LogGroup 会包含多条日志,LogGroup 定义参考 上传结构化日志 文档)

响应

响应示例

HTTP/1.1 200 OK
Content-Type: application/x-protobuf
Content-Length: 23
x-cls-cursor: xxxxxx
x-cls-count: 10

<LogGroupList 的pb格式打包内容>

响应头

Header名
含义
x-cls-cursor
游标值,base64编码,表示下次从当前位置开始读取数据,供继续消费使用
x-cls-count
当前请求返回的 LogGroup 个数(一个 LogGroup 会包含多条日志,LogGroup 定义参考 上传结构化日志 文档)

响应参数

返回 LogGroupList 对象的打包内容,pb 文件描述详见 上传结构化日志 接口。

错误码

参见 错误码