文档首页/ 分布式消息服务Kafka版/ API参考/ 历史API/ API V1/ 实例使用类接口/ 调整Kafka实例Topic分区的副本
更新时间：2025-12-24 GMT+08:00
查看PDF
分享

调整Kafka实例Topic分区的副本

当前页面API为历史版本API，未来可能停止维护。请使用Kafka实例开始分区平衡任务。

URI

POST /v1.0/{project_id}/instances/{instance_id}/manage/topics/{topic}/replicas-reassignment

参数说明如下表所示。

表1 参数说明

参数

类型

必选

说明

project_id

String

是

项目ID。

instance_id

String

是

实例ID。

topic

String

是

Topic名称。

请求消息

请求参数

表2 参数说明

参数

类型

必选

说明

partitions

Array of object partitions

是

期望调整的分区副本分配情况。参数参考表3。
表3 partitions参数说明

参数

类型

必选

说明

partition

Integer

是

分区ID。

replicas

Array of integer

是

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

请求示例

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

响应消息

响应参数

无

响应示例

无

状态码

操作成功的状态码。

表4 状态码

状态码

描述

204

调整副本操作成功。
父主题： 实例使用类接口

相关文档