搜索本产品文档关键词
新增集群配置版本
所有文档
menu
没有找到结果,请重新输入

消息服务 for Kafka

新增集群配置版本

该接口用于在集群配置中新增一个版本。

请求结构

POST /v{version}/configs/{configId}/revisions HTTP/1.1
Host: kafka-api.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其他特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
version String URL参数 API版本号
configId String Query参数 配置ID
revisionId Integer Request Body参数 新增的版本号,需要是当前配置中最大版本号+1
description String Request Body参数 新增配置版本的描述信息
context Map<String, String> Request Body参数 新增配置版本的内容,如果缺少必选参数则自动补充必选项参数,必选参数列表可参见 配置参数介绍

返回头域

除公共头域外,无其他特殊头域。

返回参数

参数名称 类型 描述
revisionId Integer 新增的版本ID

错误码

错误码 错误描述 HTTP状态码 描述
CONFIG_NOT_FOUND 配置不存在 400 配置不存在
ERROR_PARAMS 请求参数错误 400 请求参数错误
CONFIG_REVISION_INVALID 配置版本异常 400 配置版本异常
CONFIG_REVISION_NUM_LIMIT 当前配置版本数量达到上限 400 当前配置版本数量达到上限
CONFIG_PARAMS_ERROR 配置参数异常 400 配置参数存在异常

请求示例

POST http://kafka-api.bj.baidubce.com/v2/configs/33a168bb70c0459787416077114ab233/revision
Authorization: bce-auth-v1/ALTAKaiKeDfBD880eMWBE5oIGE/2023-05-08T11:43:45Z/1800/host;x-bce-date/322f3f98ce57d296c0f5abc64e5554b640ea035c5cb462fcaeab54b9810a3c61
Host: kafka-api.bj.baidubce.com
{
  "revisionId": 2,
  "description": "描述信息",
  "context" : {
      "auto.create.topics.enable": "true",
      "log.retention.hours": "1",
      "log.retention.bytes": "-1"
  }
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 97e6d4ad-6fca-4609-ad4d-9a27c4d1a362
Date: Mon, 08 May 2023 09:39:11 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "revisionId": "2"
}
上一篇
删除集群配置
下一篇
查询集群配置版本详情