ListShards

请求语法

GET /logstores/logstorename/shards HTTP/1.1
Content-Length: 0
x-log-bodyrawsize: 0
x-log-apiversion: 0.6.0
x-log-signaturemethod': hmac-sha1
Host: ProjectName.Endpoint
Date: GMT Date
Authorization: LOG yourAccessKeyId:yourSignature
x-log-date: Mon, 30 Nov 2020 06:22:17 GMT   

其中，Host由Project名称和日志服务Endpoint构成，您需要在Host中指定Project。

请求参数

• 请求头

  ListShards接口无特有请求头。关于Log Service API的公共请求头，请参见公共请求头。

• 参数列表

  参数名称	数据类型	是否必填	示例值	描述
  projectName	String	是	ali-test-project	Project名称。
  logstoreName	String	是	sls-test-logstore	Logstore名称。

返回数据

• 响应头

  ListShards接口无特有响应头。关于Log Service API的公共响应头，请参见公共响应头。

• 响应元素
  返回HTTP状态码200，表示请求成功。请求成功后，其响应Body中包含Shard信息，如下所示：

  参数名称	数据类型	示例值	描述
  shardID	Integer	0	Shard ID。
  status	String	readwrite	Shard状态。
  inclusiveBeginKey	String	00000000000000000000000000000000	Shard起始的Key值，在Shard MD5范围中包含该值。
  exclusiveEndKey	String	8000000000000000000000000000000	Shard结束的Key值，在Shard MD5范围中不包含该值。
  createTime	String	1453949705	Shard的创建时间。Unix时间戳格式，表示从1970-1-1 00:00:00 UTC计算起的秒数。

示例

• 请求示例

  GET /logstores/sls-test-logstore/shards
  Header :
  {
  'Content-Length': '0'
  'x-log-bodyrawsize': '0'
  'x-log-apiversion': '0.6.0'
  'x-log-signaturemethod': 'hmac-sha1'
  'Host': ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com
  'Date': Mon, 30 Nov 2020 06:22:17 GMT
  'Authorization': 'LOG yourAccessKeyId:yourSignature'
  'x-log-date': 'Mon, 30 Nov 2020 06:22:17 GMT'
  }

• 返回示例

  Header:
  {
  'Server': 'Tengine',
  'Content-Type': 'application/json',
  'Content-Length': '335',
  'Connection': 'close',
  'Access-Control-Allow-Origin': '*',
  'Date': 'Mon, 30 Nov 2020 08:32:24 GMT',
  'x-log-requestid': '5FC4AE1821CA7D41C5F14728'   
  }
  Body :
  [
      {
          "shardID": 1,
          "status": "readwrite",
          "inclusiveBeginKey": "00000000000000000000000000000000",
          "exclusiveEndKey": "8000000000000000000000000000000",
          "createTime": 1453949705
      },
      {
          "shardID": 2,
          "status": "readwrite",
          "inclusiveBeginKey": "80000000000000000000000000000000",
          "exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
          "createTime": 1453949705
      },
      {
          "shardID": 0,
          "status": "readonly",
          "inclusiveBeginKey": "00000000000000000000000000000000",
          "exclusiveEndKey": "ffffffffffffffffffffffffffffffff",
          "createTime": 1453949705
      }
  ]

错误码

更多错误码，请参见通用错误码。