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:Jun 02, 2026

    A GWLB instance receives and distributes client traffic to backend servers. Create, configure, and release GWLB instances in the console.

    Prerequisites

    Create a GWLB instance

    1. Log on to the Gateway Load Balancer (GWLB) console.

    2. In the top navigation bar, select the region for the GWLB instance.

    3. On the Instances page, click Create GWLB.

    4. On the Gateway Load Balancer - International purchase page, set the following parameters.

      Parameter

      Description

      Region and zone

      Select the region for the instance.

      VPC

      Select the VPC for the instance.

      Zone

      Select at least one zone and a corresponding vSwitch. GWLB supports multi-zone deployment. After creation, zones and vSwitches cannot be removed.

      IP Version

      Select the IP version for the instance.

      IPv4: GWLB supports IPv4 traffic.

      Instance Name

      Enter a name for the instance.

      Resource group

      Select a resource group for the GWLB instance.

      Tag

      Set a Tag Key and a Tag Value for the instance.

      You can add multiple tags to an instance.

      Service-linked role

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

      Note

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

    5. Click Buy Now and follow the on-screen instructions to activate the instance.

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

    Release a GWLB instance

    Release unused instances to stop billing.

    Warning

    • Releasing a GWLB instance permanently deletes its configurations and data.

    • You cannot release a GWLB instance in use by other services. For example, if a GWLB instance is associated with an endpoint service, disassociate the GWLB instance first.

    1. Log on to the Gateway Load Balancer (GWLB) console.

    2. In the top navigation bar, select the region for the GWLB instance.

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

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

    3. In the dialog box, modify the instance name and click OK.

    Add zones to a GWLB instance

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

      • Find the target instance. In the Actions column, click the More actions icon and select Modify Zone/Subnet.

      • Click the ID of the target instance. On the Instance Details tab, in the Zone section, click Modify Zone/Subnet.

    2. In the Modify Zone/Subnet dialog box, select the zones to add and their corresponding vSwitches. Then, click OK.

    Note

    You can only add zones. Existing zones cannot be modified or removed.

    Manage tags

    Each tag is a key-value pair.

    • Up to 20 tags per instance.

    • Tag keys must be unique per instance.

    Add tags

    Tags categorize instances by purpose, owner, or other criteria.

    1. On the Instances page, find the target instance and move the pointer over the Tags icon in the Tags column.

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

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

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

      You can also click the Delete icon next to a tag to unbind it.

    Filter by tag

    Filter instances by tag.

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

    • In the drop-down list that appears, select a Tag Key and a Tag Value.

      Above the instance list, click Clear Filter Condition to clear the tag filter.

    Release multiple GWLB instances

    1. On the Instances page, select the check boxes of the target instances, and then click Release.

    2. In the Confirm dialog box, click Release.

    Next steps

    • You must configure a listener to forward traffic from all ports to the backend server group over the Geneve protocol. Add and manage IP listeners.

    • A GWLB instance must be paired with a PrivateLink endpoint to deliver services.

    Related documentation

    Overview:

    API reference: