All Products
Search
Document Center

Simple Log Service:list_shards

Last Updated:Jun 16, 2026

Queries shard information for 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 parameters.

Parameter name

Data 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 more information about global parameters, see Global parameters.

Examples

  • Request example

    Query shard information for the logstore-a Logstore.

    aliyunlog log list_shards --project_name="project-a" --logstore_name="logstore-a"
  • Response example

    [
      {
        "createTime": 1619493098,
        "exclusiveEndKey": "80000000000000000000000000000000",
        "inclusiveBeginKey": "00000000000000000000000000000000",
        "shardID": 0,
        "status": "readwrite"
      },
      {
        "createTime": 1619493098,
        "exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
        "inclusiveBeginKey": "80000000000000000000000000000000",
        "shardID": 1,
        "status": "readwrite"
      }
    ]

Error codes

For more information about error codes, see Error codes.

API reference

ListShards