更新时间：2026-01-27 GMT+08:00

修改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的数量。

响应参数

无

请求示例

修改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	调整副本操作成功。

错误码

请参见错误码。

父主题： 实例管理