调用GetCursorTime接口可以根据Cursor获取服务端时间。

请求语法

GET /logstores/{logstoreName}/shards/{shard}?cursor={cursor}&type=cursor_time HTTP/1.1 

Authorization: <AuthorizationString>
Date: <GMT Date> 
Host: <Project Endpoint> 
x-log-apiversion: 0.6.0 
x-log-signaturemethod: hmac-sha1

请求参数

  • 请求头

    GetCursorTime接口无特有请求头。关于Log Service API的公共请求头,请参见公共请求头

  • 参数列表
    参数名称 参数类型 是否必须 示例值 参数说明
    logstoreName string internal-operation_log Logstore名称。
    shard int 0 shard ID。
    cursor string MTU0NzQ3MDY4MjM3NjUxMzQ0Ng%3D%3D 希望获取时间戳的Cursor。
    type string cursor_time 默认为cursor_time。

返回数据

  • 响应头

    GetCursorTime接口无特有响应头。关于Log Service API的公共响应头,请参见公共响应头

  • 响应元素
    GetCursorTime请求成功,其响应Body会获取服务端时间信息,具体如下:
    { 
       "cursor_time": 1554260243 
    }

示例

  • 请求示例
    GET /logstores/internal-operation_log/shards/0?cursor=MTU0NzQ3MDY4MjM3NjUxMzQ0Ng%3D%3D&type=cursor_time HTTP/1.1 
    
    Authorization: LOG <yourAccessKeyId>:<yourSignature> 
    x-log-bodyrawsize: 0 
    User-Agent: sls-java-sdk-v-0.6.1 
    x-log-apiversion: 0.6.0 
    Host: my-project.cn-hangzhou.sls.aliyuncs.com 
    x-log-signaturemethod: hmac-sha1 
    Date: Wed, 03 Apr 2019 02:57:23 GMT 
    Content-Type: application/x-protobuf 
    Connection: Keep-Alive
  • 正常返回示例
    HTTP/1.1 200 
    Server: nginx 
    Content-Type: application/json 
    Content-Length: 26 
    Connection: close 
    Access-Control-Allow-Origin: * 
    Date: Wed, 03 Apr 2019 02:57:23 GMT 
    x-log-requestid: 5CA42113D2F00378A74B9051 
    { 
      "cursor_time": 1554260243 
    }

错误码

HTTP状态码 错误码 错误信息 描述
404 LogStoreNotExist Logstore {Name} does not exist. 日志库不存在。
400 ParameterInvalid Parameter From is not valid. 无效参数。
400 ShardNotExist Shard {ShardID} does not exist. Shard不存在。
500 InternalServerError Specified Server Error Message. 内部服务调用错误。
400 LogStoreWithoutShard the logstore has no shard. 日志库没有Shard。

更多错误码,请参见通用错误码