Oracle Cloud Infrastructure Documentation

Creating a Network Load Balancer Listener

Create a listener that checks for incoming traffic on the IP address of a network load balancer.

For prerequisite information, see Listeners for Network Load Balancers.

    1. Open the navigation menu, click Networking, and then click Load balancers. Click Network load balancer. The Network load balancers page appears.
    2. Select the Compartment from the list. All network load balancers in that compartment are listed in tabular form.
    3. Select a State from the list to limit the network load balancers displayed to that state.
    4. Select the network load balancer for which you want to create a listener. The network load balancer's Details page appears.
    5. Click Listeners under Resources. The Listeners list appears. All listeners are listed in tabular form.
    6. Click Create listener. The Create listener dialog box appears.
    7. Complete the following:

      • Name: Specify a friendly name for the listener. The name must be unique, and cannot be changed. Avoid entering confidential information.

      • Protocol: Select one of the following options:

        • Public network load balancers:

          • UDP

          • TCP

          • UDP/TCP

        • Private network load balancers:

          • UDP

          • TCP

          • TCP/UDP/ICMP

          • UDP/TCP

        Note

        You can't select or configure the L3IP protocol for a listener using the Console. You must use the CLI or API instead.

      • IP protocol version: Required if you previously enabled IPv6 Address Assignment. The load balancer listener and backend set must use the same IP protocol version.

      • Ingress traffic port: Select one of the following options to specify the port your listener monitors for ingress traffic depending on the traffic type:

        • Public network load balancers:

          • Use any port: This option uses a 0 or wildcard as the port.

          • Select the port: Enter the port you want to use.

        • Private network load balancers:

          • Use any port: This option uses a 0 or wildcard as the port.

          • Select the port: (UDP, TCP, and UDP/TCP only) Enter the port you want to use.

        • UDP and TCP: Select one of the following options:

          • Use any port: This option uses a 0 or wildcard as the port.

          • Select the Port: Enter the port you want to use.

        • UDP/TCP: Uses any port.

      • Backend set: Specify the default backend set to which the listener routes traffic from the list.

    8. Click Create listener.

    The listener you create appears in the Listener list of the network load balancer.

  • Use the oci nlb listener create command to create a listener for a network load balancer:

    oci nlb listener create --name name --default-backend-set-name --protocol protocol --port port default_backend_set_name --network-load-balancer-id network_load_balancer_ocid [OPTIONS]

    For the protocol on which the listener accepts connection requests, use one of the following values:

    • TCP: Allows only TCP traffic on a specific or all ports.

    • UDP: Allows only UDP traffic on a specific or all ports.

    • TCP_AND_UDP: Allows both TCP and UDP traffic on a specific or all ports.

    • ANY: Allows both TCP and UDP traffic on any port and also allows ICMP traffic. This option is only for SRC/DST header preserved mode (transparent mode).

    • L3IP: Allows Layer 3 IP traffic.

    See Changing a Listener's Idle Timeout to change the default idle timeout settings for listeners.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the CreateListener operation to create a listener for a network load balancer.