文档中心>日志服务

分裂主题分区

最近更新时间:2020-10-15 15:26:50

我的收藏

功能描述

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

请求

请求示例

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
主题分区的创建时间

错误码

参见 错误码