You need to enable JavaScript to run this app.
导航

ManualShardSplit

最近更新时间2023.11.13 16:31:42

首次发布时间2023.11.02 15:01:20

调用 ManualShardSplit 接口手动分裂指定分区。

使用说明

此接口用于手动分裂指定分区。调用频率限制为 20 次/s,单个日志主题中,手动分裂的并发数限制为 1,超出限制会报错 ExceedQPSLimit。

URI

请求方法
POST

URI

https://tls-{Region}.ivolces.com/ManualShardSplit

传输协议

HTTPS

请求参数

参数
参数类型
是否必选
示例值
说明

TopicId

String

4a*********

日志主题 ID。

ShardId

Integer

0

待手动分裂的日志分区 ID。

Number

Integer

4

分区的分裂数量。

  • 分裂数量应为非零偶数,例如 2、4、8 或 16。
  • 分裂后读写状态分区总数不能超过 50 个。

响应参数

参数
类型
示例值
描述

Shards

Array of QueryResp

/

日志分区的范围等详细信息。详细信息请参考 QueryResp

示例

请求示例

POST https://tls-{Region}.ivolces.com/ManualShardSplit HTTP/1.1
Content-Type: application/json
...
{
  "TopicId": "580f17e4-958f-4f0d-8085-ac7732b2****",
  "Number": 2,
  "ShardId": 0
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
...
{
    "Shards": [
        {
            "TopicId": "580f17e4-958f-4f0d-8085-ac7732b2****",
            "ShardId": 0,
            "InclusiveBeginKey": "00000000000000000000000000000000",
            "ExclusiveEndKey": "ffffffffffffffffffffffffffffffff",
            "Status": "readonly",
            "ModifyTime": "2023-10-31 15:11:21",
            "StopWriteTime": "2023-10-31 15:11:21"
        },
        {
            "TopicId": "580f17e4-958f-4f0d-8085-ac7732b2****",
            "ShardId": 1,
            "InclusiveBeginKey": "00000000000000000000000000000000",
            "ExclusiveEndKey": "7fffffffffffffffffffffffffffffff",
            "Status": "readwrite",
            "ModifyTime": "0001-01-01 00:00:00",
            "StopWriteTime": ""
        },
        {
            "TopicId": "580f17e4-958f-4f0d-8085-ac7732b2****",
            "ShardId": 2,
            "InclusiveBeginKey": "7fffffffffffffffffffffffffffffff",
            "ExclusiveEndKey": "ffffffffffffffffffffffffffffffff",
            "Status": "readwrite",
            "ModifyTime": "0001-01-01 00:00:00",
            "StopWriteTime": ""
        }
    ]
}

错误码

错误码(Code)
HTTP 状态码
错误信息(Message)
说明

InvalidArgument

400

Invalid argument key %s, value %s, please check argument.

参数不合法。

TopicNotExist

404

Topic does not exist.

日志主题不存在。

InternalServerError

500

We encountered an unexpected server error, please try again later.

服务器内部错误。

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