This is the multi-page printable view of this section. Click here to print.
Load Balancer
- 1: Overview
- 1.1: ServiceWatch metric
- 2: How-to guides
- 2.1: LB Server Groups
- 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 there is an unpredictable traffic surge or server failure, ensuring the stability and continuity of customer services.
A Load Balancer serves as the service endpoint provided to clients, is deployed in a VPC subnet according to the service type (L4 / L7), and you can configure multiple services 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 an LB server group for each routing condition or set a redirect response for the request URL.
The LB server group forwards requests received by the Listener to specific servers based on load balancing and health checks. The servers receive client requests from the Load Balancer’s Source NAT IP through the ports configured for the members, and the server status is periodically monitored by the Load Balancer’s health check IP.
LB health check defines the member health check method registered in the LB server group. You can select a default LB health check resource provided for the LB server group, or create a new one to configure monitoring suitable for the application.
Features
- Various load balancing methods: Round Robin, Least Connection, IP Hash, etc., are provided.
- SSL Authentication Encryption and Offloading: Supports SSL offloading and allows selection of encryption level.
- Enhanced Security: Use a firewall to manage Load Balancer communication and view connection logs by storing logs.
Service Architecture Diagram
Provided features
- Load Balancer: Select the service type and configure the IP to be used by the Load Balancer.
- Listener: Set the protocol, port, and routing rules. You can add multiple Listeners to a single Load Balancer.
- LB server group: Sets the load balancing method. LB server group can be attached to a single Load Balancer.
- Member: Select the server to add to the LB server group. You can choose Virtual Server or Bare Metal Server resources created in the same VPC as the Load Balancer, or enter an IP address directly.
- LB health check: Sets the member health check method. LB health checks can be registered and used across multiple LB server groups.
Component
A Load Balancer consists of a Load Balancer (Listener), LB server group (member), and LB health check.
Load Balancer
The components that make up a Load Balancer are as follows. By configuring each component, you can set up load balancing suitable for the customer’s workload.
| Component | Detailed description |
|---|---|
| Service Category | Load Balancer service type
|
| Service Sunbet | Assign the Service IP, Source NAT IP, and Health Check IP required for the Load Balancer in the Subnet range of the VPC Subnet
|
| Service IP | Service IP that the client accesses |
| Source NAT IP | IP used to forward server traffic in the Load Balancer |
| Health check IP | IP used for health checks in the Load Balancer |
| Listener | Resources connected to the Load Balancer
|
LB server group
The elements that make up an LB server group are as follows. Traffic is delivered to members of the LB server group according to the settings of each component.
| Component | Detailed description |
|---|---|
| Protocol | LB server group forwarding protocol |
| Load balancing | Traffic distribution method
|
| LB health check | Member health check method
|
| Member | Server that processes client requests
|
LB health check
The elements that make up the LB health check are as follows. Member health checks are performed according to the settings of each component.
| Component | Detailed description |
|---|---|
| Protocol | Health check protocol |
| Health check port | Port used for health check |
| Period | Health check execution interval |
| Waiting time | Server response latency for health check |
| Detection count | Criteria for determining member health check status (Healthy / Unhealthy) |
Constraints
The Load Balancer of Samsung Cloud Platform has a default quota, which limits 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 quota for items that can be expanded.
| Item | Default quota | Detailed description |
|---|---|---|
| LOAD_BALANCER.SERVICE_SUBNET.DEFAULT.COUNT | 3 | Number of Service Subnets per VPC that can create a Load Balancer |
| 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 to the entire LB server group per region |
| LOAD_BALANCER.HEALTH_CHECK.DEFAULT.COUNT | 500 | Number of LB health checks created per region |
Preliminary Service
This is a list of services that must be pre-configured before creating a Load Balancer service. Please refer to the guide provided for each service and prepare in advance.
| Service Category | Service | Detailed description |
|---|---|---|
| Networking | VPC | A service that provides an isolated virtual network in a cloud environment |
1.1 - ServiceWatch metric
The Load Balancer sends metrics to ServiceWatch. The metrics provided by basic monitoring are data collected at 5‑minute intervals.
Basic Metrics
The following are the default metrics for the Load Balancer namespace.
The indicators whose names are displayed in bold text below are the key metrics selected from the basic metrics provided by Load Balancer. Key metrics are used to build the service dashboards that are automatically created for each service in ServiceWatch.
Each metric provides guidance in the user guide on which statistical values are meaningful when querying that metric, and among the meaningful statistics, the values shown in bold are the primary statistics. In the service dashboard, you can view key metrics using primary statistical values.
| Performance items | Detailed description | unit | meaningful statistics |
|---|---|---|---|
| LB Status | Load Balancer status | - | - |
| LB Total Connections | LB cumulative connection count | Count |
|
| LB Total L4 Connections | Cumulative L4 connection count | Count |
|
| LB Total L7 Connections | Cumulative L7 connection count | Count |
|
| LB Total SSL Connections | Cumulative SSL connection count | Count |
|
| LB Total TCP Connections | Cumulative TCP connection count | Count |
|
| LB Current Connections | Current number of active connections | Count |
|
| LB Current SSL Connections | Current SSL connection count | Count |
|
| LB Peak Connections | LB maximum connections | Count |
|
| LB Total Requests | LB cumulative request count | Count |
|
| LB Current Requests | LB current request count | Count |
|
| LB Connection Rate (CPS) | Number of new inbound connections | Count |
|
| LB Forward Bytes | Cumulative bytes transferred from the LB to the server | Bytes |
|
| LB Forward Bytes (Delta) | Cumulative bytes (Delta) delivered from LB to server | Bytes |
|
| LB Forward Packets | Cumulative packets delivered from the LB to the server | Count |
|
| LB Forward Packets (Delta) | Cumulative packets (Delta) delivered from the LB to the server | Count |
|
| LB Reverse Bytes | Cumulative packets delivered from LB to the server | Bytes |
|
| LB Reverse Bytes (Delta) | Cumulative bytes (Delta) received from the server | Bytes |
|
| LB Reverse Packets | Cumulative packets received from the server | Count |
|
| LB Reverse Packets (Delta) | Cumulative packets (Delta) received from the server | Count |
|
| LB Current Responses | LB current response count | Count |
|
| LB Total Success Responses | Cumulative successful response count | Count |
|
| LB Last Response Time | LB last response time | Milliseconds |
|
| LB Fastest Response Time | LB shortest response time | Milliseconds |
|
| LB Slowest Response Time | LB maximum response time | Milliseconds |
|
| LB Total Failure Actions | Number of failures handled in LB | Count |
|
| Listener Status | Listener status | Count |
|
| Listener Total Connections | Listener cumulative connection count | Count |
|
| Listener Total L4 Connections | Cumulative L4 connection count | Count |
|
| Listener Total L7 Connections | Cumulative L7 connection count | Count |
|
| Listener Total SSL Connections | Cumulative SSL connection count | Count |
|
| Listener Total TCP Connections | Cumulative TCP connection count | Count |
|
| Listener Current Connections | Current number of active connections | Count |
|
| Listener Current SSL Connections | Current SSL connection count | Count |
|
| Listener Peak Connections | Maximum number of connections for the listener | Count |
|
| Listener Current Requests | Listener current request count | Count |
|
| Listener Total Requests | Listener cumulative request count | Count |
|
| Listener Connection Rate (CPS) | Number of new inbound connections | Count |
|
| Listener Forward Bytes | Cumulative bytes transferred from the Listener to the server | Bytes |
|
| Listener Forward Bytes (Delta) | Cumulative bytes (Delta) transmitted from the Listener to the server | Bytes |
|
| Listener Forward Packets | Cumulative packets transmitted from the Listener to the server | Count |
|
| Listener Forward Packets (Delta) | Cumulative packets (Delta) transmitted from the Listener to the server | Count |
|
| Listener Reverse Bytes | Cumulative bytes received from the server | Bytes |
|
| Listener Reverse Bytes (Delta) | Cumulative bytes (Delta) received from the server | Bytes |
|
| Listener Reverse Packets | Cumulative packets received from the server | Count |
|
| Listener Reverse Packets (Delta) | Cumulative packets (Delta) received from the server | Count |
|
| Listener Current Responses | Listener current response count | Count |
|
| Listener Total Success Responses | Cumulative successful response count | Count |
|
| Listener Last Response Time | Listener last response time | Milliseconds |
|
| Listener Fastest Response Time | Listener minimum response time | Milliseconds |
|
| Listener Slowest Response Time | Listener maximum response time | Milliseconds |
|
| Listener Total Failure Actions | Number of failures processed in the Listener | Count |
|
| ServerGroup Status | LB server group status | Count |
|
| ServerGroup Request Count | Cumulative request count for LB server group | Count |
|
| ServerGroup Response Count | LB server group cumulative response count | Count |
|
| ServerGroup 2xx Response Count | Number of HTTP 2xx responses | Count |
|
| ServerGroup 3xx Response Count | Number of HTTP 3xx responses | Count |
|
| ServerGroup 4xx Response Count | Number of HTTP 4xx responses | Count |
|
| ServerGroup 5xx Response Count | Number of HTTP 5xx responses | Count |
|
| ServerGroup Healthy Member Count | Number of healthy members | Count |
|
| ServerGroup Unhealthy Member Count | Health check abnormal member count | Count |
|
| ServerGroup Peak Connections | Maximum connections for LB server group | Count |
|
2 - How-to guides
Users can create a service by entering the required Load Balancer information and selecting detailed options through the Samsung Cloud Platform Console.
Create Load Balancer
You can create and use a Load Balancer service from the Samsung Cloud Platform Console.
To create a Load Balancer, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the Create Load Balancer button. You will be taken to the Create Load Balancer page.
- On the Load Balancer Creation page, enter the information required to create the service and select detailed options.
- In the Service Information Input area, enter or select the required information.
| Category | Required status | Detailed description |
|---|---|---|
| Load Balancer name | Required | Load Balancer resource name
|
| Service Category | 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 | Select | Load Balancer’s service IP
|
| Public NAT IP | Select | Select the Public NAT IP to use in the Load Balancer when allowing service access from external (Internet) sources
|
| Source NAT IP | Selection | IP used for member communication in the Load Balancer
|
| Health check IP | Selection | IP to be used for health checks in the Load Balancer
|
| Use firewall | Select | Set whether to use the firewall
|
| Firewall log storage | Select | Select whether to store Firewall logs
|
- In the Additional Information Input area, enter or select the required information.
Category Required statusDetailed description description Select Enter resource description tag Select Add tags - Up to 50 tags can be added per resource
Table. Load Balancer additional information input fields
- Check the created service information and the estimated billing amount, then click the Create button.
- After creation is complete, check the created resources on the Load Balancer List page.guide
- Load Balancer service does not provide access control for Service IP and service ports.
- When creating a Load Balancer, select Use Firewall to manage communication between the client and the Load Balancer, and between the Load Balancer and members with Firewall rules, and we recommend using Save Firewall Logs to store access logs.
- When creating a service and enabling the Firewall log storage feature, you must configure the log storage first. If the log storage is not configured, you cannot create a Load Balancer service.
CautionWhen using a firewall, you must add rules required for Load Balancer communication. Register the rules, paying attention to the direction for each purpose.
- If you do not add a rule, the Load Balancer service will not operate correctly.
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 - When the health check port and member port differ, register the member port
Inbound Figures and tables. Add Load Balancer firewall rule - Load Balancer service does not provide access control for Service IP and service ports.
- After creation is complete, check the created resources on the Load Balancer List page.
Check Load Balancer detailed information
The Load Balancer service can be viewed and edited for the resource list and detailed information in the Load Balancer menu. The Load Balancer Details page consists of Details, Connected Resources, Tags, Activity Log tabs.
Follow these steps to view detailed information about the Load Balancer service.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- From the Service Home page, click the Load Balancer menu. You will be taken to the Load Balancer list page.
- Load Balancer List page, click the resource to view its details. You will be taken to the Load Balancer Details page.
- Load Balancer Details page displays status information and additional feature information, and consists of Details, Connected Resources, Tags, Activity History tabs.
Category Detailed description status Load Balancer resource status - Active: Service is operating normally
- Deleting: Service termination request is being processed
- Creating: Service creation request is being processed
- Error: Unable to determine current status due to internal error
- Editing: Service modification request is being processed
Service termination Delete Load Balancer resource Table. Load Balancer status information and additional feature items
- Load Balancer Details page displays status information and additional feature information, and consists of Details, Connected Resources, Tags, Activity History tabs.
Detailed Information
In the Detailed Information tab, you can view the detailed information of the resource selected from the Load Balancer list and edit the necessary information.
| Category | 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 and time |
| Modification date and time | Service modification date and time |
| constructor | Service creation request user |
| Editor | User requesting service modification |
| Load Balancer name | Load Balancer name |
| Service IP | Load Balancer’s Service IP (used for communication between client and Load Balancer)
|
| Service Category | Load Balancer service type |
| Source NAT IP | Load Balancer’s Source NAT IP (used for communication between Load Balancer and servers)
|
| VPC name | VPC resource name where the Load Balancer is created
|
| Service Subnet name | Subnet resource name where the Load Balancer was 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 performing health checks on LB server group members)
|
| Explanation | Additional information or description about Load Balancer
|
| Firewall name | Firewall resource name connected to Load Balancer
|
Connected resources
Connected Resources tab lets you view the list of Listeners attached to the Load Balancer, and you can create or delete Listeners.
- In the Connected Resources tab, selecting the Listener item takes you to the Listener Details page where you can view, edit, and delete the detailed information.
- On the Listener Details page, clicking the Edit icon lets you modify the information.
| Category | Detailed description | |
|---|---|---|
| Create Listener | Create Listener button | |
| Listener name | Listener resource name | |
| Routing rules | Routing rules attached to the Listener
| |
| Protocol | Protocol that the Listener receives | |
| Port | Port that the Listener receives | |
| Creation Date/Time | Listener creation time | |
| Delete | Delete Listener button |
tag
Load Balancer List page lets you view the tag information of the selected resource, and you can add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
Work History tab allows you to view the work history of the selected resource.
| Category | Detailed description |
|---|---|
| Work log | Task execution details |
| Work Date/Time | Task execution date and time |
| Resource Type | Resource Type |
| Resource name | Load Balancer name |
| Operation result | Task execution result (success/failure) |
| Operator Information | User information of the performed operation |
Load Balancer Resource Management
You can manage resources such as creating and deleting Load Balancer listeners.
Create Listener
Create a Listener on the Load Balancer to receive client requests and handle traffic according to the Listener configuration.
The protocol that receives client requests varies depending on the Load Balancer service type.
- L4 Load Balancer case: TLS, TCP, UDP protocols
- When using an L7 Load Balancer: HTTP, HTTPS protocols
Creating a Listener in L4 Load Balancer
To create a Listener in the L4 Load Balancer, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be taken to the Load Balancer list page.
- Load Balancer List page, click the Load Balancer resource to create a Listener. You will be taken to the Load Balancer Details page.
- On the Load Balancer Details page, click the Connected Resources tab. You will be taken to the Connected Resources tab page.
- On the Connected Resources tab page, click the Create Listener button in the upper right.
- Enter or select the required information in the Service Information Input area.
- The information that can be entered varies depending on the protocol.
| Category | Required | Detailed description |
|---|---|---|
| Load Balancer | Required | Name of the Load Balancer resource where the Listener will be created |
| Listener name | Required | Listener resource name |
| Protocol | Required | Select Listener receive protocol
|
| service port | Required | Enter Listener receiving port
|
| Routing rules | Required | Routing rule configuration
|
| Session retention time | Required | Client session keep-alive time setting
|
| Proxy Protocol | Select | Set whether to add client IP information to the proxy protocol header (when using TCP protocol)
|
| Persistence | Required | Select Sticky Session method (set when using TCP, TLS protocols)
|
| SSL certificate | Select | Select default encryption certificate and security level (when using the TLS protocol)
|
| Server SSL security level | Required | Select security level when configuring End-to-End SSL (TLS protocol settings)
|
- In the Additional Information Input area, enter or select the required information.
| Category | Required | Detailed description |
|---|---|---|
| Explanation | Select | Enter resource description |
| tag | Select | Add tags
|
- Verify the created service information and click the Create button.
- When creation is complete, verify the created resource on the Load Balancer Details page’s Connected Resources tab.
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. Go to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be taken to the Load Balancer list page.
- On the Load Balancer List page, click the Load Balancer resource for which you want to create a Listener. You will be taken to the Load Balancer Details page.
- Click the Connected Resources tab on the Load Balancer Details page. You will be taken to the Connected Resources tab page.
- On the Connected Resources tab page, click the Create Listener button in the upper right.
- In the Service Information Input area, enter or select the required information.
- The information that can be entered varies depending on the protocol.
| Category | Required status | Detailed description |
|---|---|---|
| Load Balancer | Required | Load Balancer resource name where the Listener is created |
| Listener name | Required | Listener resource name |
| Protocol | Required | Select Listener reception protocol
|
| service port | Required | Listener receive port input
|
| Routing Rules > Routing Action | Required | Select routing processing method
|
| Routing Rules > Routing Conditions | Required | When the routing action is LB server group forwarding, set the LB server group per routing condition
|
| Persistence | Selection | Select Sticky Session mode (set when the routing action is LB server group forwarding)
|
| Listener timeout setting > Session keep-alive time | Select | HTTP connection keep-alive time setting
|
| Listener timeout setting > HTTP connection timeout | Select | Set HTTP response timeout
|
| X-Forwarded-For | Select | Set whether to insert client IP information
|
| X-Forwarded-Proto | Select | Set whether to insert client request protocol information
|
| X-Forwarded-Port | Select | Set whether to insert client request port information
|
| HTTP 2.0 | Select | Set whether to use HTTP/2 for client‑server connections |
| SSL certificate | Select | Select encryption certificate and security level (HTTPS protocol usage)
|
| Server SSL security level | Required | Select security level when configuring End-to-End SSL (HTTPSS protocol setting)
|
The routing rule’s URL path matching method is Starts with(prefix match).
- It checks whether the entered URL path starts with a specific string, and if the beginning matches, the routing rule is applied.
- Example: when the entered URL is
/api/- Matching URL:
/api/users, /api/v1/login, /api/images/logo.png - Unmatched URL:
/auth/api/, /API/users
- Matching URL:
- In the Additional Information Input area, enter or select the required information.
| Category | Required status | Detailed description |
|---|---|---|
| Explanation | Select | Enter resource description |
| tag | Select | Add tags
|
- Verify the created service information and click the Create button.
- When creation is complete, verify the created resource on the Load Balancer Details page’s Connected Resources tab.
SSL security level support items
The list of TLS versions and Cipher Suites supported by the Listener for each SSL security level 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 |
Check Listener detailed information
On the Connected Resources tab of the Load Balancer Details page, you can select a Listener to view and edit its detailed information.
To view the Listener’s detailed information, follow these steps.
- Click the All Services > Networking > Load Balancer menu. Navigate to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be taken to the Load Balancer List page.
- On the Load Balancer List page, click the resource whose details you want to view. You will be taken to the Load Balancer Details page.
- On the Load Balancer Details page, click the Connected Resources tab.
- Click the Listener to view detailed information from the list of connected resources. It navigates to the Listener Details page.
- Listener Details page displays status information and additional feature information, and consists of Details, Tags, Activity Log tabs.
| Category | Detailed description |
|---|---|
| status | Listener status
|
| Delete Listener | Delete Listener |
Detailed Information
Detailed Information tab allows you to view the Listener’s detailed information and edit the necessary details. Detailed information varies depending on the Load Balancer in use.
L4 Load Balancer Detailed Information
| Category | 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 |
| constructor | User requesting listener creation |
| Creation Date/Time | Listener creation time |
| Editor | User requesting listener modification |
| Modification date | Listener modification timestamp |
| Listener name | Listener name |
| Protocol | Listener usage protocol |
| Port | Listener port |
| Session retention time | Client session retention time
|
| Proxy Protocol | Whether to insert client IP information
|
| Persistence | Use of sticky session
|
| Routing rules | Routing action and LB server group information
|
| SSL certificate | Default certificate and SSL security level, expiration date and time information
|
| SNI certificate | SNI Certificate Details
|
| Server SSL security level | Whether server connection is encrypted
|
| Explanation | Additional information about the Listener
|
L7 Load Balancer Detailed Information
| Category | 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 |
| constructor | User requesting listener creation |
| Creation Date/Time | Listener creation time |
| Editor | User requesting listener modification |
| Modification date | Listener modification timestamp |
| Listener name | Listener name |
| Protocol | Listener usage protocol |
| Port | Listener port |
| Session retention time | HTTP connection keep-alive time
|
| Client connection keep-alive time | HTTP client connection keep-alive timeout
|
| Server response latency | 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 | Use of sticky session
|
| HTTP 2.0 | Whether to use HTTP/2 for client-server connections
|
| Routing rules | Routing action and routing condition/redirect target information
|
| SSL certificate | Default certificate and SSL security level, expiration date and time information
|
| SNI certificate | SNI Certificate Details
|
| Server SSL security level | Whether server connection is encrypted
|
| Explanation | Additional information about the Listener
|
tag
You can view, add, modify, or delete a Listener’s tag information.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
You can view the Listener’s operation history.
| Category | Detailed description |
|---|---|
| Work log | Task execution details |
| Operation Date/Time | Task execution date and time |
| Resource Type | Resource Type |
| Resource Name | Listener name |
| Operation result | Task execution result (success/failure) |
| Operator Information | Information about the user who performed the task |
Modify routing rules
On the Connected Resources tab of the Load Balancer Details page, you can modify the Listener’s routing rules.
To modify the Listener’s routing rules, follow these steps.
- Click the All Services > Networking > Load Balancer menu. Navigate to the Load Balancer’s Service Home page.
- From the Service Home page, click the Load Balancer menu. You will be taken to the Load Balancer list page.
- On the Load Balancer List page, click the resource you want to view details for. You will be taken to the Load Balancer Details page.
- On the Load Balancer Details page, click the Connected Resources tab.
- Click the Listener to add a lighting condition from the list of connected resources. You will be taken to the Listener Details page.
- On the Listener Details page, click the Edit icon of the Routing Rules item. The Edit Routing Rules popup window opens.
- After modifying the routing rule according to the routing action, click the Confirm button.
Category Required statusDetailed description Routing Action - Current routing method (cannot be modified) Routing condition Required If the routing action is LB server group forwarding, routing conditions can be modified - URL path: Modify request URL path and LB server group (up to 20 additions possible)
- Host header: Modify request host and LB server group (up to 20 additions possible)
Redirect target Required When the routing action is URL redirection, the redirect target can be modified - Path: the URL path can be changed
- Host: the host can be changed
- Protocol/Port: cannot be modified (only HTTP → HTTPS redirection is allowed)
Table. Listener routing rule modification items
Delete Listener
To delete an unused Listener, follow these steps.
- Click the All Services > Networking > Load Balancer menu to go to the Load Balancer’s Service Home page.
- Click the Load Balancer menu on the Service Home page. You will be taken to the Load Balancer List page.
- Load Balancer List page, click the Load Balancer resource whose Listener you want to delete. You will be taken to the Load Balancer Details page.
- On the Load Balancer Details page, click the Connected Resources tab. You will be taken to the Connected Resources tab page.
- On the Connected Resources tab page, click the Listener you want to delete. Navigate to the Listener Details page.
- On the Listener Details page, click the Delete Listener button.
Terminate Load Balancer
You can reduce costs by terminating unused Load Balancers. However, since this may affect application services, request termination only after thorough prior review.
In the following cases, the Load Balancer cannot be terminated.
- If there is a Listener attached to the Load Balancer: Delete the attached Listener on the Load Balancer Details page’s Connected Resources tab.
- If you are using a Public NAT IP on the Load Balancer: Load Balancer Details page’s Details tab, deselect the Public NAT IP that is in use.
- If you are using a Private NAT IP on the Load Balancer: Load Balancer Details page’s Details tab, deselect the Private NAT IP in use.
- If there are rules registered in the Firewall: delete the Firewall rules in use from the Load Balancer Details page’s Detailed Information tab.
- If connected to a PrivateLink Service: Check the connected Load Balancer on the PrivateLink Service Details page.
To cancel the Load Balancer, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the Load Balancer menu. You will be taken to the Load Balancer List page.
- Load Balancer List page, click the resource to terminate. You will be taken to the Load Balancer Details page.
- On the Load Balancer Details page, click the Terminate Service button.
- After termination is complete, check the resource termination status in the Load Balancer list.
2.1 - LB Server Groups
Users can create an LB server group through the Samsung Cloud Platform Console and connect it to a Load Balancer’s listener.
Create LB server group
To create an LB server group, follow these steps.
- Click the All Services > Networking > Load Balancer menu to go to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be taken to the LB Server Group List page.
- On the LB Server Group List page, click the Create LB Server Group button. You will be taken to the Create LB Server Group page.
- On the Create LB Server Group page, enter the information required to create a service and select detailed options.
- Enter or select the required information in the Service Information Input area.
Category Required statusDetailed description LB server group name Required LB server group resource name - Enter using English letters, numbers, and special characters (
-_) with a length of 3 to 63 characters
- LB server group name must be unique within the Account
VPC name Required Select the VPC to create the LB server group - Select the VPC where the Load Balancer that will connect to the LB server group is created
Service Subnet name Required Select the VPC Subnet to create the LB server group - Select the Subnet where the Load Balancer that will connect to the LB server group is created
Load balancing Required Load Balancing Algorithm Selection - Round Robin: Distribute sequentially among 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 higher‑priority member considering each member’s weight and connection count
- IP Hash: Distribute to a specific member based on the hash value of the client IP address
Protocol Required Select the receiving protocol for the LB server group - Select the protocol to forward to members of the LB server group
LB health check Required Select LB health check - Select an LB health check that was created in the same Service Subnet as the LB server group
Table. LB server group service information input fields - Enter using English letters, numbers, and special characters (
- Enter or select the required information in the Additional Information Input area.
Category Required statusDetailed description Explanation Select Enter resource description tag Select Add tags - Up to 50 tags can be added per resource
Table. LB server group additional information input fields
- Enter or select the required information in the Service Information Input area.
- Check the created service information and the estimated billing amount, and click the Create button.
- When creation is complete, verify the created resources on the LB server group list page.
Check detailed information of LB server group
In the LB Server Group menu, you can view and edit the resource list and detailed information. The LB Server Group Details page consists of Details, Connected Resources, Tags, Operation History tabs.
To view detailed information about the LB server group, follow these steps.
Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
On the Service Home page, click the LB server group menu. You will be taken to the LB server group list page.
- You can modify column visibility by clicking the Settings button at the top right of the table.
Category Display optionDetailed description LB server group name Basic LB server group resource name Protocol Basic LB server group protocol Load Balancer name Basic Load Balancer resource name linked to the LB server group LB Health Check ID Basic LB server group’s LB health check resource name Number of members Basic Number of members registered in the LB server group Creation date and time Basic LB server group creation time status Basic LB server group resource status Table. LB server group list items
- You can modify column visibility by clicking the Settings button at the top right of the table.
On the LB server group list page, click the resource to view detailed information. It navigates to the LB server group details page.
- LB Server Group Details At the top of the page, status information and descriptions of additional features are displayed.
Category Detailed description status LB server group resource status - Active: The service is active and functioning normally
- Deleting: Processing service termination request
- Creating: Processing service creation request
- Error: Cannot determine current status due to an internal error
- If this status persists, please contact through the 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
- LB Server Group Details At the top of the page, status information and descriptions of additional features are displayed.
Detailed Information
In the Detailed Information tab, you can view the detailed information of a resource from the LB server group list, and edit it if necessary.
| Category | 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 |
| Constructor | User requesting service creation |
| Creation date | Service creation date and time |
| Editor | User requesting service modification |
| Modification date and time | Service modification date and time |
| Load Balancer name | Load Balancer resource name connected to the LB server group
|
| LB server group name | LB server group name |
| VPC name | VPC resource name where the LB server group was 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 addition description
|
Connected resources
Connected Resources tab allows you to view the list of members connected to the LB server group, and you can add or delete members.
| Category | Detailed description |
|---|---|
| Add member | Add LB Server Group Member button |
| Member name | Member name (server name) added to the LB server group |
| IP address | Member IP address |
| Port | Member receive port |
| weight | Load balancing weight
|
| Activation | Member activation status
|
| Creation date and time | Member addition date/time |
| Health check status | Health check status information
|
| status | Member resource status |
tag
On the LB server group list page, you can view the tag information of the selected resource and add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
Work History tab allows you to view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Work history | Task execution details |
| Operation date and time | Task execution date and time |
| Resource Type | Resource Type |
| Resource Name | LB server group name |
| Operation result | Task execution result (success/failure) |
| Operator Information | User information of the performed operation |
Managing LB Server Group Resources
You can view the member list of an LB server group and add or remove members.
Add member
You can add members to the LB server group to register server resources that will handle client requests.
To add a member to the LB server group, follow these steps.
Click the All Services > Networking > Load Balancer menu to go to the Load Balancer’s Service Home page.
On the Service Home page, click the LB Server Group menu. You will be taken to the LB Server Group List page.
On the LB Server Group List page, click the resource you want to edit detailed information for. You will be taken to the LB Server Group Detail page.
On the LB Server Group Details page, click the Connected Resources tab. You will be taken to the Connected Resources tab page.
On the Connected Resources tab page, click the Add Member button in the upper right.
Add Member After entering the required information in the popup window, click the Confirm button.
Category Required statusDetailed description LB server group name basic LB server group name for adding a member target server Required Server information to add as a member - Virtual Server/Bare Metal Server: Select from the list of servers created in the same VPC as the LB server group
- Enter IP Directly: Enter server IP directly
- Click the Add button to add the target server
Member information Required Member Port and Weight Settings - Member Name: Display the server name and IP to be added as a member
- Port: The port the member will receive
- Weight: The weight applied to load balancing
- When using Weighted Round Robin or Weighted Least Connection load balancing, a value between 1 ~ 1000 is required
Table. LB server group member addition itemClick the OK button in the alert dialog.
Check if members have been added in the Connected Resources tab.
Add the following rule to the Security Group of the server added as a member to allow communication between the Load Balancer and the LB server group members.
- (Direction) Inbound rule, (Target address) Load Balancer’s Source NAT IP, (Protocol) LB server group protocol, (Allowed port) member port
- If the LB server group is in Creating, Editing, Deleting, Error state, 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 a single Account is 1,000.
- Through VPC Peering, you can add a server created in another VPC as a member. After adding the target server by Enter IP Directly, check the Health Check Status of the added member in the Connected Resources tab.
For detailed information, refer to VPC > VPC Peering.
Member Edit
When you click a member name in the member list, you are taken to the Member Details page. You can view the member details, and you can click the Edit icon to change the information.
To edit member details, follow these steps.
- Click the All Services > Networking > Load Balancer menu to go to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be taken to the LB Server Group List page.
- On the LB Server Group List page, click the resource you want to edit details for. You will be taken to the LB Server Group Details page.
- On the LB Server Group Details page, click the Connected Resources tab. You will be taken to the Connected Resources tab page.
- Linked Resources tab page, click the member you want to edit. You will be taken to the Member Details page.
- Edit the desired member information on the Member Details page.
Weight modification
It can be modified when using weighted load balancing (Weighted Round Robin, Weighted Least Connection).
- Click the Edit icon of the Weight item. In the edit window, enter the weight to edit and click the Confirm button.
Port modification
To edit a member port, click the Edit icon in the Port field. In the edit window, enter the port to edit and click the Confirm button.
Activate edit
To modify member activation, click the Edit icon of the Activation item. In the edit window, set the activation status and click the Confirm button.
Delete member
To delete unused members, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be taken to the LB Server Group List page.
- On the LB Server Group List page, click the resource whose details you want to edit. You will be taken to the LB Server Group Details page.
- On the LB Server Group Details page, click the Connected Resources tab. You will be taken to the Connected Resources tab page.
- Linked Resources tab page, click the member you want to delete. You will be taken to the Member Details page.
- On the Member Details page, click the Delete Member button.
- Check whether the member has been deleted in the Connected Resources tab.
Terminate LB server group
You can terminate an unused LB server group. However, because it may affect the application service, please request termination only after thorough prior review.
The LB server group cannot be terminated in the following cases.
- If the LB server group is being used in a Listener: modify the Listener’s LB server group before deleting the LB server group.
- If there are members registered in the LB server group: Delete all resources attached to the LB server group before terminating the LB server group.
- When using an LB server group in an Auto Scaling Group: configure the load balancer so it is not used by the Auto Scaling Group, or adjust it so that the LB server group is not utilized. For more details, see Auto-Scaling Group > Load Balancer Usage.
To terminate the LB server group, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Server Group menu. You will be taken to the LB Server Group List page.
- From the LB server group list, click the resource to be terminated. You will be taken to the LB server group detail page.
- On the LB server group detail page, click the LB server group delete button.
- Once the termination is complete, check the resource termination status in the LB server group list.
2.2 - LB Health Check
Users can create LB health checks through the Samsung Cloud Platform Console and use them for LB server groups.
Create LB health check
To create an LB health check, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Health Check menu. You will be taken to the LB Health Check List page.
- On the LB Health Check List page, click the Create LB Health Check button. You will be directed to the Create LB Health Check page.
- On the LB Health Check Creation page, enter the information required to create the service and select detailed options.
- In the Service Information Input area, enter or select the required information.
Category RequiredDetailed description LB health check name Required LB health check resource name - Enter using English uppercase and lowercase letters, numbers, and special characters (
-_) with a length of 3 to 63 characters
- LB health check name must be unique within the Account
VPC name Required Select the VPC to create the LB health check - Select the VPC where the LB server group that will use the LB health check is created
Service Subnet name Required Select the VPC Subnet to create the LB health check - Select the Subnet where the LB server group that will use the LB health check is created
Health check method > Protocol Required Health Check Protocol - Select the protocol to use for member health checks among TCP, HTTP
Health check method > Health check port Required Health check port - Enter a value between 1 and 65,534 to use as the member health check port
Health check method > interval Required Health check interval - Default is 5 seconds, input allowed between 1 and 180 seconds
Health check method > waiting time Required Health check response wait time - Default 5 seconds, can be set between 1 and 180 seconds
- Cannot be set to a value larger than the interval
Health check method > detection count Required Number of times to evaluate health check status - Default value 3 times, input allowed between 1 and 10
Health check method > HTTP method Required Set HTTP request method (HTTP protocol usage setting) - Select GET or POST
Health check method > URL monitor Required Enter health check URL path (set when using HTTP protocol) - Enter using English letters, numbers, and special characters (
/.-_?&=) within 50 characters
Health check method > Response code Required Enter the HTTP response codes to receive from the server (HTTP protocol when used) - Enter response codes in the 200 ~ 500 range
Health check method > request string Required Health check request string input (HTTP protocol POST method setting) - Enter the content to include in the Request Body using English letters, numbers, and special characters (
/.-_?&=) within 255 bytes
Table. LB health check service information input items - Enter using English uppercase and lowercase letters, numbers, and special characters (
- In the Additional Information Input area, enter or select the required information.
Category Required statusDetailed description description Select Enter resource description tag Select Add tags - Up to 50 tags can be added per resource
Table. LB server group additional information input fields
- In the Service Information Input area, enter or select the required information.
- Summary Check the service information and estimated charges created in the panel, and click the Create button.
- When creation is complete, check the created resources on the LB Health Check List page.
Add the following rule to the Security Group of the server added as a member for member health checks in the Load Balancer.
- (Direction) Inbound rule, (Target address) Load Balancer’s health check IP, (Protocol) health check protocol, (Allowed port) health check port
- It is recommended to set the health check port the same as the member port.
- If the health check port and the member port differ, the health check is performed using the member port.
Configure the LB health check to a value that members added to the LB server group can respond to.
- Since the Load Balancer determines member status based on health check responses, the LB health check results may differ from the actual service status.
View detailed LB health check information
In the LB Health Check menu, you can view and edit the resource list and detailed information. The LB Health Check Details page consists of Details, Connected Resources, Tags, Activity Log tabs.
To view detailed LB health check information, follow these steps.
Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
On the Service Home page, click the LB Health Check menu. You will be taken to the LB Health Check List page.
- You can modify the column visibility by clicking the Settings button at the top right of the table.
Category Display optionDetailed description LB health check name Basic LB health check resource name Service Subnet ID Basic VPC Subnet name where the LB health check was created Number of LB server groups Basic Number of LB server groups using LB health check type Basic LB Health Check Type Protocol Basic LB health check protocol Creation date and time Basic LB health check creation timestamp status Basic LB health check resource status Table. LB health check list items
- You can modify the column visibility by clicking the Settings button at the top right of the table.
On the LB Health Check List page, click the resource to view detailed information. You will be taken to the LB Health Check Details page.
- LB Health Check Details At the top of the page, status information and descriptions of additional features are displayed.
Category Detailed description status LB health check resource status - Active: The service is active and functioning normally
- Deleting: Processing service termination request
- Creating: Processing service creation request
- Error: Unable to determine current status due to an internal error
- If this status persists, please contact the 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
- LB Health Check Details At the top of the page, status information and descriptions of additional features are displayed.
Detailed Information
Details tab allows you to view the resource’s detailed information from the LB health check list, and edit the information if needed.
| Category | 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 |
| constructor | User requesting service creation |
| Creation date and time | Service creation date and time |
| Editor | Service modification request user |
| Modification date and time | Service modification date and time |
| LB health check name | LB health check name |
| type | LB health check type |
| VPC name | VPC to use for LB health check
|
| Service Subnet name | VPC Subnet for LB health checks
|
| Health check method | LB health check method configuration information
|
| description | Additional information about LB health check
|
Connected resource
In the Connected Resources tab, you can view detailed information about the LB server groups associated with the LB Health Check.
| Category | Detailed description |
|---|---|
| LB server group name | LB server group resource name
|
| Protocol | LB health check protocol |
| Load Balancer name | Load Balancer resource name linked to the LB server group |
| Number of members | Number of members added to the LB server group |
| Creation date and time | LB server group creation timestamp |
| status | LB server group resource status
|
tag
LB health check list page lets you view the tag information of the selected resource and add, modify, or delete it.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
Work History tab allows you to view the operation history of the selected resource.
| Category | Detailed description |
|---|---|
| Work history | Task execution details |
| Operation Date/Time | Execution date and time |
| Resource Type | Resource Type |
| Resource Name | LB health check name |
| Work result | Task execution result (success/failure) |
| Operator Information | User information of the performed operation |
Modify LB health check method
LB Health Check Details page allows you to modify the health check method.
To modify the LB health check method, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Health Check menu. You will be taken to the LB Health Check List page.
- LB Health Check List page, click the resource you want to edit details for. You will be taken to the LB Health Check Details page.
- On the LB Health Check Details page, click the Edit icon of the Health Check Method. You will be taken to the Edit Health Check Method popup.
- Modify health check method After editing the required information in the popup window, click the Confirm button.
Cancel LB health check
You can cancel the LB health check service you are not using.
- default type LB health check resource cannot be deleted.
- LB health check resources used by the LB server group cannot be deleted.
To disable the LB health check, follow these steps.
- Click the All Services > Networking > Load Balancer menu. You will be taken to the Load Balancer’s Service Home page.
- On the Service Home page, click the LB Health Check menu. You will be taken to the LB Health Check List page.
- Click the resource to terminate from the LB health check list. You will be taken to the LB health check details page.
- On the LB Health Check Details page, click the Delete LB Health Check button.
- Once the termination is complete, check the resource termination status in the LB health check list.
3 - API Reference
4 - CLI Reference
5 - Release Note
Load Balancer
- A feature has been added to enable setting a Private NAT IP on the Service IP.
- The ‘TCP_Proxy’ protocol has been added to the L4 Listener.
- The conditions for creating L4 Listener service ports have been changed.
- It has been changed to allow creating a Listener on the same service port for both TCP and UDP protocols.
- The method for entering L7 Listener routing rules has been changed.
- LB server group forwarding > Modified to allow users to add a ‘/’ path in the URL path.
- LB server group forwarding > The matching method for the entered path in the URL path has been changed from ‘Contains(Include match)’ to ‘Starts with(Start part match)’.
- LB server group forwarding > The ‘Default’ condition for the request host in the host header has been added.
- The method for configuring the LB health check port has been changed.
- You can select either a member port or manual entry, and when using manual entry, specify the port to use.
- Existing LB health checks are changed to the member port. (Same as the current health check method)
- The HTTPS option has been added to the LB health check protocol.
- You can monitor the server’s TLS connection status.
- When using URL redirection in an HTTP Listener, you can specify the target port for the redirection.
- You can add Multi-node GPU Cluster resources to the LB server group members.
- When creating a Load Balancer, you can set the Source NAT IP and health check IP.
- TLS protocol has been added to the L4 Listener.
- You can set up a TLS service over TCP.
- A routing rule option has been added to the L7 Listener.
- Routing conditions allow you to set up branching by URL path or by host.
- Supports multiple SSL certificates.
- By supporting SNI, you can register multiple certificates on a single Listener.
- Add LB health check management feature
- You can create an LB health check, define the required health check method, and connect it to an LB server group for use.
- Support for weighted load balancing of LB server groups
- Weighted Round Robin and Weighted Least Connection have been added to the load balancing options.
- You can set per-member weights to distribute server load.
- Add LB server group member activation feature
- You can choose to activate members of the LB server group by disabling or enabling them.
- A Load Balancer service that provides more stable and enhanced features has been launched.
- Provides an L7 Load Balancer that supports HTTP and HTTPS protocols.
- Provides an L4 Load Balancer that supports TCP and UDP protocols.