tencentcloud_ckafka_topic

最近更新时间:2025-09-04 14:56:12

我的收藏

描述

CKafka 主题,产品介绍

示例

resource "tencentcloud_ckafka_topic" "local_foo" {
availability_zone = "ap-guangzhou-6"
instance_id = tencentcloud_ckafka_instance.kafka_instance_postpaid.id
topic_name = "example-local"
note = "topic note"
replica_num = 2
partition_num = 1
enable_white_list = true
ip_white_list = ["ip1", "ip2"]
clean_up_policy = "delete"
sync_replica_min_num = 1
unclean_leader_election_enable = false
segment = 3600000
retention = 60000
max_message_bytes = 1024
}

参数说明

类型
名称
数据类型
说明
必填
region
string
地域,如:ap-guangzhou,默认使用 provider 中定义的 region 也可以在 resource 中指定地域,覆盖默认设置
instance_id
string
CKafka 实例 ID
partition_num
int
Partition 个数,大于 0
replica_num
int
副本个数,不能多于 broker 数,最大为 3
topic_name
string
主题名称,是一个不超过 128 个字符的字符串,必须以字母为首字符,剩余部分可以包含字母、数字和横划线(-)
可选
availability_zone
string
可用区
count
int
资源数量,默认为 1 如果为 0 则不创建资源
activity_id
int
计费活动 ID,保留字段
clean_up_policy
string
清理日志策略,日志清理模式,默认为"delete"。
"delete":日志按保存时间删除
"compact":日志按 key 压缩
"compact, delete":日志按 key 压缩且会按保存时间删除
enable_white_list
boolean
IP 白名单开关,默认不打开
ip_white_list
string[]
IP 白名单列表,配额限制,enable_white_list 为 true 时必选
max_message_bytes
int
主题消息最大值,单位为 Byte,最小值1024Byte(即1KB),最大值为12582912Byte(即12MB)
note
string
主题备注,是一个不超过 64 个字符的字符串,必须以字母为首字符,剩余部分可以包含字母、数字和横划线(-)
retention
int
消息保留时间,单位 ms,当前最小值为60000ms
segment
int
Segment 分片滚动的时长,单位 ms,当前最小为3600000ms
sync_replica_min_num
int
最小同步副本数
unclean_leader_election_enable
boolean
是否允许未同步的副本选为 leader,默认不允许
false:不允许
true:允许
生成
id
string
资源实例 ID
create_time
string
资源创建时间