调用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的名称。
|
Remark | String | 是 | alikafka_topic_test |
Topic的备注。
|
RegionId | String | 是 | cn-hangzhou |
Topic所在实例的地域ID。 |
CompactTopic | Boolean | 否 | false |
Topic的存储引擎配置为Local存储时,会配置日志清理策略。取值:
|
PartitionNum | String | 否 | 12 |
Topic的分区数。
|
LocalTopic | Boolean | 否 | false |
Topic的存储引擎。取值:
|
ReplicationFactor | Long | 否 | 3 |
Topic的副本数。
说明 副本数为1时,有数据丢失的风险,请谨慎设置。
|
MinInsyncReplicas | Long | 否 | 1 |
最小ISR同步副本数。
|
Config | Map | 否 | {"replications": 3} |
补充配置。
说明 如果该参数中指定了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
}
错误码
访问错误中心查看更多错误码。