この操作は、サーバー時間に基づいてカーソルを照会するために呼び出します。 次の図は、プロジェクト、LogStore、シャード、およびカーソル間の関係を示しています。
図 1. プロジェクト、Logstore、シャード、およびカーソル間の関係
  • プロジェクトに複数の Logstore があります。
  • Logstore には複数のシャードがあります。
  • カーソルを使用して、特定のログの場所を取得できます。

リクエスト構文

GET /logstores/ay42/shards/2? type=cursor&from=1402341900 HTTP/1.1
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0

リクエストパラメーター

パラメーター データ型 必須/省略可能 説明
シャード String 必須
データ型 String 必須 照会するデータの種類。 このパラメーターをカーソルに設定します。
from String 必須 カーソルの照会に使用される時刻。 このパラメーターを Unix タイムスタンプまたは開始 / 終了などの文字列に設定します。
Logstore のライフサイクル

Logstore のライフサイクルは、Logstore 属性の ttl パラメーターによって指定されます。 たとえば、現在の時刻は 2018-11-11 09:00:00 で、ttl パラメーターは 5 に設定されています。 各シャードの消耗データの時間間隔は [2018-11-05 09:00,2018-11-11 09:00:00)です。 サーバー時間が使用されます。

from パラメーターを使用すると、シャードのライフサイクル内でログを検索できます。 Logstore のライフサイクルが [begin_time,end_time) で、from パラメーターが from_time に設定されている場合は、次のようになります。
  • from_time ≤ begin_time or from_time = "begin":begin_time で始まるログに対応するカーソルを返します。
  • from_time ≥ end_time or from_time = "end":現在時刻で書かれる次のログに対応するログを返します (現在のカーソル位置にデータがありません)。
  • from_time > begin_time and from_time < end_time:サーバーが from_time より前あるいは同時に受け取る最初のデータパケットに対応するカーソルを介します。
リクエストヘッダーフィールド

この操作では、特別なリクエストヘッダーフィールドは必要ありません。 Log Service 操作の一般的なリクエストヘッダーフィールドの詳細については、「一般的なリクエストヘッダーフィールド」をご参照ください。

レスポンスヘッダーフィールド

この操作では、特別なレスポンスヘッダーフィールドは返されません。 Log Service 操作の一般的なレスポンスヘッダー フィールドの詳細については、「一般的なレスポンスヘッダーフィールド」をご参照ください。

レスポンスパラメーター
{
    "cursor": "MTQ0NzI5OTYwNjg5NjYzMjM1Ng=="
}
エラーコード

Log Service 操作の 一般的なエラー の他に、次の表に示される特別なエラーコードも返されます。

HTTP ステータスコード エラーコード エラーメッセージ
404 LogStoreNotExist logstore {logstoreName} は存在しません
400 ParameterInvalid パラメーターの開始日が無効です
400 ShardNotExist シャード {ShardID} が存在しません
500 InternalServerError 指定されたサーバーエラーメッセージ
400 LogStoreWithoutShard logstore にシャードがありません

リクエスト例
GET /logstores/sls-test-logstore/shards/0? type=cursor&from=begin
Header:
{
    "Content-Length": 0, 
    "x-log-signaturemethod": "hmac-sha1", 
    "x-log-bodyrawsize": 0, 
    "User-Agent": "log-python-sdk-v-0.6.0", 
    "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com", 
    "Date": "Thu, 12 Nov 2015 03:56:57 GMT", 
    "x-log-apiversion": "0.6.0", 
    "Content-Type": "application/json", 
    "Authorization": "LOG <yourAccessKeyId>:<yourSignature>"
}
レスポンスの成功例
Header:
{
    "content-length": "41", 
    "server": "nginx/1.6.1", 
    "connection": "close", 
    "date": "Thu, 12 Nov 2015 03:56:57 GMT", 
    "content-type": "application/json", 
    "x-log-requestid": "56440E0999248C070600C6AA"
}
Body:
{
    "cursor": "MTQ0NzI5OTYwNjg5NjYzMjM1Ng=="
}