Vultr DocsLatest Content

How to Manage Vultr Global Load Balancer Regions

Updated on 16 July, 2025

Global Load Balancer Regions enable the distribution of traffic depending on your user locations by creating child Load Balancer instances linked to a parent Load Balancer. You can create one child Load Balancer in each Vultr region and link multiple instances to distribute traffic. User requests to the parent Load Balancer are routed to the nearest child Load Balancer in a region depending on the user's location.

Follow this guide to manage Vultr Global Load Balancer regions using the Vultr Customer Portal, API or CLI.

  • Vultr Customer Portal
  • Vultr API
  • Vultr CLI
  1. Navigate to Products and click Load Balancers.
  2. Select your target Load Balancer to open its management page.
  3. Click Global Regions.
  4. Click Add next to your target Vultr Region ID to create a child Load Balancer in the region.
  5. Click Remove/Close to delete a child Load Balancer and unlink it from the parent Load Balancer.
  6. Click the active child Load Balancer's name to open its management page.
  7. Click Add Instance within the Linked Instances section to attach instances to distribute traffic in the region.

  1. Send a GET request to the List Regions endpoint and note your target region ID.

    console 
    $ curl "https://api.vultr.com/v2/regions" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

  2. Send a GET request to the List Load Balancers endpoint and note your target Load Balancer's ID.

    console 
    $ curl "https://api.vultr.com/v2/load-balancers" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

  3. Send a PATCH request to the Update Load Balancer endpoint to create a child Load Balancer in the target region.

    console 
    $ curl "https://api.vultr.com/v2/load-balancers/{load-balancer-id}" \
    -X PATCH \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    --data '{      
        "global_regions": [
            "{region_1_id}",
            "{region_2_id}"
        ]
    }'

  1. List all the region IDs, note down the required region IDs.

    console 
    $ vultr-cli regions list

  2. List all available instances and note the target Load Balancer's ID.

    console 
    $ vultr-cli load-balancer list

  3. Update the instance by adding a region ID to provision a child Load Balancer in the target regions.

    console 
    $ vultr-cli load-balancer update <load_balancer_id>  --global-regions <region_1_id> <region_2_id>

Comments

No comments yet.