文档首页/ 分布式消息服务Kafka版/ API参考（吉隆坡区域）/ API V2（推荐）/ 主题管理/ 修改Kafka实例Topic分区的副本
更新时间：2025-09-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改Kafka实例Topic分区的副本

功能介绍

修改Kafka实例Topic分区的副本。

URI

POST /v2/{project_id}/instances/{instance_id}/management/topics/{topic}/replicas-reassignment

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方式请参见获取项目ID。

instance_id

是

String

实例ID。

topic

是

String

Topic名称。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

partitions

否

Array of partitions objects

期望调整的分区副本分配情况。
表3 partitions

参数

是否必选

参数类型

描述

partition

否

Integer

分区ID。

replicas

否

Array of integers

副本期望所在的broker ID。其中Array首位为leader副本，所有分区需要有同样数量的副本，副本数不能大于总broker的数量。

响应参数

状态码：204

调整副本操作成功。

无

请求示例

修改Topic分区的副本分布位置，分区1的副本分布在broker 1和broker 2，Leader副本在broker 1。

POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/management/topics/{topic}/replicas-reassignment

{
  "partitions" : [ {
    "partition" : 1,
    "replicas" : [ 1, 2 ]
  }, {
    "partition" : 0,
    "replicas" : [ 0, 1 ]
  } ]
}

响应示例

无

状态码

状态码

描述

204

调整副本操作成功。

错误码

请参见错误码。

父主题： 主题管理