文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>云应用>服务商指南>参考手册>资源类型手册>tencentcloud_clb_listener_rule

tencentcloud_clb_listener_rule

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

我的收藏

本页目录：

描述

负载均衡监听器规则，产品介绍

示例

resource "tencentcloud_clb_listener_rule" "foo" {
  listener_id                = "lbl-hh141sn9"
  clb_id                     = "lb-k2zjp9lv"
  domain                     = "foo.net"
  url                        = "/bar"
  health_check_switch        = true
  health_check_interval_time = 5
  health_check_health_num    = 3
  health_check_unhealth_num  = 3
  health_check_http_code     = 2
  health_check_http_path     = "Default Path"
  health_check_http_domain   = "Default Domain"
  health_check_http_method   = "GET"
  certificate_ssl_mode       = "MUTUAL"
  certificate_id             = "VjANRdz8"
  certificate_ca_id          = "VfqO4zkB"
  session_expire_time        = 30
  scheduler                  = "WRR"
}

参数说明

类型
名称
数据类型
说明
必填
region
string
地域，如：ap-guangzhou，默认使用 provider 中定义的 region 也可以在 resource 中指定地域，覆盖默认设置
clb_id
string
CLB ID
listener_id
string
监听器 ID
domain
string
域名
url
string
URL 路径
可选
availability_zone
string
可用区
count
int
资源数量，默认为 1 如果为 0 则不创建资源
activity_id
int
计费活动 ID，保留字段
health_check_switch
boolean
是否开启健康检查
health_check_interval_time
int
健康检查时间间隔，单位秒，默认 5 秒
health_check_health_num
int
健康阈值，默认值：3
health_check_unhealth_num
int
不健康阈值，默认值：3
health_check_type
string
健康检查使用的协议。取值 TCP | HTTP | HTTPS | GRPC | PING | CUSTOM
health_check_time_out
int
健康检查的响应超时时间，可选值：2~60，默认值：2，单位：秒。响应超时时间要小于检查间隔时间
health_check_http_code
int
健康检查状态码（仅适用于 HTTP/HTTPS 转发规则、TCP 监听器的 HTTP 健康检查方式）。可选值：1~31，默认 31
health_check_http_path
string
健康检查路径（仅适用于 HTTP/HTTPS 转发规则、TCP 监听器的 HTTP 健康检查方式）
health_check_http_domain
string
健康检查域名（仅适用于HTTP/HTTPS监听器和TCP监听器的HTTP健康检查方式。针对 TCP 监听器，当使用 HTTP 健康检查方式时，该参数为必填项）
health_check_http_method
string
健康检查方法（仅适用于 HTTP/HTTPS 转发规则、TCP 监听器的 HTTP 健康检查方式），默认值：HEAD，可选值 HEAD 或 GET
certificate_ssl_mode
enum
认证类型
枚举值：
UNIDIRECTIONAL：单向认证
MUTUAL：双向认证
certificate_id
string
服务端证书的 ID
certificate_ca_id
string
客户端证书的 ID，当监听器采用双向认证，即 SSLMode=MUTUAL 时，如果不填写此项则必须上传客户端证书，包括 CertCaContent，CertCaName
session_expire_time
int
会话保持时间。设置为 0 表示关闭会话保持，开启会话保持可取值 30~86400，单位：秒
scheduler
string
规则的请求转发方式，可选值：
WRR：按权重轮询
LEAST_CONN：最小连接数
IP_HASH：IP 哈希
默认为 WRR
http2_switch
boolean
是否开启 Http2，注意，只有 HTTPS 域名才能开启 Http2
target_type
string
后端目标类型
NODE 表示绑定普通节点
TARGETGROUP 表示绑定目标组
forward_type
string
负载均衡与后端服务之间的转发协议，目前支持 HTTP/HTTPS/GRPC，默认 HTTP。
quic
boolean
是否开启 QUIC，注意，只有 HTTPS 域名才能开启 QUIC
生成
id
string
资源实例 ID
create_time
string
资源创建时间
中国站
目录