Kvindo™ Cloud Docs


Language

HTTP Rule

An HTTP Listener Rule matches inbound requests on an HTTP Listener and applies an action. Rules are evaluated by order (lowest first) and the first match wins. A rule sets its match plus one response action (a static response, or a forward to a target group — static wins if both are set), optionally combined with header set/delete and path-rewrite actions.

Key concepts

Listener — the HTTP listener this rule belongs to (spec.httpListenerId)

Match — the request path and how it is compared (spec.match)

Action — forward to a Target Group, return a static response, rewrite the path, or add/remove headers

Parameters
UI Name API / kc name Terraform name Optional Format Default Is read only Description
Listener spec.httpListenerId spec.http_listener_id No ULID — references an HTTP Listener No The listener this rule belongs to
Order spec.order spec.order Yes integer 0 No Evaluation order; lower is checked first
Match spec.match spec.match No object No Request match criteria
Path spec.match.path path No string No Path to compare against
Path match type spec.match.pathMatchType path_match_type No string — prefix / exact / regex No How the path is compared
Forward to HTTP spec.forwardToHttpResponseAction spec.forward_to_http_response_action Yes object — {targetGroupId, toPorts, portMappingType} No Forward the request to a Target Group over plain HTTP
Forward to HTTPS spec.forwardToHttpsResponseAction spec.forward_to_https_response_action Yes object — adds tls (backend re-encryption) No Forward the request to a Target Group, re-encrypting to the backends; the tls object supports mTlsCertificateId, caCertificateId, verify, and sniServerName
Static response spec.staticResponseAction spec.static_response_action Yes object — {statusCode, bodyString, contentType, headers} No Return a fixed response without touching a backend
Path rewrite spec.pathRewriteAction spec.path_rewrite_action Yes object — {sourcePath, destinationPath, pathType} No Rewrite the request path before forwarding
Header actions spec.setRequestHeadersAction / setResponseHeadersAction / deleteRequestHeadersAction / deleteResponseHeadersAction spec.set_request_headers_action / set_response_headers_action / delete_request_headers_action / delete_response_headers_action Yes objects No Add or remove request/response headers
Examples

A rule that forwards all paths to a Target Group's backends on port 8080.

Terraform

Python SDK

kc CLI


Related pages

Resource docs

Examples

More in this section

An unhandled error has occurred. Reload 🗙