tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
文档

消费数据

最后更新时间：2020-02-26 16:58:44

    功能描述

    本接口用于消费读取日志。根据游标（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 文件描述详见 上传结构化日志 接口。

    错误码

    参见 错误码。

    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    隐私条款服务条款缓存条款