カーソルと数量に基づいてログを取得します。 システムがログを取得するときにシャードを指定する必要があります。 Storm などのシナリオでは、LoghubClientLib を使って選択的および共同消費を実行できます。 . 現時点では、Protocol Buffer (PB) フォーマットのみ読み取り可能です。

リクエスト構文

GET /logstores/ay42/shards/0? type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA==&count=100 HTTP/1.1
Accept: application/x-protobuf
Accept-Encoding: lz4
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

リクエストパラメーター

URL パラメーター：
パラメーター データ型 必須/省略可能 説明
型 string 必須 ログ
cursor string 必須 データの読み取りを開始する場所 (＝開始点) を示すために使用されるカーソル。
count int 必須 返されるロググループの数 (1 から 1000 )
リクエストヘッダー
  • Accept: application/x-protobuf
  • Accept-Encoding: lz4, deflate, or “”

Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。

レスポンスヘッダー
  • x-log-cursor：現在読み取られているデータの次のカーソル
  • x-log-count：現在返されているログの数
Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンス要素

PB 形式でシリアル化されたデータ (圧縮可能)

エラーコード

また、 一般的なエラー コード の他に、UpdateLogstore API から次の特殊なエラー コードが返される場合があります。

HTTP ステータスコード エラーコード エラーメッセージ
404 LogStoreNotExist Logstore {Name} は存在しません
400 Parameterinvalid Parameter Cursor は有効ではありません
400 ParameterInvalid ParameterCount の範囲は [0-1000] です
400 ShardNotExist Shard {ShardID} は存在しません
400 InvalidCursor このカーソルは無効です
500 InternalServerError 指定されたサーバーエラーメッセージ

例

リクエスト例 
Read data from shard 0.
GET /logstores/sls-test-logstore/shards/0? cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA==&count=1000&type=log  
Header:
{
    "Authorization"="LOG <yourAccessKeyId>:<yourSignature>", 
    "x-log-bodyrawsize"=0, 
    "User-Agent" : "sls-java-sdk-v-0.6.0", 
    "x-log-apiversion" : "0.6.0", 
    "Host" : "ali-test-project.cn-hangzhou-failover-intranet.sls.aliyuncs.com", 
    "x-log-signaturemethod" : "hmac-sha1", 
    "Accept-Encoding" : "lz4", 
    "Content-Length": 0,
    "Date" : "Thu, 12 Nov 2015 12:03:17 GMT",
    "Content-Type" : "application/x-protobuf", 
    "accept" : "application/x-protobuf"
}
レスポンス例 
Header:
{
    "x-log-count" : "1000", 
    "x-log-requestid" : "56447FB20351626D7C000874", 
    "Server" : "nginx/1.6.1", 
    "x-log-bodyrawsize" : "34121", 
    "Connection" : "close", 
    "Content-Length" : "4231", 
    "x-log-cursor" : "MTQ0NzMyOTQwMTEwMjEzMDkwNA==", 
    "Date" : "Thu, 12 Nov 2015 12:01:54 GMT", 
    "x-log-compresstype" : "lz4", 
    "Content-Type" : "application/x-protobuf"
}
Body:
The <log group list in PB format> after the compression.
ページフリップ

データを返さずにページを反転する (次のトークンを取得する) ために、 システムは HTTP HEAD リクエストを送信できます。