调用CreateTopic创建Topic。

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

调试

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

请求参数

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

系统规定参数。取值：CreateTopic。

InstanceId String 是 alikafka_pre-cn-mp919o4v****

实例ID。
Topic String 是 alikafka_topic_test

Topic的名称。

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

Topic的备注。

  • 只能包含字母、数字、下划线（_）、短划线（-）。
  • 长度为3~64字符。
RegionId String 是 cn-hangzhou

Topic所在实例的地域ID。
CompactTopic Boolean 否 false

Topic的存储引擎配置为Local存储时，会配置日志清理策略。取值：

  • false：delete清理策略。
  • true：compact清理策略。
PartitionNum String 否 12

Topic的分区数。

  • 分区数限制1~360。
  • 控制台会根据实例规格提供不同的配置建议，请根据控制台建议配置分区数，减少数据倾斜风险。
  • 特殊需求请提交工单。
LocalTopic Boolean 否 false

Topic的存储引擎。取值：

  • false：云存储。
  • true：Local存储。
ReplicationFactor Long 否 3

Topic的副本数。

  • 仅当LocalTopic值为true，才可以指定该参数。
  • 副本数限制1~3。
说明 副本数为1时，有数据丢失的风险，请谨慎设置。
MinInsyncReplicas Long 否 1

最小ISR同步副本数。

  • 仅当LocalTopic值为true，才可以指定该参数。
  • 取值需小于Topic副本数。
  • 同步副本数限制1~3。
Config Map 否 {"replications": 3}

补充配置。

  • 必须为JSON格式。
  • 目前仅支持Key为replications。表示Topic副本数，取值类型为Integer，取值限制1~3。
  • 仅当LocalTopic值为true，才可以指定该参数。
说明 如果该参数中指定了replications，指定的ReplicationFactor参数不再生效。

返回数据

名称 类型 示例值 描述
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格式 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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