Merges two adjacent shards that are in the readwrite state.

Request syntax

aliyunlog log merge_shard --project_name=<value> --logstore_name=<value> --shardId=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Request parameters

The following table describes the required and specific parameters of the merge_shard command.
--project_nameStringYesaliyun-test-projectThe name of the project.
--logstore_nameStringYeslogstore-aThe name of the Logstore.
--shardIdIntegerYes2The ID of the shard.
For information about the global parameters of the Log Service command-line interface (CLI), see Global parameters.


  • Sample requests
    Use the default account to merge the shards of a Logstore named logstore-a.
    aliyunlog log merge_shard --project_name="aliyun-test-project" --logstore_name="logstore-a" --shardId=2
  • Sample responses
        "createTime": 1622095017,
        "exclusiveEndKey": "80000000000000000000000000000000",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "shardID": 4,
        "status": "readwrite"
    }, {
        "createTime": 1622087815,
        "exclusiveEndKey": "40000000000000000000000000000000",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "shardID": 2,
        "status": "readonly"
    }, {
        "createTime": 1622087815,
        "exclusiveEndKey": "80000000000000000000000000000000",
        "inclusiveBeginKey": "40000000000000000000000000000000",
        "shardID": 3,
        "status": "readonly"

Error codes

If an error message is returned, fix the error based on the error codes of the related API operation. For more information, see Error codes of MergeShard.

API reference