Kvindo™ Cloud Docs
An HTTP Listener accepts inbound HTTP connections on one or more ports of a Load Balancer and routes each request to a Target Group according to its HTTP Listener Rules. It is a Layer-7 listener — it can match on host and path and rewrite headers.
• Load balancer — the LB this listener belongs to (spec.loadbalancerId)
• Interface — which side to bind: all (default), public, or private
• Ports / Hosts — the ports to accept on, and an optional host-header filter
• Security rules — optional IP allow/deny list applied before routing
| UI Name | API / kc name | Terraform name | Optional | Format | Default | Is read only | Description |
|---|---|---|---|---|---|---|---|
| Load balancer | spec.loadbalancerId |
spec.loadbalancer_id |
No | ULID — references a Load Balancer | — | No | The load balancer this listener belongs to |
| Interface | spec.interface |
spec.interface |
Yes | string — all / public / private |
all |
No | Which network interface to bind on |
| Order | spec.order |
spec.order |
Yes | integer | 0 |
No | Tie-breaking priority when multiple listeners match |
| Ports | spec.ports |
spec.ports |
No | list of string | — | No | Ports the listener accepts connections on |
| Hosts | spec.hosts |
spec.hosts |
Yes | list of string | [] |
No | Optional host-header filter |
| Security rules | spec.securityRules |
spec.security_rules |
Yes | list of rule objects | [] |
No | IP allow/deny list applied before routing |
| Order | spec.securityRules[].order |
order |
Yes | integer | — | No | Evaluation order of the security rule |
| Description | spec.securityRules[].description |
description |
Yes | string (nullable) | — | No | Free-form note on what the rule is for |
| Action | spec.securityRules[].action |
action |
No | string — allow / deny |
— | No | Whether to allow or deny the matched IPs |
| IPv4 blocks | spec.securityRules[].ipV4Blocks |
ipv4_blocks |
Yes | list of string — CIDR | [] |
No | IPv4 ranges the rule matches |
| IPv6 blocks | spec.securityRules[].ipV6Blocks |
ipv6_blocks |
Yes | list of string — CIDR | [] |
No | IPv6 ranges the rule matches. IPv6 is not yet implemented — this field is reserved for future use |
An HTTP listener on port 80 of an existing load balancer.
Terraform
Python SDK
kc CLI
Resource docs
Examples
More in this section