MergeShards

请求语法

POST /logstores/logstoreName/shards/shardID 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 09:37:18 GMT

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

请求参数

• 请求头

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

• 参数列表

  参数名称	数据类型	是否必填	示例值	描述
  projectName	String	是	ali-test-project	Project名称。
  logstoreName	String	是	logstorename	Logstore名称。
  shardID	Integer	是	30	Shard ID。

返回数据

• 响应头

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

• 响应元素
  返回HTTP状态码200，表示请求成功。请求成功后，其响应Body中包含3个Shard元素组成的数组，第一个Shard为合并之后的Shard，后两个为合并之前的Shard。各参数如下所示：

  参数名称	数据类型	示例值	描述
  shardID	Integer	167	Shard ID。
  status	String	readwrite	分区状态包括： readonly：只读数据 readwrite：读写数据
  inclusiveBeginKey	String	ee000000000000000000000000000000	分区起始的Key值。
  exclusiveEndKey	String	ffffffffffffffffffffffffffffffff	分区结束的Key值。
  createTime	String	1453953105	分区的创建时间。Unix时间戳格式，表示从1970-1-1 00:00:00 UTC计算起的秒数。

示例

• 请求示例

  POST /logstores/logstorename/shards/30
  Header :
  {
      "Content-Length": 0, 
      "x-log-signaturemethod": "hmac-sha1", 
      "x-log-bodyrawsize": 0, 
      "User-Agent": "log-python-sdk-v-0.6.0", 
      "Host": "ali-test-project.cn-hangzhou.sls.aliyuncs.com", 
      "Date": "Thu, 12 Nov 2015 03:40:31 GMT", 
      "x-log-apiversion": "0.6.0", 
      "Authorization": "LOG yourAccessKeyId:yourSignature"
  }

• 正常返回示例

  Header:
  {
      "content-length": "57", 
      "server": "nginx/1.6.1", 
      "connection": "close", 
      "date": "Thu, 12 Nov 2015 03:40:31 GMT", 
      "content-type": "application/json", 
      "x-log-requestid": "56440A2F99248C050600C74C"
  }
  Body :
  [
      {
          'shardID': 167, 
          'status': 'readwrite', 
          'inclusiveBeginKey': 'e0000000000000000000000000000000',
          'createTime': 1453953105,
          'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
      }, 
      {
          'shardID': 30, 
          'status': 'readonly', 
          'inclusiveBeginKey': 'e0000000000000000000000000000000', 
          'createTime': 0, 
          'exclusiveEndKey': 
          'e7000000000000000000000000000000'
      },
      {
          'shardID': 166, 
          'status': 'readonly', 
          'inclusiveBeginKey': 'e7000000000000000000000000000000', 
          'createTime': 1453953073, 
          'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
      }
  ]

错误码

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