全部產品
Search
文件中心

Simple Log Service:PullLogs

更新時間:Sep 18, 2026

呼叫PullLogs介面取得指定遊標(Cursor)位置的日誌資料。此介面取得的是原始日誌,如要查詢或分析日誌,請使用GetLogsV2介面。

介面說明

警告 目前 OpenAPI SDK 不支援此介面,請使用日誌服務 SDK。
  • 取得日誌時必須指定 Shard。

  • 目前僅支援讀取Protocol Buffer格式資料。

  • 請求語法中 Host 由 Project 名稱和日誌服務 Endpoint 構成,您需要在 Host 中指定 Project。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

GET /logstores/{logStore}/shards/{shardId}?type=log HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

logStore

string

是

Logstore 名稱。

ali-test-logstore

shardId

integer

是

日誌庫的分片 id。

1

請求參數

名稱

類型

必填

描述

樣本值

project

string

是

Project 名稱。

ali-test-project

cursor

string

是

遊標,表示從什麼位置開始讀取資料,相當於起點。

MTQ0NzMyOTQwMTEwMjEzMDkwNA

count

integer

是

回傳的 LogGroup 數目,最小值為 1,最大值為 1000。

1000

end_cursor

string

否

結束遊標,表示讀取資料到什麼地方結束,相當於終點。

MTU1NzA1NzQwMTEwMjEzMDkwCg

query

string

否

過濾語句,spl 語法,請參見 SPL 指令。

* | where userId='123'

Accept-Encoding

string

否

期望伺服器端回傳的資料壓縮格式,支援 lz4。

lz4

PullLogs 介面的特有請求標頭如下所示:

  • Accept:application/x-protobuf

  • Accept-Encoding:lz4

其中,Accept-Encoding 取值包括 lz4、deflate 或雙引號("")之一。

請求範例:

GET /logstores/sls-test-logstore/shards/0?type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA&count=1000 HTTP/1.1
Host:ali-test-project.cn-hangzhou.log.aliyuncs.com
Content-Type:application/json

返回參數

名稱

類型

描述

樣本值

LogGroupList

壓縮後的 pb 資料。

PullLogs 介面的特有回應元素如下所示:

  • x-log-cursor:當前讀取資料下一條 Cursor。

  • x-log-end-of-cursor:當前讀取資料最後一條 Cursor。

  • x-log-count:當前返回數量。

關於 Log Service API 的公共回應標頭,請參見公共回應標頭。

回應元素為 protobuf 格式序列化後的資料(可能經過壓縮)。

樣本

正常返回樣本

JSON格式

{
  "logGroupList": [
    {
      "LogItems": [
        {
          "Contents": [
            {
              "Key": "key-test",
              "Value": "value-test"
            }
          ],
          "Time": 1690254376,
          "TimeNs": 123456789
        }
      ],
      "LogTags": [
        {
          "Key": "key-test",
          "Value": "value-test"
        }
      ],
      "Source": "192.1.1.1",
      "Topic": "topic-test"
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。