调用GetCursor接口根据时间获取Cursor-日志服务-阿里云

接口说明

Host 由 Project 名称和日志服务 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=="
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。