1 - Overview

Service Overview

GSLB (Global Server Load Balancing) automatically distributes network traffic to available adjacent regions on a DNS basis when traffic increases in a specific global region. In case of failure on a specific server, it load balances network traffic to available new resources, allowing the service to continue stably.

Features

  • Stable Service Provision: Through the function to check whether connected resources are operating normally (Health Check), if a failure occurs on a specific server, it immediately performs a Failover on that resource and removes it from the domain response, thereby bypassing traffic to other resources to provide stable service.
  • Easy Service Port Configuration: You can conveniently create GSLB through a web-based console and set/manage service ports. For L4-level load balancing, multi-port configuration is possible (80, 443, 8080-8090, etc.), and multiple load balancing rules can be applied and managed simultaneously.
  • Efficient Cost Management: Charges are determined by applying a detailed billing method based on the number of configured domains, the number of added Health Check resources, and the number of queries, allowing efficient cost management.

Service Configuration Diagram

Configuration Diagram
Figure. GSLB Configuration Diagram

Provided Functions

The GSLB service provides the following functions.

  • GSLB Creation/Management: You can register multiple resources to a single GSLB.
  • Distribution Algorithm Selection: Provides the Ratio method, which distributes traffic in proportion to the weight (Weight) for each connection target, and the Round Robin method, which distributes traffic evenly while circulating.
  • Health Check Configuration: You can set the check cycle (Interval), service down recognition time (Timeout), response wait time (Probe Timeout), protocol (ICMP, TCP, HTTP, HTTPS), and service port.

Constraints

The constraints of the GSLB service are as follows.

ItemDescription
Maximum number of domains that can be created per Account20
Maximum number of resources that can be connected per domain8
Table. GSLB Constraints
Note
  • For GSLB to monitor connection targets, allow rules must be added to the Firewall and Security Group of the connection target resources.

Regional Availability

The GSLB service can be provided in the following environments.

RegionAvailability
Korea West (kr-west1)Available
Korea East (kr-east1)Available
Korea South1 (kr-south1)Unavailable
Korea South2 (kr-south2)Unavailable
Korea South3 (kr-south3)Unavailable
Table. GSLB Regional Availability

Prerequisite Services

The GSLB service has no prerequisite services.

2 - How-to guides

Users can create a GSLB service by entering required information and selecting detailed options through the Samsung Cloud Platform Console.

Creating a GSLB

You can create and use a GSLB service through the Samsung Cloud Platform Console.

To request the creation of a GSLB service, follow these steps:

  1. Click the All Services > Networking > GSLB menu. You will be redirected to the Service Home page.
  2. On the Service Home page, click the Create GSLB button. You will be redirected to the Create GSLB page.
  3. On the Create GSLB page, enter the information required to create the service and select detailed options.
    • Enter or select the required information in the Service Information section.
      Division
      Required
      Description
      PurposeRequiredPUBLIC automatically entered when creating GSLB
      Domain NameRequiredEnter the GSLB domain name to use
      • Enter within 4-40 characters using lowercase English letters and numbers
      • Cannot be used the same as a name already in use
      Add Connection Target > IPRequiredEnter the connection target IP address
      Add Connection Target > LocationRequiredSelect the location to perform monitoring for the connection target
      • Recommended to specify a location close to the IP server
      Add Connection Target > DescriptionOptionalEnter additional information or description for the connection target
      Add Connection Target > Connection Target ListRequiredDisplay the added connection target IP, location, description items
      • After entering connection target IP, location, description, click the Add button to add the item
      • Up to 8 connection targets can be added to one GSLB service
      • Click x to delete the item from the list, or click the Delete All button to delete all items in the list
      Table. GSLB service information input items
    • Enter or select the required information in the Connection Target Monitoring Settings section.
      Division
      Required
      Description
      Health CheckRequiredSelect the protocol type to perform health check
      • Can select from ICMP, TCP, HTTP, HTTPS (use of HTTPS recommended for security)
      IntervalRequiredEnter the time interval (seconds) to perform health check
      TimeoutRequiredEnter the waiting time (seconds) to determine the server status (UP or DOWN) during health check
      Probe TimeoutRequiredEnter the response waiting time (seconds)
      • Enter domain name (recommended) or directly enter the public IP of the origin server
      Service PortRequiredWhen using TCP/HTTP/HTTPS protocol, enter the port to use for health check
      • Enter domain name (recommended) or directly enter the public IP of the origin server
      User NameOptionalWhen using HTTP/HTTPS protocol, enter the user name to use when authentication is required for health check communication
      PasswordOptionalWhen using HTTP/HTTPS protocol, enter the password to use when authentication is required for health check communication
      • Enter within 8-20 characters including all English letters, numbers, and special characters (@$!%*#?&)
      Send StringOptionalWhen using HTTP/HTTPS protocol, enter the string to send when checking a specific web page
      • Example) GET /www/example/index.html
      • For HTTP 1.0/1.1, enter line break as /r/n, special characters (<, >, #) cannot be used in the string
      Receive StringRequiredWhen using HTTP/HTTPS protocol, enter the string to receive as health check response
      • Enter only English uppercase/lowercase letters and numbers in the string
      Table. GSLB connection target monitoring settings input items
    • Enter or select the required information in the Load Balancing Policy Settings section.
      Division
      Required
      Description
      AlgorithmRequiredSelect the load balancing method
      • Ratio: Distribute traffic proportionally to the weight (Weight) of each connection target
      • Round robin: Distribute traffic equally based on round-robin method
      Connection TargetRequiredWhen selecting Ratio, enter Weight for each connection target
      • Weight is the weight applied to the connection target when distributing service requests, enter within 0 - 100
      • Click the detailed view icon in the description item to check connection target information
      Table. GSLB load balancing policy input items
    • Enter or select the required information in the Additional Information section.
      Division
      Required
      Description
      DescriptionOptionalEnter additional information or description for the GSLB service
      TagsOptionalAdd tags
      • Up to 50 tags can be added per resource
      • Click the Add Tag button and enter or select the Key, Value values
      Table. GSLB additional information input items
  4. Review the creation details and click the Create button.
    • When creation is complete, check the created resource on the GSLB List page.
Note
To monitor connection targets, GSLB must add allow rules to the Firewall and Security Group.

Checking GSLB Detailed Information

For the GSLB service, you can view and modify the entire resource list and detailed information. The GSLB Details page consists of tabs for Detailed Information, Connection Targets, Tags, Operation History.

To check GSLB detailed information, follow these steps:

  1. Click the All Services > Networking > GSLB menu. You will be redirected to the GSLB Service Home page.
  2. On the Service Home page, click the GSLB menu. You will be redirected to the GSLB List page.
  3. On the GSLB List page, click the resource for which you want to check detailed information. You will be redirected to the GSLB Details page.
    • The GSLB Details page displays the status information and detailed information of the GSLB, and consists of tabs for Detailed Information, Connection Targets, Tags, Operation History.
      DivisionDescription
      Service StatusStatus of the GSLB
      • Creating: Creating
      • Active: Operating
      • Editing: Modifying
      • Deleting: Terminating
      • Error: Error occurred
      Terminate ServiceButton to terminate GSLB
      Table. GSLB status information and additional features

Detailed Information

On the GSLB List page, you can check the detailed information of the selected resource and modify the information if necessary.

DivisionDescription
ServiceService name
Resource TypeResource type
SRNUnique resource ID in Samsung Cloud Platform
Resource NameResource name
Resource IDUnique resource ID in the service
CreatorUser who created the service
Creation DateDate and time when the service was created
ModifierUser who modified the service information
Modification DateDate and time when the service information was modified
Domain NameGSLB domain information
PurposeGSLB purpose
AlgorithmSet GSLB algorithm information
  • Click the Edit icon to change settings
Health CheckSet GSLB health check information
  • Click the Edit icon to change settings
DescriptionEntered GSLB description
  • Click the Edit icon to modify description
Table. GSLB detailed information tab items

Connection Targets

On the GSLB List page, you can check the connection target information of the selected resource and modify the information if necessary.

DivisionDescription
IPConnection target IP address
Resource IDGSLB resource ID
LocationLocation to perform monitoring for the connection target
DescriptionEnter additional information or description for the connection target
  • Click the detailed view icon to check information
Use StatusDisplay whether the connection target is in use
WeightDisplay the connection target’s Weight
Connection StatusDisplay connection status
  • Connected: Normal connection status
  • Disconnected: Disconnected status
Modify Connection TargetAdd connection target and modify information
Table. GSLB connection target tab items

Tags

On the GSLB List page, you can check the tag information of the selected resource, and add, change, or delete tags.

DivisionDescription
Tag ListTag list
  • You can check Key, Value information of tags
  • Up to 50 tags can be added per resource
  • When entering tags, search and select from the list of previously created Keys and Values
Table. GSLB tag tab items

Operation History

On the GSLB List page, you can check the operation history of the selected resource.

DivisionDescription
Operation History ListResource change history
  • You can check operation details, operation date and time, resource type, resource name, operation result, operator information
  • Click the corresponding resource in the Operation History List to open the Operation History Details popup window
Table. GSLB operation history tab items

Modifying Connection Target Information

You can add, modify, or delete GSLB connection target information.

To change GSLB connection target information, follow these steps:

  1. Click the All Services > Networking > GSLB menu. You will be redirected to the GSLB Service Home page.
  2. On the Service Home page, click the GSLB menu. You will be redirected to the GSLB List page.
  3. On the GSLB List page, click the resource for which you want to check detailed information. You will be redirected to the GSLB Details page.
  4. On the GSLB Details page, click the Connection Targets tab. You will be redirected to the Connection Targets tab page.
  5. On the Connection Targets tab page, click the Modify Connection Target button. You will be redirected to the Modify Connection Target page.
  6. On the Modify Connection Target page, modify the desired information.
    • Add: Enter connection target IP, select location, enter description, and click the Add button to add the item.
    • Delete: Click the Delete button to delete the connection target item.
    • You can modify Weight for each item in the connection target list.
  7. When modification is complete, click Complete. The modification notification window will open.
  8. Click Confirm in the notification window. The service information modification is complete.
Note
  • You can add up to 8 connection targets to one GSLB service.
  • When adding a connection target, it is recommended to set it to a location close to the connection target server in the location item.

Setting Up Regional Routing Controller

You can check the Regional Routing Controller and change the use status.

To change the use status of Regional Routing Controller, follow these steps:

  1. Click the All Services > Networking > GSLB menu. You will be redirected to the GSLB Service Home page.

  2. On the Service Home page, click the Regional Routing Controller menu. You will be redirected to the Regional Routing Controller List page.

  3. On the Regional Routing Controller List page, search for the resource for which you want to check detailed information.

    • Click the Detailed Search button to search by selecting domain, connection location, and use status.
  4. On the Regional Routing Controller List page, check the resource information and change the use status.

    DivisionDescription
    Domain NameRegistered domain name
    • Click the domain name to move to the GSLB Details > Connection Targets tab page
    PurposeDomain purpose
    Connection LocationLocation to perform monitoring for the connection target
    Connection Targets by LocationNumber of connection targets by location
    Use StatusDisplay connection target use setting status, click the more button to change use status
    • Use: Set connection target to use
    • Stop: Stop connection target use
    • You can also set use by selecting the domain in the list and selecting Use or Stop at the top
    Table. Regional Routing Controller list

  5. Click Confirm in the notification window. The domain use status change is complete.

Terminating GSLB

You can apply for the termination of the GSLB service from the Samsung Cloud Platform Console.

To request the termination of the GSLB service, follow these steps:

  1. Click the All Services > Networking > GSLB menu. You will be redirected to the GSLB Service Home page.
  2. On the Service Home page, click the GSLB menu. You will be redirected to the GSLB List page.
  3. On the GSLB List page, click the resource for which you want to check detailed information. You will be redirected to the GSLB Details page.
  4. On the GSLB Details page, click the Terminate Service button.
  5. When termination is complete, check the service termination status on the GSLB list.

3 - API Reference

API Reference

4 - CLI Reference

CLI Reference

5 - Release Note

GSLB

2025.12.16
FEATURE Regional Routing Controller Service Added
  • You can control whether to use traffic to be connected through GSLB by region.
2025.07.01
NEW GSLB Service Official Version Released
  • We have released the GSLB service that can automatically distribute network traffic to adjacent regions on a DNS basis when traffic increases in a specific global region, providing stable service.