85      小米  小米 note

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參數:

請求頭

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

關於API的公共請求頭請參考公共請求頭。

響應頭

• x-log-cursor：當前讀取數據下一條cursor
• x-log-count：當前返回數量

關於API的公共響應頭請參考公共響應頭。

響應元素

protobuf格式序列化後的數據（可能經過壓縮）

細節描述

特有錯誤碼

除了返回API的通用錯誤碼，還可能返回如下特有錯誤碼:

示例

請求示例：

讀取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

  上一篇： GetCursor__日誌庫相關接口_API-Reference_日誌服務-阿裏雲

  下一篇： PostLogStoreLogs__日誌庫相關接口_API-Reference_日誌服務-阿裏雲