All Products
Search
Document Center

Simple Log Service:split_shard

Last Updated:Oct 26, 2023

Splits a shard of a specified Logstore.

Request syntax

aliyunlog log split_shard --project_name=<value> --logstore_name=<value> --shardId=<value> --split_hash=<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 split_shard command.
ParameterTypeRequiredExampleDescription
--project_nameStringYesaliyun-test-projectThe name of the project.
--logstore_nameStringYeslogstore-bThe name of the Logstore.
--shardIdIntegerYes0The ID of the shard.
--split_hashStringYes40000000000000000000000000000000The position where the shard is split.
For information about the global parameters of the Log Service command-line interface (CLI), see Global parameters.

Examples

  • Sample requests
    Split a shard of a Logstore named logstore-b. logstore-b belongs to the default account.
    aliyunlog log split_shard --project_name="aliyun-test-project" --logstore_name="logstore-b" --shardId=0 --split_hash=40000000000000000000000000000000
  • Sample responses
    [{
        "createTime": 1614750027,
        "exclusiveEndKey": "80000000000000000000000000000000",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "shardID": 0,
        "status": "readonly"
    }, {
        "createTime": 1622087815,
        "exclusiveEndKey": "40000000000000000000000000000000",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "shardID": 2,
        "status": "readwrite"
    }, {
        "createTime": 1622087815,
        "exclusiveEndKey": "80000000000000000000000000000000",
        "inclusiveBeginKey": "40000000000000000000000000000000",
        "shardID": 3,
        "status": "readwrite"
    }]

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 SplitShard.

API reference

SplitShard