読み取りステータスで指定されたシャードを分割します。
リクエスト構文
POST /logstores/<logstorename>/shards/<shardid>? action=split&key=<splitkey> HTTP/1.1
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
リクエストパラメーター
パラメーター | データ型 | 必須 | 説明 |
---|---|---|---|
logstoreName | string | 必須 | Logstore 名 |
shardid | int | 必須 | シャード ID |
Splitkey | string | 必須 | 分割された場所 |
特別のリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンスヘッダーContent-Type: application/json
特別のレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。
レスポンス要素3 つのシャードで構成される配列では、最初のシャードは分割前の元のシャードで、他の 2 つは分割後に生成されるシャードです。
エラーコード[
{
"shardID": 33,
"status": "readonly",
"inclusiveBeginKey": "ee000000000000000000000000000000",
"exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
"createTime": 1453949705
},
{
"shardID": 163,
"status": "readwrite",
"inclusiveBeginKey": "ee000000000000000000000000000000",
"exclusiveEndKey": "ef000000000000000000000000000000",
"createTime": 1453949705
},
{
"shardID": 164,
"status": "readwrite",
"inclusiveBeginKey": "ef000000000000000000000000000000",
"exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
"createTime": 1453949705
}
]
Log Service API の 一般的なエラーコード の他に、SplitShard API から次の特殊なエラーコードが返される場合があります。
HTTP ステータスコード | エラーコード | エラーメッセージ |
---|---|---|
404 | LogStoreNotExist | logstore {logstoreName} does not exist |
400 | ParameterInvalid | invalid shard id |
400 | ParameterInvalid | invalid mid hash |
500 | InternalServerError | Specified Server Error Message |
400 | LogStoreWithoutShard | logstore has no shard |
注 表中のエラー メッセージの {name} は、特定の Logstore 名に置き換えられます。
例
リクエスト例
POST /logstores/logstorename/shards/33? action=split&key=ef000000000000000000000000000000
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.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": 33,
"status": "readonly",
"inclusiveBeginKey": "ee000000000000000000000000000000",
"exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
"createTime": 1453949705
},
{
"shardID": 163,
"status": "readwrite",
"inclusiveBeginKey": "ee000000000000000000000000000000",
"exclusiveEndKey": "ef000000000000000000000000000000",
"createTime": 1453949705
},
{
"shardID": 164,
"status": "readwrite",
"inclusiveBeginKey": "ef000000000000000000000000000000",
"exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
"createTime": 1453949705
}
]