分裂主题分区

最后更新时间:2020-10-16 15:08:59

    功能描述

    本接口用于分裂一个读写态的主题分区。

    请求

    请求示例

    POST /partitions?topic_id=xxxx-xx-xx-xx-xxxx&partition_id=1&split_key=7fffffffffffffffffffffffffffffffffff&action=split HTTP/1.1
    Host: <Region>.cls.tencentyun.com
    Authorization: <AuthorizationString>

    请求头

    除公共头部外,无特殊请求头部。

    请求参数

    字段名 类型 位置 是否必须 说明
    topic_id string query 分区所属的日志主题 ID
    partition_id int query 需分裂的主题分区编号
    action string query 操作类型,action 需要设置为 split
    split_key string query 分裂成两个时,可以指定主题分区的分裂位置,32位16进制字符串(不含0x部分);当分裂成3个及以上时,按平均方式分裂,此参数不生效
    number int query 分裂的个数,默认值为2

    响应

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json
    Content-Length: 21
    
    {
        "partitions":[
            {
                "partition_id": 1,
                "status": "readonly",
                "inclusive_begin_key": "000000000000000000000000000000000000",
                "exclusive_end_key": "ffffffffffffffffffffffffffffffffffff",
                "create_time": "2019-01-14 19:19:41"
            },
            {
               "partition_id": 2,
                "status": "readwrite",
                "inclusive_begin_key": "000000000000000000000000000000000000",
                "exclusive_end_key": "7fffffffffffffffffffffffffffffffffff",
                "create_time": "2019-01-14 19:25:41"
            },
            {
                "partition_id": 3,
                "status": "readwrite",
                "inclusive_begin_key": "7fffffffffffffffffffffffffffffffffff",
                "exclusive_end_key": "ffffffffffffffffffffffffffffffffffff",
                "create_time": "2019-01-14 19:25:41"
            }
        ]
    }

    响应头

    除公共响应头部外,无特殊响应头部。

    响应参数

    字段名 类型 说明
    partition_id int 主题分区编号
    status string 主题分区状态:
  • readwrite:读写态
  • readonly:只读态
  • inclusive_begin_key string 主题分区范围的起始位置
    exclusive_end_key string 主题分区范围的结束位置
    create_time string 主题分区的创建时间

    错误码

    参见 错误码

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助