CreateTopic - 创建Topic

调用CreateTopic创建Topic。

接口说明

  • 单用户请求频率限制为1 QPS。

  • 每个实例下最多可创建的Topic数量与您所购买的实例规格相关。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
alikafka:CreateTopicWrite
    全部资源

请求参数

名称类型必填描述示例值
InstanceIdstring

实例ID。

alikafka_pre-cn-mp919o4v****
Topicstring

Topic的名称。

  • 只能包含字母、数字、下划线(_)和短划线(-)。

  • 长度限制为3~64字符,多于64个字符将被自动截取。

  • Topic名称一旦创建,将无法修改。

alikafka_topic_test
Remarkstring

Topic的备注。

  • 只能包含字母、数字、下划线(_)、短划线(-)。

  • 长度为3~64字符。

alikafka_topic_test
RegionIdstring

Topic所在实例的地域ID。

cn-hangzhou
CompactTopicboolean

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

  • false:delete清理策略。
  • true:compact清理策略。
false
PartitionNumstring

Topic的分区数。

  • 分区数限制1~360。

  • 控制台会根据实例规格提供不同的配置建议,请根据控制台建议配置分区数,减少数据倾斜风险。

  • 特殊需求请提交工单。

12
LocalTopicboolean

Topic的存储引擎。取值:

  • false:云存储。
  • true:Local存储。
false
ReplicationFactorlong

Topic的副本数。

  • 仅当LocalTopic值为true<props="local_disk">,或规格类型开源版(本地盘),才可以指定该参数。

  • 副本数限制1~3。

说明副本数为1时,有数据丢失的风险,请谨慎设置。
3
MinInsyncReplicaslong

最小ISR同步副本数。

  • 仅当LocalTopic值为true<props="local_disk">,或规格类型开源版(本地盘),才可以指定该参数。

  • 取值需小于Topic副本数。

  • 同步副本数限制1~3。

1
Configobject

补充配置。

  • 必须为JSON格式。

  • 目前仅支持Key为replications。表示Topic副本数,取值类型为Integer,取值限制1~3。

  • 仅当LocalTopic值为true<props="local_disk">,或规格类型开源版(本地盘),才可以指定该参数。

说明如果该参数中指定了replications,指定的ReplicationFactor参数不再生效。
Tagarray
object
Keystring

资源的标签键。

  • N为1~20。

  • 如果为空,则匹配所有标签键。

  • 最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

FinanceDept
Valuestring

资源的标签值。

  • N为1~20。

  • 可以为空。

  • 最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

FinanceJoshua

返回参数

名称类型描述示例值
object
Codeinteger

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

200
Messagestring

返回信息。

operation success
RequestIdstring

请求的ID。

9C0F207C-77A6-43E5-991C-9D98510A****
Successboolean

调用是否成功。

true

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
2022-11-13
变更项变更内容
2022-10-28OpenAPI 入参发生变更
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:Tag
2021-11-17OpenAPI 入参发生变更
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:ReplicationFactor
    新增入参:MinInsyncReplicas
    新增入参:Config
阿里云首页 消息队列Kafka版 相关技术圈