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
}
]