调用CreateTopic创建Topic。

调用该接口创建 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~48。
  • 建议分区数是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>
	    <Message>operation success</Message>
	    <RequestId>9C0F207C-77A6-43E5-991C-9D98510A****</RequestId>
	    <Success>true</Success>
	    <Code>200</Code>
</CreateTopicResponse>

JSON 格式

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

错误码

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