LogStore で使用可能なすべてのシャードを一覧表示します。

リクエスト構文

GET /logstores/<logstorename>/shards HTTP/1.1
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

リクエストパラメーター

パラメータ名 Type 必須 説明
logstoreName string 必須 Logstore 名
リクエストヘッダー

特別なリクエストヘッダーはありません。 ListShards API に特別のリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。

レスポンスヘッダー

特別のレスポンスヘッダーはありません。 ListShards API に特別のレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。

レスポンス要素
配列は シャードで構成されています。
[
    {
        "shardID": 0,
        "status": "readwrite",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "exclusiveEndKey": "8000000000000000000000000000000",
        "createTime": 1453949705
    },
    {
        ...
    },
    {
        ...
    }
]
エラーコード

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

HTTP ステータスコード エラー コード エラーメッセージ
404 LogStoreNotExist logstore {logstoreName} does not exist
500 InternalServerError Specified server error message
400 Logstorewithoutshard logstore has no shard
前述のエラー メッセージの {name} は、特定の Logstore 名に置き換えられます。

リクエスト例
GET /logstores/sls-test-logstore/shards
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:40:31 GMT", 
    "x-log-apiversion": "0.6.0", 
    "Authorization": "LOG <yourAccessKeyId>:<yourSignature>"
}
レスポンス例
Header:
{
    "content-length": "57", 
    "server": "nginx/1.6.1", 
    "connection": "close", 
    "date": "Thu, 12 Nov 2015 03:40:31 GMT", 
    "content-type": "application/json", 
    "x-log-requestid": "56440A2F99248C050600C74C"
}
Body :
[
    {
        "shardID": 1,
        "status": "readwrite",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "exclusiveEndKey": "800000000000000000000000000000000000000000000",
        "createTime": 1453949705
    },
    {
        "shardID": 2,
        "status": "readwrite",
        "inclusiveBeginKey": "80000000000000000000000000000000",
        "exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
        "createTime": 1453949705
    },
    {
        "shardID": 0,
        "status": "readonly",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
        "createTime": 1453949705
    }
]