Queries the shards of a specified Logstore.

Request syntax

aliyunlog log list_shards --project_name=<value> --logstore_name=<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 list_shards command.
Parameter Type Required Example Description
--project_name String Yes project-a The name of the project.
--logstore_name String Yes logstore-a The name of the Logstore.
For information about the global parameters of the Log Service command-line interface (CLI), see Global variables.


  • Sample requests
    Query the shards of a Logstore named logstore-b. logstore-b belongs to the default account.
    aliyunlog log list_shards --project_name="project-a" --logstore_name="logstore-a"
  • Sample responses
        "createTime": 1619493098,
        "exclusiveEndKey": "80000000000000000000000000000000",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "shardID": 0,
        "status": "readwrite"
        "createTime": 1619493098,
        "exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
        "inclusiveBeginKey": "80000000000000000000000000000000",
        "shardID": 1,
        "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 ListShards.

API reference