调用CreateTopic创建Topic。

  • 单用户请求频率限制为1 QPS。
  • 每个实例下最多可创建的Topic数量与您所购买的实例规格相关。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateTopic

要执行的操作。取值:

CreateTopic

InstanceId String alikafka_pre-cn-mp919o4v****

实例ID。

RegionId String cn-hangzhou

实例的地域ID。

Remark String alikafka_topic_test

Topic的备注。

  • 只能包含字母、数字、下划线(_)、短划线(-)。
  • 长度为3~64字符。
Topic String alikafka_topic_test

Topic的名称。

  • 只能包含字母、数字、下划线(_)和短划线(-)。
  • 长度限制为3~64字符,多于64个字符将被自动截取。
  • Topic名称一旦创建,将无法修改。
PartitionNum String 12

Topic的分区数。

  • 分区数限制1~360。
  • 建议分区数是6的倍数,减少数据倾斜风险。
  • 特殊需求请提交工单。

返回数据

名称 类型 示例值 描述
Code Integer 200

返回码。返回200代表成功。

Message String operation success

返回信息。

RequestId String 9C0F207C-77A6-43E5-991C-9D98510A****

请求的ID。

Success Boolean true

调用是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateTopic
&InstanceId=alikafka_pre-cn-mp919o4v****
&RegionId=cn-hangzhou
&Remark=alikafka_topic_test
&Topic=alikafka_topic_test
&<公共请求参数>

正常返回示例

XML 格式

<CreateTopicResponse>
      <RequestId>9C0F207C-77A6-43E5-991C-9D98510A****</RequestId>
      <Message>operation success</Message>
      <Code>200</Code>
      <Success>true</Success>
</CreateTopicResponse>

JSON 格式

{
    "RequestId": "9C0F207C-77A6-43E5-991C-9D98510A****",
    "Message": "operation success",
    "Code": 200,
    "Success": true
}

错误码

访问错误中心查看更多错误码。