How to Manage Global Regions on a Vultr Load Balancer

Updated on April 7, 2025

Global 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 global regions on a Vultr Load Balancer using the Vultr Customer Portal or API.

  • Vultr Customer Portal
  • Vultr API
  1. Navigate to Products and click Load Balancers.
  2. Click your target Load Balancer to open its management page and use it as the parent.
  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 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}"
            ]
        }'
    

Comments

No comments yet.