This is the multi-page printable view of this section. Click here to print.
Load Balancer
- 1: Overview
- 2: How-to guides
- 2.1: LB Server Group
- 2.2: LB Health Check
- 3: API Reference
- 4: CLI Reference
- 5: Release Note
1 - Overview
Service Overview
The Load Balancer (LB) service of Samsung Cloud Platform automatically distributes traffic to available servers when traffic increases unpredictably or server failures occur, ensuring the stability and continuity of customer services.
The Load Balancer is deployed in the VPC Subnet according to the service type (L4 / L7) as a service access point provided to clients, and multiple services can be configured by adding Listeners to the created Load Balancer.
The Listener receives client requests through the service port and processes traffic according to routing rules. L4 supports TCP / UDP / TLS protocols, and L7 supports HTTP / HTTPS protocols. In L7, you can specify LB server groups according to routing conditions or set redirect responses for request URLs.
The LB server group delivers requests received by the Listener to specific servers according to load balancing and health checks. Servers receive client requests from the Load Balancer’s Source NAT IP through the port set on the member, and the server status is periodically monitored by the Load Balancer’s health check IP.
The LB health check defines the member health check method registered in the LB server group. You can select the LB health check resource provided by default in the LB server group, or create a new one to configure monitoring suitable for your application.
Features
- Various Load Balancing Methods: Provides various load balancing methods such as Round Robin, Least Connection, and IP Hash.
- SSL Certificate Encryption and Offloading: Supports SSL offloading and allows selection of encryption levels.
- Enhanced Security: Manage Load Balancer communication using Firewall and view access logs through log storage.
Service Configuration Diagram
Provided Functions
- Load Balancer: Select the service type and set the IP to use in the Load Balancer.
- Listener: Set the protocol, port, and routing rules. You can add multiple Listeners to a single Load Balancer.
- LB Server Group: Set the load balancing method. The LB server group can be connected to a single Load Balancer.
- Member: Select the server to add to the LB server group. You can select Virtual Server and Bare Metal Server resources created in the same VPC as the Load Balancer, or directly enter an IP.
- LB Health Check: Set the member health check method. The LB health check can be registered and used in multiple LB server groups.
Components
The Load Balancer consists of Load Balancer (Listener), LB server group (member), and LB health check.
Load Balancer
The components that make up the Load Balancer are as follows. According to the settings for each component, you can configure load balancing suitable for customer workloads.
| Component | Description |
|---|---|
| Service Type | Load Balancer service type
|
| Service Subnet | VPC Subnet where the Load Balancer will be deployed
|
| Service IP | Service IP that clients access |
| Source NAT IP | IP used by Load Balancer to deliver server traffic |
| Health Check IP | IP used by Load Balancer for health checks |
| Listener | Resources connected to Load Balancer
|
LB Server Group
The components that make up the LB server group are as follows. According to the settings for each component, traffic is delivered to members of the LB server group.
| Component | Description |
|---|---|
| Protocol | LB server group delivery protocol |
| Load Balancing | Traffic distribution method
|
| LB Health Check | Member health check method
|
| Member | Server that processes client requests
|
LB Health Check
The components that make up the LB health check are as follows. According to the settings for each component, member health checks are performed.
| Component | Description |
|---|---|
| Protocol | Health check protocol |
| Health Check Port | Port used for health check |
| Interval | Health check execution interval |
| Timeout | Server response wait time for health check |
| Detection Count | Criteria for determining member health check status (Healthy / Unhealthy) |
Constraints
Samsung Cloud Platform’s Load Balancer applies basic quotas, so there are constraints on the number of Load Balancers, Listeners, LB server groups, and members that can be created. You can manage current usage through the Console and request additional quotas for items that can be expanded.
| Item | Basic Quota | Description |
|---|---|---|
| LOAD_BALANCER.SERVICE_SUBNET.DEFAULT.COUNT | 3 | Number of Service Subnets where Load Balancers can be created per VPC |
| LOAD_BALANCER.DEFAULT.COUNT | 50 | Number of Load Balancers created per Region |
| LOAD_BALANCER.LISTENER.DEFAULT.COUNT | 1000 | Number of Listeners created per Region |
| LOAD_BALANCER.SERVER_GROUP.DEFAULT.COUNT | 1000 | Number of LB server groups created per Region |
| LOAD_BALANCER.MEMBER.DEFAULT.COUNT | 1000 | Number of members that can be registered in all LB server groups per Region |
| LOAD_BALANCER.HEALTH_CHECK.DEFAULT.COUNT | 500 | Number of LB health checks created per Region |
Prerequisite Services
This is a list of services that must be pre-configured before creating the Load Balancer service. Please prepare in advance by referring to the guides provided for each service.
| Service Category | Service | Description |
|---|---|---|
| Networking | VPC | Service that provides independent virtual networks in the cloud environment |
2 - How-to guides
You can create a Load Balancer service by entering essential information and selecting detailed options through the Samsung Cloud Platform Console.
Creating a Load Balancer
You can create and use a Load Balancer service through the Samsung Cloud Platform Console.
Follow these steps to create a Load Balancer:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Create Load Balancer button. You will be navigated to the Create Load Balancer page.
- On the Create Load Balancer page, enter the information required for service creation and select detailed options.
- In the Service Information area, enter or select the required information.
| Item | Required | Detailed Description |
|---|---|---|
| Load Balancer Name | Required | Load Balancer resource name
|
| Service Type | Required | Load Balancer service type
|
| VPC Name | Required | VPC where the Load Balancer will be created
|
| Service Subnet Name | Required | VPC Subnet where the Load Balancer will be created
|
| Service IP | Optional | Service IP of the Load Balancer
|
| Public NAT IP | Optional | Public NAT IP to use in the Load Balancer when allowing service access from external (internet)
|
| Source NAT IP | Optional | IP to use for member communication in the Load Balancer
|
| Health Check IP | Optional | IP to use for health check in the Load Balancer
|
| Use Firewall | Optional | Set whether to use Firewall
|
| Save Firewall Log | Optional | Select whether to save Firewall log
|
| Item | Required | Detailed Description |
|---|---|---|
| Description | Optional | Enter resource description |
| Tag | Optional | Add tag
|
- Review the created service information and estimated charges, then click the Create button.
- When creation is complete, verify the created resource on the Load Balancer List page.Notice
- The Load Balancer service does not provide access control functionality for Service IP and service ports.
- When creating a Load Balancer, we recommend selecting Use Firewall to manage communication between client and Load Balancer, and between Load Balancer and members using Firewall rules, and using Save Firewall Log to store access logs.
- If you set the Firewall log storage feature when creating a service, you must set up the log storage first. If the log storage setup is not complete, you cannot create the Load Balancer service.
CautionIf using Firewall, you must add rules required for Load Balancer communication. Pay attention to the direction for each purpose when registering rules.
- If you do not add rules, the Load Balancer service will not function properly.
Purpose Source IP Destination IP Protocol Destination Port/Type Direction Client → LB Connection Client IP LB Service IP Listener Protocol Listener Service Port Outbound LB → Member Connection LB Source NAT IP LB Server Group Member IP LB Server Group Protocol Member Port Inbound LB → Member Health Check LB Health Check IP LB Server Group Member IP Health Check Protocol Health Check Port - If health check port and member port are different, register member port
Inbound Figure and Table. Adding Load Balancer Firewall Rules - The Load Balancer service does not provide access control functionality for Service IP and service ports.
- When creation is complete, verify the created resource on the Load Balancer List page.
Viewing Load Balancer Detailed Information
For Load Balancer services, you can view and modify resource lists and detailed information from the Load Balancer menu. The Load Balancer Detail page consists of Detailed Information, Connected Resources, Tags, and Task History tabs.
Follow these steps to view detailed information about the Load Balancer service:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the resource for which you want to view detailed information. You will be navigated to the Load Balancer Detail page.
- The Load Balancer Detail page displays status information and additional feature information, and consists of Detailed Information, Connected Resources, Tags, Task History tabs.
Item Detailed Description Status Load Balancer resource status - Active: Service is normally activated
- Deleting: Processing service termination request
- Creating: Processing service creation request
- Error: Cannot check current status due to internal error
- Editing: Processing service modification request
Service Termination Delete Load Balancer resource Table. Load Balancer status information and additional feature items
- The Load Balancer Detail page displays status information and additional feature information, and consists of Detailed Information, Connected Resources, Tags, Task History tabs.
Detailed Information
On the Detailed Information tab, you can view and modify the detailed information of the resource selected from the Load Balancer List, and modify necessary information.
| Item | Detailed Description |
|---|---|
| Service | Service name |
| Resource Type | Resource type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource Name | Resource name |
| Resource ID | Unique resource ID in the service |
| Creation Date | Service creation date |
| Modification Date | Service modification date |
| Creator | User who requested service creation |
| Modifier | User who requested service modification |
| Load Balancer Name | Load Balancer name |
| Service IP | Load Balancer’s Service IP (used during communication between client and Load Balancer)
|
| Service Type | Load Balancer service type |
| Source NAT IP | Load Balancer’s Source NAT IP (used during communication between Load Balancer and server)
|
| VPC Name | VPC resource name where the Load Balancer is created
|
| Service Subnet Name | Subnet resource name where the Load Balancer is created
|
| Public NAT IP | Load Balancer’s Public NAT IP (used when configuring internet service)
|
| Private NAT IP | Load Balancer’s Private NAT IP
|
| Health Check IP | Load Balancer Health Check IP (used when checking health of LB server group members)
|
| Description | Additional information or description about the Load Balancer
|
| Firewall Name | Firewall resource name connected to the Load Balancer
|
Connected Resources
On the Connected Resources tab, you can view the list of Listeners connected to the Load Balancer, and create or terminate Listeners.
- By selecting a Listener item on the Connected Resources tab, you can navigate to the Listener Detail page to view detailed information and modify or delete it.
- By clicking the Edit icon on the Listener Detail page items, you can modify the information.
| Item | Detailed Description | |
|---|---|---|
| Create Listener | Create Listener button | |
| Listener Name | Listener resource name | |
| Routing Rules | Routing rules connected to the Listener
| |
| Protocol | Protocol to which the Listener will listen | |
| Port | Port to which the Listener will listen | |
| Creation Date | Listener creation date | |
| Delete | Delete Listener button |
Tags
You can view, add, modify, or delete tag information for the resource selected from the Load Balancer List page.
| Item | Detailed Description |
|---|---|
| Tag List | Tag list
|
Task History
On the Task History tab, you can view the task history of the selected resource.
| Item | Detailed Description |
|---|---|
| Task Details | Task execution content |
| Task Date | Task execution date |
| Resource Type | Resource type |
| Resource Name | Load Balancer name |
| Task Result | Task execution result (Success/Failure) |
| Task User Information | User information who performed the task |
Managing Load Balancer Resources
You can manage Load Balancer resources such as creating and deleting Listeners.
Creating a Listener
Create a Listener on the Load Balancer to receive client requests and process traffic according to Listener settings.
The protocol for receiving client requests varies depending on the Load Balancer service type.
- For L4 Load Balancer: TLS, TCP, UDP protocols
- For L7 Load Balancer: HTTP, HTTPS protocols
Creating a Listener in L4 Load Balancer
Follow these steps to create a Listener in an L4 Load Balancer:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the Load Balancer resource where you want to create a Listener. You will be navigated to the Load Balancer Detail page.
- On the Load Balancer Detail page, click the Connected Resources tab. You will be navigated to the Connected Resources tab page.
- On the Connected Resources tab page, click the Create Listener button in the upper right corner.
- In the Service Information area, enter or select the required information.
- The information you can enter varies depending on the Protocol.
| Item | Required | Detailed Description |
|---|---|---|
| Load Balancer | Required | Load Balancer resource name where the Listener will be created |
| Listener Name | Required | Listener resource name |
| Protocol | Required | Select Listener listening protocol
|
| Service Port | Required | Enter Listener listening port
|
| Routing Rules | Required | Set routing rules
|
| Session Persistence Time | Required | Set client session persistence time
|
| Proxy Protocol | Optional | Set whether to add client IP information to proxy protocol header (when using TCP protocol)
|
| Persistence | Required | Select session persistence (Sticky Session) method (when using TCP, TLS protocol)
|
| SSL Certificate | Optional | Select default encryption certificate and security level (when using TLS protocol)
|
| Server SSL Security Level | Required | Select security level when configuring End-to-End SSL (when using TLS protocol)
|
- In the Additional Information area, enter or select the required information.
| Item | Required | Detailed Description |
|---|---|---|
| Description | Optional | Enter resource description |
| Tag | Optional | Add tag
|
- Review the created service information and click the Create button.
- When creation is complete, verify the created resource on the Connected Resources tab of the Load Balancer Detail page.
Creating a Listener in L7 Load Balancer
Follow these steps to create a Listener in an L7 Load Balancer:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the Load Balancer resource where you want to create a Listener. You will be navigated to the Load Balancer Detail page.
- On the Load Balancer Detail page, click the Connected Resources tab. You will be navigated to the Connected Resources tab page.
- On the Connected Resources tab page, click the Create Listener button in the upper right corner.
- In the Service Information area, enter or select the required information.
- The information you can enter varies depending on the Protocol.
| Item | Required | Detailed Description |
|---|---|---|
| Load Balancer | Required | Load Balancer resource name where the Listener is created |
| Listener Name | Required | Listener resource name |
| Protocol | Required | Select Listener listening protocol
|
| Service Port | Required | Enter Listener listening port
|
| Routing Rules > Routing Action | Required | Select routing processing method
|
| Routing Rules > Routing Condition | Required | When routing action is LB Server Group Forward, set LB Server Group by routing condition
|
| Persistence | Optional | Select session persistence (Sticky Session) method (when routing action is LB Server Group Forward)
|
| Listener timeout settings > Session Persistence Time | Optional | Set HTTP connection persistence time
|
| Listener timeout settings > HTTP Connection Timeout | Optional | Set HTTP response timeout time
|
| X-Forwarded-For | Optional | Set whether to insert client IP information
|
| X-Forwarded-Proto | Optional | Set whether to insert client request protocol information
|
| X-Forwarded-Port | Optional | Set whether to insert client request port information
|
| HTTP 2.0 | Optional | Set whether to use HTTP/2 when connecting client and server |
| SSL Certificate | Optional | Select encryption certificate and security level (when using HTTPS protocol)
|
| Server SSL Security Level | Required | Select security level when configuring End-to-End SSL (when using HTTPS protocol)
|
The URL path matching method for routing rules is Starts with (prefix match).
- Checks whether the entered URL path starts with a specific string, and if the beginning matches, the routing rule is applied.
- Example: If the entered URL is
/api/- Matching URLs:
/api/users, /api/v1/login, /api/images/logo.png - Non-matching URLs:
/auth/api/, /API/users
- Matching URLs:
- In the Additional Information area, enter or select the required information.
| Item | Required | Detailed Description |
|---|---|---|
| Description | Optional | Enter resource description |
| Tag | Optional | Add tag
|
- Review the created service information and click the Create button.
- When creation is complete, verify the created resource on the Connected Resources tab of the Load Balancer Detail page.
Supported Items by SSL Security Level
The list of TLS versions and Cipher Suites supported by SSL security level in the Listener is as follows.
| Security Level | TLS Version | Cipher Suite (Encryption Algorithm) |
|---|---|---|
| High | TLS 1.3 | TLS13_AES_128_GCM_SHA256 TLS13_AES_256_GCM_SHA384 TLS13_CHACHA20_POLY1305_SHA256 |
| Normal/Low | Normal: TLS 1.3, 1.2 Low: TLS 1.3, 1.2, 1.1 | TLS13_AES_128_GCM_SHA256 TLS13_AES_256_GCM_SHA384 TLS13_CHACHA20_POLY1305_SHA256 RC4-MD5 RC4-SHA DES-CBC3-SHA DHE-RSA-AES128-GCM-SHA256 DHE-RSA-AES256-GCM-SHA384 DHE-RSA-CHACHA20-PLY1305 ECDHE-RSA-AES128-SHA ECDHE-RSA-AES256-SHA ECDHE-RSA-AES128-SHA256 ECDHE-RSA-AES256-SHA384 ECDHE-RSA-CHACHA20-POLY135 ECDHE-ECDSA-AES128-SHA ECDHE-ECDSA-AES256-SHA ECDHE-ECDSA-AES128-SHA256 ECDHE-ECDSA-AES256-SHA384 ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-ECDSA-CHACHA20-POLY1305 |
Viewing Listener Detailed Information
You can view and modify detailed information of a Listener by selecting it from the Connected Resources tab on the Load Balancer Detail page.
Follow these steps to view detailed information of the Listener:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the resource for which you want to view detailed information. You will be navigated to the Load Balancer Detail page.
- On the Load Balancer Detail page, click the Connected Resources tab.
- From the connected resources list, click the Listener for which you want to view detailed information. You will be navigated to the Listener Detail page.
- The Listener Detail page displays status information and additional feature information, and consists of Detailed Information, Tags, Task History tabs.
| Item | Detailed Description |
|---|---|
| Status | Listener status
|
| Delete Listener | Delete Listener |
Detailed Information
On the Detailed Information tab, you can view the detailed information of the Listener and modify necessary information. The detailed information varies depending on the Load Balancer in use.
L4 Load Balancer Detailed Information
| Item | Detailed Description |
|---|---|
| Service | Service name |
| Resource Type | Resource type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource Name | Resource name |
| Resource ID | Unique resource ID in the service |
| Creator | User who requested Listener creation |
| Creation Date | Listener creation date |
| Modifier | User who requested Listener modification |
| Modification Date | Listener modification date |
| Listener Name | Listener name |
| Protocol | Protocol used by Listener |
| Port | Port used by Listener |
| Session Persistence Time | Client session persistence time
|
| Proxy Protocol | Whether to insert client IP information
|
| Persistence | Whether to use session persistence (Sticky Session)
|
| Routing Rules | Routing action and LB Server Group information
|
| SSL Certificate | Default certificate, SSL security level, and expiration date information
|
| SNI Certificate | SNI certificate detailed information
|
| Server SSL Security Level | Whether to encrypt server connection
|
| Description | Additional information about the Listener
|
L7 Load Balancer Detailed Information
| Item | Detailed Description |
|---|---|
| Service | Service name |
| Resource Type | Resource type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource Name | Resource name |
| Resource ID | Unique resource ID in the service |
| Creator | User who requested Listener creation |
| Creation Date | Listener creation date |
| Modifier | User who requested Listener modification |
| Modification Date | Listener modification date |
| Listener Name | Listener name |
| Protocol | Protocol used by Listener |
| Port | Port used by Listener |
| Session Persistence Time | HTTP connection persistence time
|
| Client Connection Persistence Time | HTTP client connection persistence timeout
|
| Server Response Wait Time | HTTP server response wait timeout
|
| X-Forwarded-For | Whether to insert client IP information
|
| X-Forwarded-Proto | Whether to insert client request protocol information
|
| X-Forwarded-Port | Whether to insert client request port information
|
| Persistence | Whether to use session persistence (Sticky Session)
|
| HTTP 2.0 | Whether to use HTTP/2 when connecting client and server
|
| Routing Rules | Routing action and routing condition/redirection target information
|
| SSL Certificate | Default certificate, SSL security level, and expiration date information
|
| SNI Certificate | SNI certificate detailed information
|
| Server SSL Security Level | Whether to encrypt server connection
|
| Description | Additional information about the Listener
|
Tags
You can view, add, modify, or delete tag information for the Listener.
| Item | Detailed Description |
|---|---|
| Tag List | Tag list
|
Task History
You can view the task history of the Listener.
| Item | Detailed Description |
|---|---|
| Task Details | Task execution content |
| Task Date | Task execution date |
| Resource Type | Resource type |
| Resource Name | Listener name |
| Task Result | Task execution result (Success/Failure) |
| Task User Information | User information who performed the task |
Modifying Routing Rules
You can modify routing rules of a Listener from the Connected Resources tab on the Load Balancer Detail page.
Follow these steps to modify routing rules of the Listener:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the resource for which you want to view detailed information. You will be navigated to the Load Balancer Detail page.
- On the Load Balancer Detail page, click the Connected Resources tab.
- From the connected resources list, click the Listener for which you want to add routing conditions. You will be navigated to the Listener Detail page.
- On the Listener Detail page, click the Edit icon on the Routing Rules item. The Modify Routing Rules popup window will open.
- Modify routing rules according to the routing action, then click the OK button.
Item RequiredDetailed Description Routing Action - Currently set routing method (cannot modify) Routing Condition Required Can modify routing conditions when routing action is LB Server Group Forward - URL Path: Modify request URL path and LB Server Group (can add up to 20)
- Host Header: Modify request host and LB Server Group (can add up to 20)
Redirection Target Required Can modify redirection target when routing action is URL Redirection - Path: Can modify change URL path
- Host: Can modify change host
- Protocol/Port: Cannot modify (only HTTP → HTTPS redirection possible)
Table. Listener routing rule modification items
Deleting a Listener
Follow these steps to delete a Listener that is not in use:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the Load Balancer resource from which you want to delete a Listener. You will be navigated to the Load Balancer Detail page.
- On the Load Balancer Detail page, click the Connected Resources tab. You will be navigated to the Connected Resources tab page.
- On the Connected Resources tab page, click the Listener you want to delete. You will be navigated to the Listener Detail page.
- On the Listener Detail page, click the Delete Listener button.
Terminating Load Balancer
You can terminate a Load Balancer that is not in use to reduce costs. However, since it may affect application services, request termination after sufficient prior review.
You cannot terminate a Load Balancer in the following cases:
- If there are Listeners connected to the Load Balancer: Delete the connected Listeners on the Connected Resources tab of the Load Balancer Detail page.
- If using Public NAT IP on the Load Balancer: Release the Public NAT IP in use on the Detailed Information tab of the Load Balancer Detail page.
- If using Private NAT IP on the Load Balancer: Release the Private NAT IP in use on the Detailed Information tab of the Load Balancer Detail page.
- If there are rules registered in the Firewall: Delete the rules of the Firewall in use on the Detailed Information tab of the Load Balancer Detail page.
- If connected to PrivateLink Service: Check the connected Load Balancer on the PrivateLink Service Detail page.
Follow these steps to terminate a Load Balancer:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be navigated to the Load Balancer List page.
- On the Load Balancer List page, click the resource you want to terminate. You will be navigated to the Load Balancer Detail page.
- On the Load Balancer Detail page, click the Terminate Service button.
- When termination is complete, verify resource termination on the Load Balancer List.
2.1 - LB Server Group
You can create an LB Server Group through the Samsung Cloud Platform Console and connect it to a Load Balancer’s Listener.
Creating LB Server Group
Follow these steps to create an LB Server Group:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be navigated to the LB Server Group List page.
- On the LB Server Group List page, click the Create LB Server Group button. You will be navigated to the Create LB Server Group page.
- On the Create LB Server Group page, enter the information required for service creation and select detailed options.
- In the Service Information area, enter or select the required information.
Item RequiredDetailed Description LB Server Group Name Required LB Server Group resource name - Enter 3 to 63 characters using uppercase/lowercase English letters, numbers, and special characters(
-_)
- LB Server Group name cannot be duplicated within an Account
VPC Name Required Select VPC to create LB Server Group - Select VPC where the Load Balancer to which the LB Server Group will be connected is created
Service Subnet Name Required Select VPC Subnet to create LB Server Group - Select Subnet where the Load Balancer to which the LB Server Group will be connected is created
Load Balancing Required Select load balancing algorithm - Round Robin: Distribute sequentially to registered members
- Weighted round robin: Distribute sequentially in proportion to the weight assigned to each member
- Least Connection: Distribute to the member with the fewest connections
- Weighted least connection: Distribute to the member with the highest priority considering the weight assigned to each member and the number of connections
- IP Hash: Distribute to a specific member according to the client IP address hash value
Protocol Required Select LB Server Group listening protocol - Select protocol to forward to members of LB Server Group
LB Health Check Required Select LB Health Check - Select from LB Health Checks created in the same Service Subnet as the LB Server Group
Table. LB Server Group service information input items - Enter 3 to 63 characters using uppercase/lowercase English letters, numbers, and special characters(
- In the Additional Information area, enter or select the required information.
Item RequiredDetailed Description Description Optional Enter resource description Tag Optional Add tag - Can add up to 50 tags per resource
Table. LB Server Group additional information input items
- In the Service Information area, enter or select the required information.
- Review the created service information and estimated charges, then click the Create button.
- When creation is complete, verify the created resource on the LB Server Group List page.
Viewing LB Server Group Detailed Information
You can view and modify resource lists and detailed information from the LB Server Group menu. The LB Server Group Detail page consists of Detailed Information, Connected Resources, Tags, and Task History tabs.
Follow these steps to view detailed information of the LB Server Group:
Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
On the Service Home page, click the LB Server Group menu. You will be navigated to the LB Server Group List page.
- You can modify column display by clicking the Settings button in the upper right of the table.
Item DisplayDetailed Description LB Server Group Name Default LB Server Group resource name Protocol Default LB Server Group protocol Load Balancer Name Default Load Balancer resource name connected to LB Server Group LB Health Check ID Default LB Health Check resource name used by LB Server Group Member Count Default Number of members registered in LB Server Group Creation Date Default LB Server Group creation date Status Default LB Server Group resource status Table. LB Server Group list items
- You can modify column display by clicking the Settings button in the upper right of the table.
On the LB Server Group List page, click the resource for which you want to view detailed information. You will be navigated to the LB Server Group Detail page.
- At the top of the LB Server Group Detail page, status information and description of additional features are displayed.
Item Detailed Description Status LB Server Group resource status - Active: Service is normally activated
- Deleting: Processing service termination request
- Creating: Processing service creation request
- Error: Cannot check current status due to internal error
- If this status persists, contact Support Center
- Editing: Processing service modification request
Delete LB Server Group Delete LB Server Group resource Table. LB Server Group status information and additional feature items
- At the top of the LB Server Group Detail page, status information and description of additional features are displayed.
Detailed Information
On the Detailed Information tab, you can view detailed information of the resource from the LB Server Group List and modify information if necessary.
| Item | Detailed Description |
|---|---|
| Service | Service name |
| Resource Type | Resource type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource Name | Resource name |
| Resource ID | Unique resource ID in the service |
| Creator | User who requested service creation |
| Creation Date | Service creation date |
| Modifier | User who requested service modification |
| Modification Date | Service modification date |
| Load Balancer Name | Load Balancer resource name connected to LB Server Group
|
| LB Server Group Name | LB Server Group name |
| VPC Name | VPC resource name where the LB Server Group is created
|
| Service Subnet Name | Subnet resource name where the LB Server Group is created
|
| Port | LB Server Group forwarding port |
| Protocol | LB Server Group forwarding protocol |
| Load Balancing | LB Server Group traffic distribution method
|
| LB Health Check | LB Health Check resource name
|
| Description | LB Server Group additional description
|
Connected Resources
On the Connected Resources tab, you can view the list of members connected to the LB Server Group and add or delete members.
| Item | Detailed Description |
|---|---|
| Add Member | Add LB Server Group member button |
| Member Name | Member name (server name) added to LB Server Group |
| IP Address | Member IP address |
| Port | Member listening port |
| Weight | Load balancing weight
|
| Enabled | Whether member is enabled
|
| Creation Date | Member addition date |
| Health Check Status | Health check status information
|
| Status | Member resource status |
Tags
You can view, add, modify, or delete tag information for the resource selected from the LB Server Group List page.
| Item | Detailed Description |
|---|---|
| Tag List | Tag list
|
Task History
On the Task History tab, you can view the task history of the selected resource.
| Item | Detailed Description |
|---|---|
| Task Details | Task execution content |
| Task Date | Task execution date |
| Resource Type | Resource type |
| Resource Name | LB Server Group name |
| Task Result | Task execution result (Success/Failure) |
| Task User Information | User information who performed the task |
Managing LB Server Group Resources
You can view the member list of the LB Server Group and add or delete members.
Adding Member
You can add a member to the LB Server Group to register server resources that will process client requests.
Follow these steps to add a member to the LB Server Group:
Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
On the Service Home page, click the LB Server Group menu. You will be navigated to the LB Server Group List page.
On the LB Server Group List page, click the resource for which you want to modify detailed information. You will be navigated to the LB Server Group Detail page.
On the LB Server Group Detail page, click the Connected Resources tab. You will be navigated to the Connected Resources tab page.
On the Connected Resources tab page, click the Add Member button in the upper right corner.
In the Add Member popup window, enter the required information, then click the OK button.
Item RequiredDetailed Description LB Server Group Name Default LB Server Group name to add member to Target Server Required Server information to add as member - Virtual Server/Bare Metal Server: Select from the list of servers created in the same VPC as the LB Server Group
- Direct IP Input: Enter server IP directly
- Can add target server by clicking the Add button
Member Information Required Set member port and weight - Member Name: Display server name and IP to be added as member
- Port: Port that the member will listen to
- Weight: Weight to be applied to load balancing
- When using Weighted Round Robin, Weighted Least Connection load balancing, must enter a value between 1 and 1000
Table. LB Server Group member addition itemsIn the notification window, click the OK button.
Verify member addition on the Connected Resources tab.
- If the LB Server Group is in Creating, Editing, Deleting, Error status, you cannot add members.
- If the number of members that can be created in the Account to which the LB Server Group belongs is exceeded, you cannot add members. The maximum number of members that can be created in one Account is 1,000.
- You can add a server created in a different VPC as a member through VPC Peering. After adding the target server by Direct IP Input, check the Health Check Status of the added member on the Connected Resources tab.
For details, refer to VPC > VPC Peering.
Modifying Member
Clicking the member name in the member list navigates you to the Member Detail page. You can view detailed information of the member and change information by clicking the Edit icon.
Follow these steps to modify member detailed information:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be navigated to the LB Server Group List page.
- On the LB Server Group List page, click the resource for which you want to modify detailed information. You will be navigated to the LB Server Group Detail page.
- On the LB Server Group Detail page, click the Connected Resources tab. You will be navigated to the Connected Resources tab page.
- On the Connected Resources tab page, click the member you want to modify. You will be navigated to the Member Detail page.
- On the Member Detail page, modify the desired member information.
Modifying Weight
Can be modified when using weighted load balancing (Weighted Round Robin, Weighted Least Connection).
- Click the Edit icon on the Weight item. Enter the weight to modify in the modification window and click the OK button.
Modifying Port
To modify the member port, click the Edit icon on the Port item. Enter the port to modify in the modification window and click the OK button.
Modifying Enabled
To modify member enabled status, click the Edit icon on the Enabled item. Set the enabled status in the modification window and click the OK button.
Deleting Member
Follow these steps to delete a member that is not in use:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be navigated to the LB Server Group List page.
- On the LB Server Group List page, click the resource for which you want to modify detailed information. You will be navigated to the LB Server Group Detail page.
- On the LB Server Group Detail page, click the Connected Resources tab. You will be navigated to the Connected Resources tab page.
- On the Connected Resources tab page, click the member you want to delete. You will be navigated to the Member Detail page.
- On the Member Detail page, click the Delete Member button.
- Verify member deletion on the Connected Resources tab.
Terminating LB Server Group
You can terminate an LB Server Group that is not in use. However, since it may affect application services, request termination after sufficient prior review.
You cannot terminate an LB Server Group in the following cases:
- If the LB Server Group is in use by a Listener: Modify the LB Server Group of the Listener before terminating the LB Server Group.
- If there are registered members in the LB Server Group: Delete all resources connected to the LB Server Group before terminating the LB Server Group.
- If the LB Server Group is used in an Auto-Scaling Group: Set Load Balancer to not use in the Auto-Scaling Group or modify to not use that LB Server Group. For details, refer to Auto-Scaling Group > Using Load Balancer.
Follow these steps to terminate the LB Server Group:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be navigated to the LB Server Group List page.
- On the LB Server Group List, click the resource you want to terminate. You will be navigated to the LB Server Group Detail page.
- On the LB Server Group Detail page, click the Delete LB Server Group button.
- When termination is complete, verify resource termination on the LB Server Group List.
2.2 - LB Health Check
You can create an LB Health Check through the Samsung Cloud Platform Console and use it for LB Server Groups.
Creating LB Health Check
Follow these steps to create an LB Health Check:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Health Check menu. You will be navigated to the LB Health Check List page.
- On the LB Health Check List page, click the Create LB Health Check button. You will be navigated to the Create LB Health Check page.
- On the Create LB Health Check page, enter the information required for service creation and select detailed options.
- In the Service Information area, enter or select the required information.
Item RequiredDetailed Description LB Health Check Name Required LB Health Check resource name - Enter 3 to 63 characters using uppercase/lowercase English letters, numbers, and special characters(
-_)
- LB Health Check name cannot be duplicated within an Account
VPC Name Required Select VPC to create LB Health Check - Select VPC where the LB Server Group to use the LB Health Check is created
Service Subnet Name Required Select VPC Subnet to create LB Health Check - Select Subnet where the LB Server Group to use the LB Health Check is created
Health Check Method > Protocol Required Health check protocol - Select from TCP, HTTP to use for member health check
Health Check Method > Health Check Port Required Health check port - Enter a value between 1 and 65,534 to use for member health check
Health Check Method > Interval Required Health check interval - Default value 5 seconds, can enter between 1 and 180 seconds
Health Check Method > Timeout Required Health check response wait time - Default value 5 seconds, can enter between 1 and 180 seconds
- Cannot set to a value greater than the interval
Health Check Method > Healthy Threshold Required Number of times to determine health check status - Default value 3 times, can enter between 1 and 10
Health Check Method > HTTP Method Required Set HTTP request method (when using HTTP protocol) - Select from GET, POST
Health Check Method > URL Path Required Enter health check URL path (when using HTTP protocol) - Enter within 50 characters using English letters, numbers, and special characters(
/.-_?&=)
Health Check Method > Response Code Required Enter HTTP response code to receive from server (when using HTTP protocol) - Enter response codes in the 200 ~ 500 range
Health Check Method > Request String Required Enter health check request string (when using HTTP protocol POST method) - Enter content to include in Request Body within 255 bytes using English letters, numbers, and special characters(
/.-_?&=)
Table. LB Health Check service information input items - Enter 3 to 63 characters using uppercase/lowercase English letters, numbers, and special characters(
- In the Additional Information area, enter or select the required information.
Item RequiredDetailed Description Description Optional Enter resource description Tag Optional Add tag - Can add up to 50 tags per resource
Table. LB Server Group additional information input items
- In the Service Information area, enter or select the required information.
- In the Summary panel, review the created service information and estimated charges, then click the Create button.
- When creation is complete, verify the created resource on the LB Health Check List page.
For member health check in Load Balancer, add the following rules to the Security Group of the server added as a member.
- (Direction) Inbound rule, (Target Address) Load Balancer’s health check IP, (Protocol) Health check protocol, (Allowed Port) Health check port
- We recommend setting the health check port to be the same as the member port.
- If the health check port and member port are different, health check is performed based on the member port.
Set the LB Health Check to a value that can respond from members to be added to the LB Server Group.
- Since Load Balancer determines member status based on health check response, the LB Health Check result may differ from the actual service status.
Viewing LB Health Check Detailed Information
You can view and modify resource lists and detailed information from the LB Health Check menu. The LB Health Check Detail page consists of Detailed Information, Connected Resources, Tags, and Task History tabs.
Follow these steps to view detailed information of the LB Health Check:
Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
On the Service Home page, click the LB Health Check menu. You will be navigated to the LB Health Check List page.
- You can modify column display by clicking the Settings button in the upper right of the table.
Item DisplayDetailed Description LB Health Check Name Default LB Health Check resource name Service Subnet ID Default VPC Subnet name where the LB Health Check is created LB Server Group Count Default Number of LB Server Groups using the LB Health Check Type Default LB Health Check type Protocol Default LB Health Check protocol Creation Date Default LB Health Check creation date Status Default LB Health Check resource status Table. LB Health Check list items
- You can modify column display by clicking the Settings button in the upper right of the table.
On the LB Health Check List page, click the resource for which you want to view detailed information. You will be navigated to the LB Health Check Detail page.
- At the top of the LB Health Check Detail page, status information and description of additional features are displayed.
Item Detailed Description Status LB Health Check resource status - Active: Service is normally activated
- Deleting: Processing service termination request
- Creating: Processing service creation request
- Error: Cannot check current status due to internal error
- If this status persists, contact Support Center
- Editing: Processing service modification request
Delete LB Health Check Delete LB Health Check resource Table. LB Health Check status information and additional feature items
- At the top of the LB Health Check Detail page, status information and description of additional features are displayed.
Detailed Information
On the Detailed Information tab, you can view detailed information of the resource from the LB Health Check List and modify information if necessary.
| Item | Detailed Description |
|---|---|
| Service | Service name |
| Resource Type | Resource type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource Name | Resource name |
| Resource ID | Unique resource ID in the service |
| Creator | User who requested service creation |
| Creation Date | Service creation date |
| Modifier | User who requested service modification |
| Modification Date | Service modification date |
| LB Health Check Name | LB Health Check name |
| Type | LB Health Check type |
| VPC Name | VPC to use the LB Health Check
|
| Service Subnet Name | VPC Subnet to use the LB Health Check
|
| Health Check Method | LB Health Check method setting information
|
| Description | Additional information about the LB Health Check
|
Connected Resources
On the Connected Resources tab, you can view detailed information of the LB Server Group connected to the LB Health Check.
| Item | Detailed Description |
|---|---|
| LB Server Group Name | LB Server Group resource name
|
| Protocol | LB Health Check protocol |
| Load Balancer Name | Load Balancer resource name connected to LB Server Group |
| Member Count | Number of members added to LB Server Group |
| Creation Date | LB Server Group creation date |
| Status | LB Server Group resource status
|
Tags
You can view, add, modify, or delete tag information for the resource selected from the LB Health Check List page.
| Item | Detailed Description |
|---|---|
| Tag List | Tag list
|
Task History
On the Task History tab, you can view the task history of the selected resource.
| Item | Detailed Description |
|---|---|
| Task Details | Task execution content |
| Task Date | Task execution date |
| Resource Type | Resource type |
| Resource Name | LB Health Check name |
| Task Result | Task execution result (Success/Failure) |
| Task User Information | User information who performed the task |
Modifying LB Health Check Method
You can modify the health check method on the LB Health Check Detail page.
Follow these steps to modify the LB Health Check method:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Health Check menu. You will be navigated to the LB Health Check List page.
- On the LB Health Check List page, click the resource for which you want to modify detailed information. You will be navigated to the LB Health Check Detail page.
- On the LB Health Check Detail page, click the Edit icon on Health Check Method. You will be navigated to the Modify Health Check Method popup window.
- In the Modify Health Check Method popup window, modify the required information, then click the OK button.
Terminating LB Health Check
You can terminate an LB Health Check service that is not in use.
- You cannot delete LB Health Check resources of Default type.
- You cannot delete LB Health Check resources in use by LB Server Groups.
Follow these steps to terminate the LB Health Check:
- Click the All Services > Networking > Load Balancer menu. You will be navigated to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Health Check menu. You will be navigated to the LB Health Check List page.
- On the LB Health Check List, click the resource you want to terminate. You will be navigated to the LB Health Check Detail page.
- On the LB Health Check Detail page, click the Delete LB Health Check button.
- When termination is complete, verify resource termination on the LB Health Check List.
3 - API Reference
4 - CLI Reference
5 - Release Note
Load Balancer
- LB health check port configuration method has been changed.
- You can choose between member port/direct input, and if you select direct input, specify the port to use.
- Existing LB health checks are changed to member ports. (Same as the current health check method)
- HTTPS option has been added to the LB health check protocol.
- You can monitor the server TLS connection status.
- When using URL redirection on the HTTP Listener, you can specify the target port for the redirection.
- You can add Multi-node GPU Cluster resources to LB server group members.
- You can set the Source NAT IP and health check IP when creating a Load Balancer.
- TLS protocol has been added to L4 Listener.
- You can configure TLS services based on TCP.
- Routing rule option has been added to L7 Listener.
- Routing conditions allow setting URL path or host-specific branching.
- Supports multiple SSL certificates.
- Supports SNI, allowing multiple certificates to be registered on a single Listener.
- Add LB health check management feature
- Create an LB health check to define the required health check method and connect it to an LB server group for use.
- LB server group weighted load balancing support
- Weighted Round Robin and Weighted Least Connection have been added to the load balancing options.
- By setting per-member weights, you can distribute server load.
- Add LB server group member activation feature
- You can select whether to enable or disable members belonging to the LB server group.
- A Load Balancer service that provides more stable and enhanced features has been launched.
- Provides an L7 Load Balancer that supports HTTP, HTTPS protocols.
- Provides an L4 Load Balancer that supports TCP, UDP protocols.