85
iPhone_iPad_Mac_手機_平板_蘋果apple
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
上一篇:
GetCursor__日誌庫相關接口_API-Reference_日誌服務-阿裏雲
下一篇:
PostLogStoreLogs__日誌庫相關接口_API-Reference_日誌服務-阿裏雲
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲