All Products
Search

This Product

    Server Load Balancer:Create and manage GWLB instances

    Document Center

    Server Load Balancer:Create and manage GWLB instances

    Last Updated:Mar 30, 2026

    You can create a GWLB instance to receive traffic requests from clients and distribute the requests to backend servers. This topic describes how to create and manage GWLB instances.

    Prerequisites

    • You have created a Virtual Private Cloud (VPC). For more information, see Create an IPv4 VPC.

    • The AliyunServiceRoleForGwlb service-linked role exists in your account. When you create a Gateway Load Balancer instance for the first time, you are prompted to create this service-linked role. This role allows Gateway Load Balancer to access other Alibaba Cloud services and resources on your behalf. For more information, see System permission policies for Gateway Load Balancer.

    Create a GWLB instance

    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. On the Instances page, click Create GWLB.

    4. On the Gateway Load Balancer buy page, configure the following parameters.

      Parameter

      Description

      Region and zone

      Select the region for the instance.

      VPC

      Select the VPC for the instance.

      Zone

      Select the zone for the instance. Gateway Load Balancer supports multi-zone deployment. You must specify at least one zone and a corresponding vSwitch. After you create the GWLB instance, you cannot remove the selected zones and vSwitches.

      IP Version

      Select the IP version for the instance.

      IPv4: The GWLB instance accepts IPv4 traffic.

      Instance Name

      Enter a name for the instance.

      Resource group

      Select a resource group for the GWLB instance.

      Tags

      Set the Tag Key and Tag Value for the instance.

      You can add multiple tags to an instance.

      Service-linked role

      The first time you create a Gateway Load Balancer instance, you must click Create Service-linked Role to create a service-linked role named AliyunServiceRoleForGwlb.

      Note

      This parameter appears only when you create a GWLB instance for the first time.

    5. Click Buy Now and follow the on-screen instructions to complete the process.

    6. Return to the Instances page and select the region to view the new instance.

    Release a GWLB instance

    You can release instances that you no longer need to avoid unnecessary charges. After you release an instance, you are no longer billed for it.

    Warning

    • Releasing a GWLB instance deletes its configurations and data, which cannot be recovered.

    • You cannot release a GWLB instance that is in use. For example, if an endpoint service is associated with the GWLB instance, you must first disassociate them before you can release the GWLB instance.

    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. On the GWLB Instances page, find the target instance, click More actions in the Actions column, and select Release.

    4. In the Confirm dialog box, click Release.

    More operations

    Actions

    Procedure

    Rename a GWLB instance

    1. On the Instances page, find the target instance and click the instance ID.

    2. On the Instance Details tab, click Modify next to the instance name.

    3. In the dialog box that appears, enter a new name and click OK.

    Manage the zones of a GWLB instance

    1. On the Instances page, use one of the following methods to modify the zones and vSwitches:

      • Find the target instance. In the Actions column, click the 更多操作 icon and select Modify Zone/Subnet.

      • Click the target instance ID. On the Instance Details tab, go to the Zone section and click Modify Zone/Subnet.

    2. In the Modify Zone/Subnet dialog box, select the checkbox for a new zone and select a vSwitch. Then, click OK.

    Note

    You can only add zones to a GWLB instance. You cannot edit or delete existing zones.

    Manage tags

    Each tag consists of a key-value pair.

    • You can assign a maximum of 20 tags to an instance.

    • The tag keys of an instance must be unique.

    Add tags

    You can use tags to classify instances, for example, by purpose or owner.

    1. On the Instances page, find the target instance and hover over the 标签 icon in the Tags column.

      • If the instance has no tags, click Edit in the bubble that appears.

      • If the instance already has tags, click Modify in the bubble that appears.

    2. In the Modify Tag dialog box, select or enter a tag key and a tag value, and then click OK.

      You can also click the 删除 icon next to a tag to remove it.

    Filter by tag

    You can filter instances by tag to view their information.

    • On the Instances page, click Filter Tags above the instance list.

    • From the drop-down lists that appear, select a Tag Key and a Tag Value.

      To remove the filter, click Clear Filter Criteria above the instance list.

    Release GWLB instances in bulk

    1. On the Instances page, select the checkboxes of the target instances and click Release.

    2. In the Confirm dialog box, click Release.

    Next steps

    • After you create a GWLB instance, you must configure a listener to forward traffic from all ports to a backend server group over the Geneve protocol. For more information, see Add and manage IP listeners.

    • You must use a GWLB instance with an endpoint service created using PrivateLink.

    Related documents

    Overview:

    API reference: