Create, update, and delete a Listener
A Listener is the component that listens for incoming client requests and routes them to the appropriate backend servers. It defines the protocol, port, and other parameters for how the Load Balancer receives and distributes traffic.
A default Listener is created automatically when you create a Load Balancer.
Create a Listener
Step 1: Open the Load Balancer detail page by clicking the Load Balancer name.
Step 2: Select the Listener tab, then click Create Listener.
Step 3: Enter the Listener configuration. The form is split into General Information and Advanced Settings.
General Information
| Field | Description |
|---|---|
| Listener name | Name of the Listener. Only letters, numbers, underscore, hyphens, spaces, and dot are allowed. |
| Description | Optional description. |
| Protocol | Protocol the Listener uses to receive requests: HTTP, HTTPS, TERMINATED_HTTPS, TCP, or UDP. Default: HTTP. |
| Port | Port the Listener listens on (for example, 80). |
| Server pool | The default pool that requests are routed to (for requests not matched by any L7 policy). |
| Allow CIDRs | CIDRs allowed to access this Listener. All other traffic is denied. One CIDR per line. Default: 0.0.0.0/0. |
| Deny CIDRs | CIDRs denied access to this Listener, even if included in the allow list. One CIDR per line. |
| HTTP Headers insertions | Headers inserted into requests to members (pre-selected — deselect any you don't need): X-Forwarded-For (client IP address), X-Forwarded-Port (Listener port), X-Forwarded-Proto (Listener protocol). |
Advanced Settings
| Field | Default | Description |
|---|---|---|
| Member connect timeout (s) | 5 | Backend member connection timeout. |
| Client data timeout (s) | 50 | Frontend client inactivity timeout. |
| Member data timeout (s) | 50 | Backend member inactivity timeout. |
| TCP inspect timeout (s) | 0 | Time to wait for additional TCP packets for content inspection. |
| Connection limit | -1 | Maximum number of simultaneous connections for this Listener. -1 means unlimited. |
Click Create Listener to create, or Cancel to discard.
Update a Listener
Step 1: In the Listener list, click the Listener you want to update.
Step 2: Update any of the following fields:
- Listener name, Description, Server pool
- Client data timeout (s), Member connect timeout (s), Member data timeout (s)
- TCP inspect timeout (s), Connection limit
Click Update Listener to apply, or Cancel to discard.
Delete a Listener
Step 1: In the Listener list, click Delete in the Listener's Action menu.
Step 2: A confirmation dialog appears showing the Listener name. Type delete and click Delete Listener to confirm.