调用ListShards接口列出指定Logstore中所有的Shard。

接口说明

请求语法中Host由Project名称和日志服务Endpoint构成,您需要在Host中指定Project。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

GET /logstores/{logstore}/shards HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
logstore String Path ali-test-logstore

Logstore名称。

返回数据

名称 类型 示例值 描述
Array of shard

返回项目下所有Shard的列表。

示例

请求示例

GET /logstores/ali-test-logstore/shards HTTP/1.1
Host:ali-test-project.cn-hangzhou.log.aliyuncs.com
Content-Type:application/json

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

[ {
  "shardID" : 0,
  "status" : "readwrite",
  "inclusiveBeginKey" : "00000000000000000000000000000000",
  "exclusiveEndKey" : "8000000000000000000000000000000",
  "serverIp" : "",
  "createTime" : 1453949705
} ]

错误码

访问错误中心查看更多错误码。

HttpStatusCode

ErrorCode

ErrorMessage

错误码描述

404

ProjectNotExist

Project does not exist.

Project不存在。

404

LogStoreNotExist

Logstore logstoreName does not exist.

Logstore不存在。

400

ShardNotExist

Shard ShardID does not exist.

Shard不存在。

500

InternalServerError

Specified Server Error Message.

内部服务调用错误。

更多信息,请参见通用错误码