Creating a Load Balancer
Function
This API is used to create a dedicated load balancer. When you create a dedicated load balancer, note the following:
-
Specify vip_subnet_cidr_id if you want to bind a private IPv4 address to the dedicated load balancer.
-
Specify publicip and either vpc_id or vip_subnet_cidr_id if you want to bind a new IPv4 EIP to the dedicated load balancer.
-
Specify publicip_ids and either vpc_id or vip_subnet_cidr_id if you want to bind an existing IPv4 EIP to the dedicated load balancer.
-
Specify ipv6_vip_virsubnet_id if you want to bind a private IPv6 address to the dedicated load balancer.
-
Specify both ipv6_vip_virsubnet_id and ipv6_bandwidth if you want to bind a public IPv6 address to the dedicated load balancer.
-
Specify l4_flavor_id if you want to create a network load balancer and l7_flavor_id to create an application load balancer. Specify both l4_flavor_id and l7_flavor_id if you want to create a load balancer that can work at both Layer 4 and Layer 7.
-
Specify prepaid_options if you want to create a yearly/monthly load balancer.
-
If prepaid_options is not specified, pay-per-use load balancers will be created, which are billed by fixed specifications or elastic specifications you have selected for l4_flavor_id and l7_flavor_id when creating the load balancer.
Constraints
There are some constraints when you create a dedicated load balancer:
-
vpc_id, vip_subnet_cidr_id, and ipv6_vip_virsubnet_id cannot be left blank at the same time.
-
ip_target_enable specifies whether to enable IP as a Backend. If you enable this function for a dedicated load balancer, you can associate servers in a VPC connected through a VPC peering connection, in a VPC connected through a cloud connection, or in an on-premises data center at the other end of a Direct Connect or VPN connection, by using server IP addresses.
-
admin_state_up must be set to true.
-
provider must be set to vlb.
-
elb_virsubnet_ids indicates the subnets that support IPv4/IPv6 dual stack or only IPv4 subnets. If only IPv4 subnets are supported, ipv6_vip_virsubnet_id must be left blank.
-
If you bind an EIP to the load balancer during creation, you cannot unbind it from the load balancer by calling the API after the load balancer is created. Instead, you can unbind the EIP only on the ELB console. Locate the dedicated load balancer in the load balancer list and click More > Unbind EIP in the Operation column.
-
publicip_ids and publicip cannot be specified at the same time. Set either publicip_ids to bind an existing EIP to the load balancer, or publicip to bind a new EIP to the load balancer, or neither of them.
-
If you want to add the load balancer to a shared bandwidth, you must specify the ID of the shared bandwidth. If you want the load balancer to use a new dedicated bandwidth, charge_mode, share_type, and size are required.
Calling Method
For details, see Calling APIs.
URI
POST /v3/{project_id}/elb/loadbalancers
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Specifies the project ID of the load balancer. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
No |
String |
Specifies the token used for IAM authentication. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
loadbalancer |
Yes |
CreateLoadBalancerOption object |
Specifies the load balancer. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
No |
String |
Specifies the project ID. |
name |
No |
String |
Specifies the load balancer name. Each name contains a maximum of 255 Unicode characters and can be left blank. |
description |
No |
String |
Provides supplementary information about the load balancer. A description can contain a maximum of 255 Unicode characters and can be left blank. |
vip_address |
No |
String |
Specifies the private IPv4 address bound to the load balancer. The IP address must be from the IPv4 subnet where the load balancer resides and should not be occupied. Notes and constraints:
The IP address must be in [0-255].[0-255].[0-255].[0-255] format, for example, 192.168.1.1. |
vip_subnet_cidr_id |
No |
String |
Specifies the ID of the frontend IPv4 subnet where the load balancer resides. You can query parameter neutron_subnet_id in the response by calling the API (GET https://{VPC_Endpoint}/v1/{project_id}/subnets). Notes and constraints:
The ID must be in UUID format and can contain up to 36 characters. |
ipv6_vip_virsubnet_id |
No |
String |
Specifies the ID of the frontend IPv6 subnet where the load balancer resides. You can query parameter neutron_network_id in the response by calling the API (GET https://{VPC_Endpoint}/v1/{project_id}/subnets). Notes and constraints:
The ID must be in UUID format and can contain up to 36 characters. |
provider |
No |
String |
Specifies the provider of the load balancer. The value can only be vlb. |
l4_flavor_id |
No |
String |
Specifies the flavor ID of a network load balancer. You can query parameter id in the response by calling the API (GET https://{ELB_Endpoint}/v3/{project_id}/elb/flavors?type=L4). Notes and constraints:
The ID must be in UUID format and can contain up to 36 characters. |
l7_flavor_id |
No |
String |
Specifies the flavor ID of an application load balancer. You can query parameter id in the response by calling the API (GET https://{ELB_Endpoint}/v3/{project_id}/elb/flavors?type=L7). Notes and constraints:
The ID must be in UUID format and can contain up to 36 characters. |
guaranteed |
No |
Boolean |
Specifies whether the load balancer is a dedicated load balancer. The value can be:
Currently, the value can only be true. If the value is set to false, 400 Bad Request will be returned. |
vpc_id |
No |
String |
Specifies the ID of the VPC where the load balancer resides. You can query parameter id in the response by calling the API (GET https://{VPC_Endpoint}/v1/{project_id}/vpcs). Note: vpc_id, vip_subnet_cidr_id, and ipv6_vip_virsubnet_id cannot be left blank at the same time. The subnet specified by vip_subnet_cidr_id and the subnet specified by ipv6_vip_virsubnet_id must be in the VPC specified by vpc_id. The ID must be in UUID format and can contain up to 36 characters. |
availability_zone_list |
Yes |
Array of strings |
Specifies the list of AZs where the load balancer can be created. You can query the AZs by calling the API (GET https://{ELB_Endpoint}/v3/{project_id}/elb/availability-zones). Select one or more AZs in the same set. Note: If disaster recovery is required, you are advised to select multiple AZs. |
enterprise_project_id |
No |
String |
Specifies the ID of the enterprise project that the load balancer belongs to. The value cannot be "", "0", or the ID of an enterprise project that does not exist. If this parameter is not passed during resource creation, the resource belongs to the default enterprise project, and 0 will be returned. |
tags |
No |
Array of Tag objects |
Lists the tags added to the load balancer. Example: "tags":[{"key":"my_tag","value":"my_tag_value"}] |
admin_state_up |
No |
Boolean |
Specifies whether the load balancer is enabled. The value can be:
|
ipv6_bandwidth |
No |
BandwidthRef object |
Specifies the ID of the bandwidth used by an IPv6 address. Notes and constraints:
|
publicip_ids |
No |
Array of strings |
Specifies the IDs of the EIP the system will automatically assign and bind to the load balancer during load balancer creation. Notes and constraints:
|
publicip |
No |
Specifies the new EIP that will be bound to the load balancer. |
|
elb_virsubnet_ids |
No |
Array of strings |
Specifies the IDs of subnets where the load balancers work. You can query parameter neutron_network_id in the response by calling the API (GET https://{VPC_Endpoint}/v1/{project_id}/subnets?vpc_id=xxxx). A load balancer uses IP addresses in such subnets to communicate with backend servers (such as in health check, and FullNAT scenarios). Notes and constraints:
|
ip_target_enable |
No |
Boolean |
Specifies whether to add backend servers that are not in the load balancer's VPC. If you enable this function, you can add servers in a peer VPC connected through a VPC peering connection, or in an on-premises data center at the other end of a Direct Connect or VPN connection, by using their IP addresses. The value can be true (IP as a Backend enabled) or false (IP as a Backend disabled). Notes and constraints:
|
deletion_protection_enable |
No |
Boolean |
Specifies whether to enable deletion protection for the load balancer.
NOTE:
Disable deletion protection before deleting your resources. |
autoscaling |
No |
Specifies information about elastic scaling. If elastic scaling is enabled, the load balancer specifications can be automatically adjusted based on incoming traffic. Notes and constraints:
|
|
protection_status |
No |
String |
Specifies the protection status. This parameter is used to prevent resources from being modified by accident on the console. If this parameter is set to consoleProtection, you cannot modify resource settings on the console. But you can call APIs to modify resource settings, such as resource tags. The value can be:
|
protection_reason |
No |
String |
Specifies why the modification protection function is enabled.
NOTE:
This parameter is valid only when protection_status is set to consoleProtection. |
charge_mode |
No |
String |
Specifies the charge mode when creating a load balancer. The value can be one of the following:
Notes and constraints:
|
ipv6_vip_address |
No |
String |
Specifies the IPv6 address bound to the load balancer. Notes and constraints:
|
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
key |
No |
String |
Specifies the tag key. |
value |
No |
String |
Specifies the tag value. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
id |
Yes |
String |
Specifies the shared bandwidth ID. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
ip_version |
No |
Integer |
Specifies the IP address version. The value can be 4 (IPv4) or 6 (IPv6). The default value is 4. |
network_type |
Yes |
String |
Specifies the EIP type. The default value is 5_bgp. For more information, see the API for assigning an EIP in the Virtual Private Cloud API Reference. |
billing_info |
No |
String |
Provides billing information about the EIP. |
description |
No |
String |
Provides supplementary information about the EIP. |
bandwidth |
Yes |
Provides supplementary information about the bandwidth. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
name |
No |
String |
Specifies the bandwidth name. The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods. Note:
|
size |
No |
Integer |
Specifies the bandwidth range. The default bandwidth range is 1 Mbit/s to 2,000 Mbit/s, which may vary by region and can be viewed on the management console. Notes and constraints:
|
charge_mode |
No |
String |
Specifies how the bandwidth used by the EIP is billed.
This parameter is mandatory if id is set to null. |
share_type |
No |
String |
Specifies the bandwidth type. The value can be:
Notes and constraints:
|
billing_info |
No |
String |
Specifies bandwidth billing information. If this billing_info is left blank, the bandwidth is billed in the pay-per-use mode. |
id |
No |
String |
Specifies the ID of the shared bandwidth to which the IP address bound to the load balancer is added. Note:
|
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
enable |
Yes |
Boolean |
Specifies whether to enable elastic scaling for the load balancer. The value can be true (elastic scaling enabled) or false (elastic scaling disabled). |
min_l7_flavor_id |
No |
String |
Specifies the ID of the minimum Layer-7 flavor for elastic scaling. This parameter cannot be left blank if there are HTTP or HTTPS listeners. This parameter is no longer used, but it is still supported for compatibility reasons. Please do not use this parameter. |
Response Parameters
Status code: 201
Parameter |
Type |
Description |
---|---|---|
loadbalancer |
LoadBalancer object |
Specifies the load balancer. |
loadbalancer_id |
String |
Specifies the load balancer ID. |
order_id |
String |
Specifies the order No. |
request_id |
String |
Specifies the request ID. Note: The value is automatically generated. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Specifies the load balancer ID. |
description |
String |
Provides supplementary information about the load balancer. |
provisioning_status |
String |
Specifies the provisioning status of the load balancer. The value can be:
|
admin_state_up |
Boolean |
Specifies whether the load balancer is enabled. The value can be:
|
provider |
String |
Specifies the provider of the load balancer. The value can only be vlb. |
pools |
Array of PoolRef objects |
Lists the IDs of backend server groups associated with the load balancer. |
listeners |
Array of ListenerRef objects |
Lists the IDs of listeners added to the load balancer. |
operating_status |
String |
Specifies the operating status of the load balancer. The value can be:
|
name |
String |
Specifies the load balancer name. |
project_id |
String |
Specifies the project ID of the load balancer. |
vip_subnet_cidr_id |
String |
Specifies the ID of the frontend IPv4 subnet where the load balancer resides. |
vip_address |
String |
Specifies the private IPv4 address bound to the load balancer. |
vip_port_id |
String |
Specifies the ID of the port bound to the private IPv4 address of the load balancer. |
tags |
Array of Tag objects |
Lists the tags added to the load balancer. |
created_at |
String |
Specifies the time when the load balancer was created, in the format of yyyy-MM-dd''T''HH:mm:ss''Z''. |
updated_at |
String |
Specifies the time when the load balancer was updated, in the format of yyyy-MM-dd''T''HH:mm:ss''Z''. |
guaranteed |
Boolean |
Specifies whether the load balancer is a dedicated load balancer.
|
vpc_id |
String |
Specifies the ID of the VPC where the load balancer resides. |
eips |
Array of EipInfo objects |
Specifies the EIP bound to the load balancer. Only one EIP can be bound to a load balancer. This parameter has the same meaning as publicips. |
ipv6_vip_address |
String |
Specifies the IPv6 address bound to the load balancer. |
ipv6_vip_virsubnet_id |
String |
Specifies the ID of the IPv6 subnet where the load balancer resides. |
ipv6_vip_port_id |
String |
Specifies the ID of the port bound to the IPv6 address of the load balancer. |
availability_zone_list |
Array of strings |
Specifies the list of AZs where the load balancer is created. |
enterprise_project_id |
String |
Specifies the enterprise project ID. If this parameter is not passed during resource creation, "0" will be returned, and the resource belongs to the default enterprise project. "0" is not a valid enterprise project ID and cannot be used in the APIs for creating, updating the load balancer, or querying details of the load balancer. |
billing_info |
String |
Provides resource billing information.
|
l4_flavor_id |
String |
Specifies the ID of a flavor at Layer 4. l4_flavor_id defines the indicates maximum Layer 4 flavor for elastic scaling. Notes and constraints:
|
l4_scale_flavor_id |
String |
Specifies the ID of the reserved flavor at Layer 4. This parameter is unsupported. Please do not use it. |
l7_flavor_id |
String |
Specifies the ID of a flavor at Layer 7. l7_flavor_id defines the indicates maximum Layer 7 flavor for elastic scaling. Notes and constraints:
|
l7_scale_flavor_id |
String |
Specifies the ID of the reserved flavor at Layer 7. This parameter is unsupported. Please do not use it. |
publicips |
Array of PublicIpInfo objects |
Specifies the EIP bound to the load balancer. Only one EIP can be bound to a load balancer. This parameter has the same meaning as eips. |
global_eips |
Array of GlobalEipInfo objects |
Specifies the global EIP bound to the load balancer. Only the first global EIP specified under global_eips will be bound. |
elb_virsubnet_ids |
Array of strings |
Lists the IDs of subnets on the downstream plane. |
elb_virsubnet_type |
String |
Specifies the type of the subnet on the downstream plane. The value can be:
|
ip_target_enable |
Boolean |
Specifies whether to add backend servers that are not in the load balancer's VPC. If you enable this function, you can add servers in a peer VPC connected through a VPC peering connection, or in an on-premises data center at the other end of a Direct Connect or VPN connection, by using their IP addresses. The value can be true (IP as a Backend enabled) or false (IP as a Backend disabled). Notes and constraints:
|
frozen_scene |
String |
Specifies the scenario where the load balancer is frozen. Multiple values are separated using commas (,). The value can be:
|
ipv6_bandwidth |
BandwidthRef object |
Specifies the ID of the bandwidth used by an IPv6 address. Notes and constraints:
|
deletion_protection_enable |
Boolean |
Specifies whether to enable removal protection for the load balancer. The value can be:
Notes and constraints:
|
autoscaling |
AutoscalingRef object |
Specifies information about elastic scaling. If elastic scaling is enabled, the load balancer specifications can be automatically adjusted based on incoming traffic. Notes and constraints:
|
public_border_group |
String |
Specifies the AZ group to which the load balancer belongs. |
charge_mode |
String |
Specifies the charge mode when creating a load balancer. The value can be one of the following:
Notes and constraints:
|
waf_failure_action |
String |
Specifies traffic distributing policies when the WAF is faulty. The value can be:
Notes and constraints: This parameter takes effect only when WAF is enabled for the load balancer. This parameter is unsupported. Please do not use it. |
protection_status |
String |
Specifies the protection status. The value can be:
|
protection_reason |
String |
Specifies why the modification protection function is enabled. Notes and constraints: This parameter is valid only when protection_status is set to consoleProtection. |
log_group_id |
String |
Specifies the ID of the log group that is associated with the load balancer. |
log_topic_id |
String |
Specifies the ID of the log topic that is associated with the load balancer. |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Specifies the tag key. |
value |
String |
Specifies the tag value. |
Parameter |
Type |
Description |
---|---|---|
eip_id |
String |
eip_id |
eip_address |
String |
eip_address |
ip_version |
Integer |
Specifies the IP version. 4 indicates IPv4, and 6 indicates IPv6. |
Parameter |
Type |
Description |
---|---|---|
publicip_id |
String |
Specifies the EIP ID. |
publicip_address |
String |
Specifies the IP address. |
ip_version |
Integer |
Specifies the IP version. The value can be 4 (IPv4) or 6 (IPv6). |
Parameter |
Type |
Description |
---|---|---|
global_eip_id |
String |
Specifies the ID of the global EIP. |
global_eip_address |
String |
Specifies the global EIP. |
ip_version |
Integer |
Specifies the IP version. The value can be 4 (IPv4) or 6 (IPv6). |
Parameter |
Type |
Description |
---|---|---|
enable |
Boolean |
Specifies whether to enable elastic scaling for the load balancer. The value can be:
|
min_l7_flavor_id |
String |
Specifies the ID of the minimum Layer-7 flavor for elastic scaling. Notes and constraints:
|
Example Requests
-
Example 1: Creating a load balancer with a private IPv4 address
POST https://{ELB_Endponit}/v3/060576798a80d5762fafc01a9b5eedc7/elb/loadbalancers { "loadbalancer" : { "name" : "loadbalancer", "description" : "simple lb", "vip_subnet_cidr_id" : "1992ec06-f364-4ae3-b936-6a8cc24633b7", "admin_state_up" : true, "availability_zone_list" : [ "AZ1" ] } }
-
Example 2: Creating a load balancer with an IPv4 EIP
POST https://{ELB_Endponit}/v3/060576782980d5762f9ec014dd2f1148/elb/loadbalancers { "loadbalancer" : { "vip_subnet_cidr_id" : "e6e9271d-aef4-48f0-a93a-ccc7b09032c1", "availability_zone_list" : [ "AZ1" ], "admin_state_up" : true, "publicip" : { "network_type" : "5_bgp", "bandwidth" : { "size" : 2, "share_type" : "PER", "charge_mode" : "bandwidth", "name" : "bandwidth_test" } }, "name" : "elb_eip-test" } }
-
Example 3: Creating a gateway load balancer
POST https://{ELB_Endponit}/v3/060576798a80d5762fafc01a9b5eedc7/elb/loadbalancers { "loadbalancer" : { "name" : "loadbalancer", "description" : "simple gateway lb", "loadbalancer_type" : "gateway", "gw_flavor_id" : "2e859438-7cbb-417b-8f3b-5f618ca76a52", "vip_subnet_cidr_id" : "1992ec06-f364-4ae3-b936-6a8cc24633b7", "ipv6_vip_virsubnet_id" : "8e7aac33-0d87-4cb2-9cce-2856615d607f", "admin_state_up" : true, "availability_zone_list" : [ "AZ1" ] } }
Example Responses
Status code: 201
Normal response to POST requests.
{ "loadbalancer" : { "name" : "my_loadbalancer", "id" : "29cc669b-3ac8-4498-9094-bdf6193425c2", "project_id" : "060576798a80d5762fafc01a9b5eedc7", "description" : "", "vip_port_id" : "98697944-0cc7-4d3b-a829-001c2fb82232", "vip_address" : "192.168.0.214", "admin_state_up" : true, "provisioning_status" : "ACTIVE", "operating_status" : "ONLINE", "listeners" : [ ], "pools" : [ ], "tags" : [ { "key" : "tab_key", "value" : "tag1" } ], "provider" : "vlb", "created_at" : "2023-03-22T07:59:57Z", "updated_at" : "2023-03-22T07:59:59Z", "vpc_id" : "a1f33a4c-95b9-48a7-9350-684e2ed844b3", "enterprise_project_id" : "134f2181-5720-47e7-bd78-1356ed3737d6", "availability_zone_list" : [ ], "ipv6_vip_address" : null, "ipv6_vip_virsubnet_id" : null, "ipv6_vip_port_id" : null, "publicips" : [ { "publicip_id" : "3388574a-4f6f-4471-869e-97d74d21eee9", "publicip_address" : "88.88.87.205", "ip_version" : 4 } ], "global_eips" : [ ], "elb_virsubnet_ids" : [ ], "elb_virsubnet_type" : null, "ip_target_enable" : false, "autoscaling" : { "enable" : false, "min_l7_flavor_id" : "" }, "frozen_scene" : null, "public_border_group" : "center", "eips" : [ { "eip_id" : "3388574a-4f6f-4471-869e-97d74d21eee9", "eip_address" : "88.88.87.205", "ip_version" : 4 } ], "guaranteed" : false, "billing_info" : null, "l4_flavor_id" : null, "l4_scale_flavor_id" : null, "l7_flavor_id" : null, "l7_scale_flavor_id" : null, "waf_failure_action" : "", "vip_subnet_cidr_id" : "abf31f3b-706e-4e55-a6dc-f2fcc707fd3a" }, "request_id" : "bf29597181cb81b30d19f1a0115a157d" }
SDK Sample Code
The SDK sample code is as follows.
-
Example 1: Creating a load balancer with a private IPv4 address
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.elb.v3.region.ElbRegion; import com.huaweicloud.sdk.elb.v3.*; import com.huaweicloud.sdk.elb.v3.model.*; import java.util.List; import java.util.ArrayList; public class CreateLoadBalancerSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); ElbClient client = ElbClient.newBuilder() .withCredential(auth) .withRegion(ElbRegion.valueOf("<YOUR REGION>")) .build(); CreateLoadBalancerRequest request = new CreateLoadBalancerRequest(); CreateLoadBalancerRequestBody body = new CreateLoadBalancerRequestBody(); List<String> listLoadbalancerAvailabilityZoneList = new ArrayList<>(); listLoadbalancerAvailabilityZoneList.add("AZ1"); CreateLoadBalancerOption loadbalancerbody = new CreateLoadBalancerOption(); loadbalancerbody.withName("loadbalancer") .withDescription("simple lb") .withVipSubnetCidrId("1992ec06-f364-4ae3-b936-6a8cc24633b7") .withAvailabilityZoneList(listLoadbalancerAvailabilityZoneList) .withAdminStateUp(true); body.withLoadbalancer(loadbalancerbody); request.withBody(body); try { CreateLoadBalancerResponse response = client.createLoadBalancer(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } }
-
Example 2: Creating a load balancer with an IPv4 EIP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.elb.v3.region.ElbRegion; import com.huaweicloud.sdk.elb.v3.*; import com.huaweicloud.sdk.elb.v3.model.*; import java.util.List; import java.util.ArrayList; public class CreateLoadBalancerSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); ElbClient client = ElbClient.newBuilder() .withCredential(auth) .withRegion(ElbRegion.valueOf("<YOUR REGION>")) .build(); CreateLoadBalancerRequest request = new CreateLoadBalancerRequest(); CreateLoadBalancerRequestBody body = new CreateLoadBalancerRequestBody(); CreateLoadBalancerBandwidthOption bandwidthPublicip = new CreateLoadBalancerBandwidthOption(); bandwidthPublicip.withName("bandwidth_test") .withSize(2) .withChargeMode(CreateLoadBalancerBandwidthOption.ChargeModeEnum.fromValue("bandwidth")) .withShareType(CreateLoadBalancerBandwidthOption.ShareTypeEnum.fromValue("PER")); CreateLoadBalancerPublicIpOption publicipLoadbalancer = new CreateLoadBalancerPublicIpOption(); publicipLoadbalancer.withNetworkType("5_bgp") .withBandwidth(bandwidthPublicip); List<String> listLoadbalancerAvailabilityZoneList = new ArrayList<>(); listLoadbalancerAvailabilityZoneList.add("AZ1"); CreateLoadBalancerOption loadbalancerbody = new CreateLoadBalancerOption(); loadbalancerbody.withName("elb_eip-test") .withVipSubnetCidrId("e6e9271d-aef4-48f0-a93a-ccc7b09032c1") .withAvailabilityZoneList(listLoadbalancerAvailabilityZoneList) .withAdminStateUp(true) .withPublicip(publicipLoadbalancer); body.withLoadbalancer(loadbalancerbody); request.withBody(body); try { CreateLoadBalancerResponse response = client.createLoadBalancer(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } }
-
Example 3: Creating a gateway load balancer
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.elb.v3.region.ElbRegion; import com.huaweicloud.sdk.elb.v3.*; import com.huaweicloud.sdk.elb.v3.model.*; import java.util.List; import java.util.ArrayList; public class CreateLoadBalancerSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); ElbClient client = ElbClient.newBuilder() .withCredential(auth) .withRegion(ElbRegion.valueOf("<YOUR REGION>")) .build(); CreateLoadBalancerRequest request = new CreateLoadBalancerRequest(); CreateLoadBalancerRequestBody body = new CreateLoadBalancerRequestBody(); List<String> listLoadbalancerAvailabilityZoneList = new ArrayList<>(); listLoadbalancerAvailabilityZoneList.add("AZ1"); CreateLoadBalancerOption loadbalancerbody = new CreateLoadBalancerOption(); loadbalancerbody.withName("loadbalancer") .withDescription("simple gateway lb") .withVipSubnetCidrId("1992ec06-f364-4ae3-b936-6a8cc24633b7") .withIpv6VipVirsubnetId("8e7aac33-0d87-4cb2-9cce-2856615d607f") .withAvailabilityZoneList(listLoadbalancerAvailabilityZoneList) .withAdminStateUp(true); body.withLoadbalancer(loadbalancerbody); request.withBody(body); try { CreateLoadBalancerResponse response = client.createLoadBalancer(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } }
-
Example 1: Creating a load balancer with a private IPv4 address
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
# coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkelb.v3.region.elb_region import ElbRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkelb.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = ElbClient.new_builder() \ .with_credentials(credentials) \ .with_region(ElbRegion.value_of("<YOUR REGION>")) \ .build() try: request = CreateLoadBalancerRequest() listAvailabilityZoneListLoadbalancer = [ "AZ1" ] loadbalancerbody = CreateLoadBalancerOption( name="loadbalancer", description="simple lb", vip_subnet_cidr_id="1992ec06-f364-4ae3-b936-6a8cc24633b7", availability_zone_list=listAvailabilityZoneListLoadbalancer, admin_state_up=True ) request.body = CreateLoadBalancerRequestBody( loadbalancer=loadbalancerbody ) response = client.create_load_balancer(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)
-
Example 2: Creating a load balancer with an IPv4 EIP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
# coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkelb.v3.region.elb_region import ElbRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkelb.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = ElbClient.new_builder() \ .with_credentials(credentials) \ .with_region(ElbRegion.value_of("<YOUR REGION>")) \ .build() try: request = CreateLoadBalancerRequest() bandwidthPublicip = CreateLoadBalancerBandwidthOption( name="bandwidth_test", size=2, charge_mode="bandwidth", share_type="PER" ) publicipLoadbalancer = CreateLoadBalancerPublicIpOption( network_type="5_bgp", bandwidth=bandwidthPublicip ) listAvailabilityZoneListLoadbalancer = [ "AZ1" ] loadbalancerbody = CreateLoadBalancerOption( name="elb_eip-test", vip_subnet_cidr_id="e6e9271d-aef4-48f0-a93a-ccc7b09032c1", availability_zone_list=listAvailabilityZoneListLoadbalancer, admin_state_up=True, publicip=publicipLoadbalancer ) request.body = CreateLoadBalancerRequestBody( loadbalancer=loadbalancerbody ) response = client.create_load_balancer(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)
-
Example 3: Creating a gateway load balancer
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
# coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkelb.v3.region.elb_region import ElbRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkelb.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = ElbClient.new_builder() \ .with_credentials(credentials) \ .with_region(ElbRegion.value_of("<YOUR REGION>")) \ .build() try: request = CreateLoadBalancerRequest() listAvailabilityZoneListLoadbalancer = [ "AZ1" ] loadbalancerbody = CreateLoadBalancerOption( name="loadbalancer", description="simple gateway lb", vip_subnet_cidr_id="1992ec06-f364-4ae3-b936-6a8cc24633b7", ipv6_vip_virsubnet_id="8e7aac33-0d87-4cb2-9cce-2856615d607f", availability_zone_list=listAvailabilityZoneListLoadbalancer, admin_state_up=True ) request.body = CreateLoadBalancerRequestBody( loadbalancer=loadbalancerbody ) response = client.create_load_balancer(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)
-
Example 1: Creating a load balancer with a private IPv4 address
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" elb "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() client := elb.NewElbClient( elb.ElbClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.CreateLoadBalancerRequest{} var listAvailabilityZoneListLoadbalancer = []string{ "AZ1", } nameLoadbalancer:= "loadbalancer" descriptionLoadbalancer:= "simple lb" vipSubnetCidrIdLoadbalancer:= "1992ec06-f364-4ae3-b936-6a8cc24633b7" adminStateUpLoadbalancer:= true loadbalancerbody := &model.CreateLoadBalancerOption{ Name: &nameLoadbalancer, Description: &descriptionLoadbalancer, VipSubnetCidrId: &vipSubnetCidrIdLoadbalancer, AvailabilityZoneList: listAvailabilityZoneListLoadbalancer, AdminStateUp: &adminStateUpLoadbalancer, } request.Body = &model.CreateLoadBalancerRequestBody{ Loadbalancer: loadbalancerbody, } response, err := client.CreateLoadBalancer(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } }
-
Example 2: Creating a load balancer with an IPv4 EIP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" elb "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() client := elb.NewElbClient( elb.ElbClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.CreateLoadBalancerRequest{} nameBandwidth:= "bandwidth_test" sizeBandwidth:= int32(2) chargeModeBandwidth:= model.GetCreateLoadBalancerBandwidthOptionChargeModeEnum().BANDWIDTH shareTypeBandwidth:= model.GetCreateLoadBalancerBandwidthOptionShareTypeEnum().PER bandwidthPublicip := &model.CreateLoadBalancerBandwidthOption{ Name: &nameBandwidth, Size: &sizeBandwidth, ChargeMode: &chargeModeBandwidth, ShareType: &shareTypeBandwidth, } publicipLoadbalancer := &model.CreateLoadBalancerPublicIpOption{ NetworkType: "5_bgp", Bandwidth: bandwidthPublicip, } var listAvailabilityZoneListLoadbalancer = []string{ "AZ1", } nameLoadbalancer:= "elb_eip-test" vipSubnetCidrIdLoadbalancer:= "e6e9271d-aef4-48f0-a93a-ccc7b09032c1" adminStateUpLoadbalancer:= true loadbalancerbody := &model.CreateLoadBalancerOption{ Name: &nameLoadbalancer, VipSubnetCidrId: &vipSubnetCidrIdLoadbalancer, AvailabilityZoneList: listAvailabilityZoneListLoadbalancer, AdminStateUp: &adminStateUpLoadbalancer, Publicip: publicipLoadbalancer, } request.Body = &model.CreateLoadBalancerRequestBody{ Loadbalancer: loadbalancerbody, } response, err := client.CreateLoadBalancer(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } }
-
Example 3: Creating a gateway load balancer
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" elb "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() client := elb.NewElbClient( elb.ElbClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.CreateLoadBalancerRequest{} var listAvailabilityZoneListLoadbalancer = []string{ "AZ1", } nameLoadbalancer:= "loadbalancer" descriptionLoadbalancer:= "simple gateway lb" vipSubnetCidrIdLoadbalancer:= "1992ec06-f364-4ae3-b936-6a8cc24633b7" ipv6VipVirsubnetIdLoadbalancer:= "8e7aac33-0d87-4cb2-9cce-2856615d607f" adminStateUpLoadbalancer:= true loadbalancerbody := &model.CreateLoadBalancerOption{ Name: &nameLoadbalancer, Description: &descriptionLoadbalancer, VipSubnetCidrId: &vipSubnetCidrIdLoadbalancer, Ipv6VipVirsubnetId: &ipv6VipVirsubnetIdLoadbalancer, AvailabilityZoneList: listAvailabilityZoneListLoadbalancer, AdminStateUp: &adminStateUpLoadbalancer, } request.Body = &model.CreateLoadBalancerRequestBody{ Loadbalancer: loadbalancerbody, } response, err := client.CreateLoadBalancer(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } }
For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.
Status Codes
Status Code |
Description |
---|---|
201 |
Normal response to POST requests. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot