GetCursor - 通過時間查詢Cursor - Simple Log Service

介面說明

Host 由 Project 名稱和Log Service Endpoint 構成，您需要在 Host 中指定 Project。
Cursor 與 Project、Logstore、Shard 的關係如下：
- Project 下有多個 Logstore。
- 每個 Logstore 會有多個 Shard。
- 通過 Cursor 可以獲得特定日誌對應的位置。

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

log:GetCursorOrData

get

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}

log:TLSVersion

無

請求文法

GET /logstores/{logstore}/shards/{shardId}?type=cursor HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
logstore	string	是	Logstore 名稱。	sls-test-logstore
shardId	integer	是	Shard ID。	1

請求參數

名稱	類型	必填	描述	樣本值
project	string	是	project 名稱。	ali-test-project
from	string	是	時間點（Unix 時間戳記）或者字串`begin`、`end`。	begin

通過 from 可以在 Shard 中定位生命週期內的日誌，假設 Logstore 的生命週期為[begin_time,end_time)，from=from_time，那麼：

當from_time ≤ begin_time or from_time = "begin"時：返回時間點為 begin_time 對應的 Cursor 位置。
當from_time ≥ end_time or from_time = "end"時：返回目前時間點下一條將被寫入的 Cursor 位置（當前該 Cursor 位置上無資料）。
當from_time > begin_time and from_time < end_time時：返回第一個服務端接收時間大於等於 from_time 的資料包對應的 Cursor。

說明

Logstore 生命週期由屬性中 TTL 欄位指定。例如，目前時間為2018-11-11 09:00:00，TTL=5。則每個 Shard 中可以消費的資料時間段為 [2018-11-05 09:00:00,2018-11-11 09:00:00)，這裡的時間指的是服務端時間。更多資訊，請參見資料儲存時間。

返回參數

名稱	類型	描述	樣本值
	object	Cursor 值。
cursor	string	Cursor 值。	MTQ0NzI5OTYwNjg5NjYzMjM1Ng==

樣本

正常返回樣本

JSON格式

{
  "cursor": "MTQ0NzI5OTYwNjg5NjYzMjM1Ng=="
}

錯誤碼

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

變更歷史

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