隣接する 2 つのシャードを読み書きステータスで結合します。 パラメーターにシャード ID を指定すると、ログ サービスは右側の隣接するシャードを自動的に検出します。
リクエスト構文
POST /logstores/<logstorename>/shards/<shardid>? action=merge 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 |
GetConfig API には特別なリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンスヘッダーContent-Type: application/json
ApplyConfigToMachineGroup API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。
レスポンス要素3 つのシャードで構成される配列の場合、最初のシャードがマージの結果で、他の 2 つはマージされません。
[
{
'shardID': 167,
'status': 'readwrite',
'inclusiveBeginKey': 'e0000000000000000000000000000000',
'createTime': 1453953105,
'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
},
{
'shardID': 30,
'status': 'readonly',
'inclusiveBeginKey': 'e0000000000000000000000000000000',
'createTime': 0,
'exclusiveEndKey':
'e7000000000000000000000000000000'
},
{
'shardID': 166,
'status': 'readonly',
'inclusiveBeginKey': 'e7000000000000000000000000000000',
'createTime': 1453953073,
'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
}
]
Log Service API の一般的なエラーコードの他に、GetLogs API から次の特別なエラーコードが返される場合があります。
HTTP ステータスコード | エラーコード | エラーメッセージ |
---|---|---|
404 | LogStoreNotExist | logstore {logstoreName} は存在しません |
400 | ParameterInvalid | 無効なシャード ID |
400 | ParameterInvalid | 最後のシャードをマージすることはできません |
500 | InternalServerError | 指定されたサーバーエラーメッセージ |
400 | LogStoreWithoutShard | logstore にシャードがありません |
注 前述のエラー メッセージの {name} は、特定の Logstore 名に置き換えられます。
例
リクエスト例
POST /logstores/logstorename/shards/30? action=merge
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': 167,
'status': 'readwrite',
'inclusiveBeginKey': 'e0000000000000000000000000000000',
'createTime': 1453953105,
'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
},
{
'shardID': 30,
'status': 'readonly',
'inclusiveBeginKey': 'e0000000000000000000000000000000',
'createTime': 0,
'exclusiveEndKey':
'e7000000000000000000000000000000'
},
{
'shardID': 166,
'status': 'readonly',
'inclusiveBeginKey': 'e7000000000000000000000000000000',
'createTime': 1453953073,
'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
}
]