阅读85 返回首页    go 阿里云

PullLogs__日志库相关接口_API-Reference_日志服务-阿里云

根据游标、数量获得日志。获得日志时必须指定shard，如果在storm等情况下可以通过LoghubClientLib进行选举与协同消费。目前仅支持读取[PB格式LogGroupList]数据。

请求语法

GET /logstores/ay42/shards/0?type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA==&count=100 HTTP/1.1
Accept: application/x-protobuf
Accept-Encoding: lz4
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

请求参数

URL参数:

参数名称 类型 是否必须 描述
type string 是 此处为"logs"
cursor string 是 游标，用以表示从什么位置开始读取数据，相当于起点
count int 是 返回的loggroup数目，范围为0-1000

请求头

  • Accept: application/x-protobuf
  • Accept-Encoding: lz4 或者 deflate 或 ""

关于API的公共请求头请参考公共请求头。

响应头

  • x-log-cursor：当前读取数据下一条cursor
  • x-log-count：当前返回数量

关于API的公共响应头请参考公共响应头。

响应元素

protobuf格式序列化后的数据（可能经过压缩）

细节描述

特有错误码

除了返回API的通用错误码，还可能返回如下特有错误码:

HTTP状态码 ErrorCode ErrorMessage
404 LogStoreNotExist Logstore {Name} not exist
400 ParameterInvalid Parameter Cursor is not valid
400 ParameterInvalid ParameterCount should be in [0-1000]
400 ShardNotExist Shard {ShardID} not exist
400 InvalidCursor this cursor is invalid
500 InternalServerError Specified Server Error Message

示例

请求示例：
读取0号shard上的数据

GET /logstores/sls-test-logstore/shards/0?cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA==&count=1000&type=log  

Header:
{
    "Authorization"="LOG 94to3z418yupi6ikawqqd370:WeMYZp6bH/SmWEgryMrLhbxK+7o=", 
    "x-log-bodyrawsize"=0, 
    "User-Agent" : "sls-java-sdk-v-0.6.0", 
    "x-log-apiversion" : "0.6.0", 
    "Host" : "ali-test-project.cn-hangzhou-failover-intranet.sls.aliyuncs.com", 
    "x-log-signaturemethod" : "hmac-sha1", 
    "Accept-Encoding" : "lz4", 
    "Content-Length": 0,
    "Date" : "Thu, 12 Nov 2015 12:03:17 GMT",
    "Content-Type" : "application/x-protobuf", 
    "accept" : "application/x-protobuf"
}
响应示例：
Header:
{
    "x-log-count" : "1000", 
    "x-log-requestid" : "56447FB20351626D7C000874", 
    "Server" : "nginx/1.6.1", 
    "x-log-bodyrawsize" : "34121", 
    "Connection" : "close", 
    "Content-Length" : "4231", 
    "x-log-cursor" : "MTQ0NzMyOTQwMTEwMjEzMDkwNA==", 
    "Date" : "Thu, 12 Nov 2015 12:01:54 GMT", 
    "x-log-compresstype" : "lz4", 
    "Content-Type" : "application/x-protobuf"
}

Body:
<protobuf格式loggrouplist内容> 压缩后结果

翻页

如果只为了翻页（拿到下一组Token），不返回数据，可以通过HTTP HEAD方式进行请求。

最后更新：2016-11-23 16:04:02

  上一篇：go GetCursor__日志库相关接口_API-Reference_日志服务-阿里云
  下一篇：go PostLogStoreLogs__日志库相关接口_API-Reference_日志服务-阿里云