All Products
Search

This Product

    Server Load Balancer:Add and manage IP listeners

    Document Center

    Server Load Balancer:Add and manage IP listeners

    Last Updated:May 12, 2026

    Listeners receive and distribute client requests. GWLB supports IP listeners. You can add an IP listener to a GWLB instance, and then modify or delete it.

    Add an IP listener

    Before you begin, ensure that you have created a GWLB instance and have an available server group.

    1. Log on to the Gateway Load Balancer console.

    2. In the top navigation bar, select the region where you want to create the GWLB instance.

    3. In the Actions column of the target instance, click Create Listener.

    4. On the Create IP Listener page, configure the following parameters and click OK.

      Parameter

      Description

      Listener Name

      Enter a name for the listener.

      Server Group Resource Group

      Select the resource group to which the server group belongs.

      This parameter is for RAM users only. Skip this setting if you are using an Alibaba Cloud account.

      Server Group

      • Server: The server group contains ECS, ENI, or ECI instances as backend servers.

      • IP: The server group contains IP addresses as backend servers.

      Advanced Settings

      Click to expand Advanced Settings.

      Idle TCP Connection Timeout

      The timeout period for an idle TCP connection. If no data is transmitted over a connection during this period, the GWLB instance closes the connection. Subsequent traffic for this flow is dropped until a new connection is established.

      The default value is 350 seconds. You can customize this timeout only if the associated server group uses the 5-tuple hashing scheduling algorithm. The value must be between 60 and 6,000 seconds, inclusive.

      The idle timeout for non-TCP traffic is 120 seconds and cannot be changed.

      Tags

      Assign a Tag Key and a Tag Value to the listener.

      You can add multiple tags to a listener.

    More operations

    Actions

    Procedure

    Modify listener attributes

    1. Click the Listeners tab. In the Basic Information section, click Edit next to the listener name.

    2. In the dialog box, modify the listener name and click OK.

    Modify the idle TCP connection timeout

    You can modify this timeout only if the associated server group uses the 5-tuple hashing scheduling algorithm. The value must be between 60 and 6,000 seconds, inclusive.

    1. Click the Listeners tab. In the Basic Information section, click Edit to the right of Idle TCP Connection Timeout.

    2. In the dialog box, modify the timeout period and click OK.

    Delete a listener

    1. Click the Listeners tab. In the Basic Information section, click Delete Listener.

    2. In the dialog box, click Delete.

    Change the server group

    1. Click the Listeners tab. In the Server Group (Default Forwarding Rule) section, click Change Server Group.

    2. In the dialog box, select a server group or click Create Server Group from the drop-down list to create one. Then, click OK.

    Related topics