消息队列 CKafka 基于 Apache Kafka 开源生态提供托管服务，支持通过控制台、腾讯云 API 和开源客户端执行相应操作。为降低部分管理操作带来的运行风险，自2026年11月起，CKafka 提供 Admin API 封禁能力。封禁生效后，无法通过开源 AdminClient、脚本或第三方工具调用受限 API；如有相关管理需求，请使用控制台功能或腾讯云 API。
说明：
本文的 Admin API 指通过 Kafka 协议调用的管理接口，与腾讯云 API 不同。替换调用时需按腾讯云 API 的参数和鉴权方式进行适配，不能仅替换请求地址。
影响范围
自2026年11月16日起，符合以下形态及版本要求的新增实例默认开启 Admin API 封禁。存量实例（已在线上运行的实例）为保持兼容性，默认不封禁。
支持形态：仅 Serverful 实例支持，Serverless 实例暂不适用。
支持版本：实例内核需达到所属系列对应的最低小版本，具体如下。
2.4.2系列：2.4.2_1.2.8及以上小版本
2.8.1系列：2.8.1_1.1.17及以上小版本
3.2.3系列：3.2.3_1.0.12及以上小版本
说明：
存量实例系统默认允许通过 Admin API 执行操作，变配规格、升级小版本等操作不会自动更改此默认行为。为了确保集群运行的稳定性，建议您手动开启 Admin API 的封禁，使用控制台或云 API 管理 CKafka 实例。
涉及的 Admin API 列表
以下 API 在封禁生效后将无法调用：
|
DELETE_TOPICS | deleteTopics(...) | 删除 Topic。 |
CREATE_ACLS | createAcls(...) | 创建资源访问控制策略。 |
ALTER_CONFIGS | alterConfigs(...) | 修改 Topic、Broker 等资源配置。 |
INCREMENTAL_ALTER_CONFIGS | incrementalAlterConfigs(...) | 增量修改资源配置，例如设置、删除或调整配置项。 |
DELETE_RECORDS | deleteRecords(...) | 删除指定分区中 offset 小于指定值的消息记录。 |
DELETE_ACLS | deleteAcls(...) | 删除符合过滤条件的 ACL。 |
CREATE_PARTITIONS | createPartitions(...) | 增加已有 Topic 的分区数。 |
DELETE_GROUPS | deleteConsumerGroups(...) | 删除消费组。 |
ELECT_LEADERS | electLeaders(...) | 为分区触发 Leader 选举。 |
ALTER_PARTITION_REASSIGNMENTS | alterPartitionReassignments(...) | 更改或取消分区副本重分配。 |
DESCRIBE_CLIENT_QUOTAS | describeClientQuotas(...) | 查询用户、客户端等配额实体及其配额。 |
ALTER_CLIENT_QUOTAS | alterClientQuotas(...) | 修改或移除客户端配额。 |
ALTER_USER_SCRAM_CREDENTIALS | alterUserScramCredentials(...) | 新增、修改或删除用户的 SASL/SCRAM 凭据。 |
ALTER_REPLICA_LOG_DIRS | alterReplicaLogDirs(...) | 将副本日志移动至指定存储目录。 |
注意：
以上为 Java 客户端方法示例，其他语言 SDK 的方法名可能不同，请根据所用 SDK 核对。
封禁生效后，不支持在控制台上解除封禁，如有需求，请 联系我们 评估。 开启 Admin API 封禁
Serverful 专业版存量实例可按以下步骤手动开启 Admin API 封禁。操作前请完成调用自查和业务适配。
2. 在左侧导航栏选择实例列表，单击目标实例 ID 进入详情页。
3. 在实例详情页面，查看实例基本信息中的内核版本，确认当前小版本是否达到或超过支持封禁的最低版本，如果您的实例版本低于以下最低要求，请先执行 实例内核小版本升级。 |
2.4.x | 2.4.2_1.2.8 |
2.8.x | 2.8.1_1.1.17 |
3.2.x | 3.2.3_1.0.12 |
4. 在页面左侧选择智能运维页签，二级页签选择一键诊断。如您未封禁高风险 Admin API，诊断结果的安全治理分类下将展示 Admin API 权限的高风险诊断项。您可根据产品引导，关闭高风险 Admin API 权限。
注意：
封禁生效后，不支持在控制台上解除封禁，如有需求，请 联系我们 评估。