隣接する 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'
    }
]