调用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。
  • 建议分区数是6的倍数,减少数据倾斜风险。
  • 特殊需求请提交工单。
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
}

错误码

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