全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
日志服务

MergeShards

更新时间:2018-04-02 20:38:21

合并两个相邻的 readwrite 状态的 Shards。在参数中指定一个 shardid,服务端自动找相邻的下一个 Shard。

请求语法

  1. POST /logstores/<logstorename>/shards/<shardid>?action=merge HTTP/1.1
  2. Authorization: <AuthorizationString>
  3. Date: <GMT Date>
  4. Host: <Project Endpoint>
  5. x-log-apiversion: 0.6.0
  6. x-log-signaturemethod: hmac-sha1

请求参数

参数名称 类型 是否必须 描述
logstoreName string 日志库名称
shardid int shard ID

请求头

无特有请求头。关于 API 的公共请求头,请参考 公共请求头

响应头

Content-Type: application/json

无特有响应头。关于 API 的公共响应头,请参考 公共响应头

响应元素

3 个 Shard 元素组成的数组,第一个 shard 为 merge 之后的 Shard,后两个为 merge 之前的 Shard。

  1. [
  2. {
  3. 'shardID': 167,
  4. 'status': 'readwrite',
  5. 'inclusiveBeginKey': 'e0000000000000000000000000000000',
  6. 'createTime': 1453953105,
  7. 'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
  8. },
  9. {
  10. 'shardID': 30,
  11. 'status': 'readonly',
  12. 'inclusiveBeginKey': 'e0000000000000000000000000000000',
  13. 'createTime': 0,
  14. 'exclusiveEndKey':
  15. 'e7000000000000000000000000000000'
  16. },
  17. {
  18. 'shardID': 166,
  19. 'status': 'readonly',
  20. 'inclusiveBeginKey': 'e7000000000000000000000000000000',
  21. 'createTime': 1453953073,
  22. 'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
  23. }
  24. ]

细节描述

N/A

特有错误码

除了返回 API 的 通用错误码,还可能返回如下特有错误码:

HTTP 状态码 ErrorCode ErrorMessage
404 LogStoreNotExist logstore {logstoreName} does not exist
400 ParameterInvalid invalid shard id
400 ParameterInvalid can not merge the last shard
500 InternalServerError Specified Server Error Message
400 LogStoreWithoutShard logstore has no shard

上表错误消息中{name}表示该部分会被具体的 LogstoreName 来替换。

示例

请求示例:
  1. POST /logstores/logstorename/shards/30?action=merge
  2. Header :
  3. {
  4. "Content-Length": 0,
  5. "x-log-signaturemethod": "hmac-sha1",
  6. "x-log-bodyrawsize": 0,
  7. "User-Agent": "log-python-sdk-v-0.6.0",
  8. "Host": "ali-test-project.cn-hangzhou.sls.aliyuncs.com",
  9. "Date": "Thu, 12 Nov 2015 03:40:31 GMT",
  10. "x-log-apiversion": "0.6.0",
  11. "Authorization": "LOG 94to3z418yupi6ikawqqd370:xEOsJ3xeidfdgRq0GbvACiO37jH0I="
  12. }
响应示例:
  1. Header:
  2. {
  3. "content-length": "57",
  4. "server": "nginx/1.6.1",
  5. "connection": "close",
  6. "date": "Thu, 12 Nov 2015 03:40:31 GMT",
  7. "content-type": "application/json",
  8. "x-log-requestid": "56440A2F99248C050600C74C"
  9. }
  10. Body :
  11. [
  12. {
  13. 'shardID': 167,
  14. 'status': 'readwrite',
  15. 'inclusiveBeginKey': 'e0000000000000000000000000000000',
  16. 'createTime': 1453953105,
  17. 'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
  18. },
  19. {
  20. 'shardID': 30,
  21. 'status': 'readonly',
  22. 'inclusiveBeginKey': 'e0000000000000000000000000000000',
  23. 'createTime': 0,
  24. 'exclusiveEndKey':
  25. 'e7000000000000000000000000000000'
  26. },
  27. {
  28. 'shardID': 166,
  29. 'status': 'readonly',
  30. 'inclusiveBeginKey': 'e7000000000000000000000000000000',
  31. 'createTime': 1453953073,
  32. 'exclusiveEndKey': 'ffffffffffffffffffffffffffffffff'
  33. }
  34. ]
本文导读目录