Create a LoadBalancer and return the allocated service address and instance ID.
Billing type: Postpay.
Certification is required. Those who have not passed certification can go to the certification under security certification in the Baidu Open Cloud Official Website Console for certification.
Idempotency Token, with length no more than 64 characters.
name
String
No
RequestBody
Name of LoadBalancer for easy memorization. Length: 1 – 65 bytes, starting with a letter. It can contain letters, numbers and the characters -_/. If this parameter is not specified, it will be generated automatically.
type
String
No
RequestBody
The type of LoadBalancer, with the value of "application" (by default) in this case
desc
String
No
RequestBody
Provide a description for the LoadBalancer instance with a length of 0 to 450 bytes. It supports Chinese and is empty by default.
subnetId
String
Yes
RequestBody
Subnet to which the LoadBalancer instance belongs
vpcId
String
Yes
RequestBody
vpcShortId of the VPC to which the LoadBalancer instance VIP belongs
address
String
No
RequestBody
Specify the private IP address of the LoadBalancer instance, ensuring it falls within the subnet's network range.
eip
String
No
RequestBody
Bind an existing EIP. The value should be the IP address linked to the EIP.
Order-related information. It is required when the prepaid BLB is purchased.
performanceLevel
String
No
RequestBody
Performance specification parameter. By default, it is of the shared type. The acceptable values are: "small1" for Standard 1, "small2" for Standard 2, "medium1" for Enhanced 1, "medium2" for Enhanced 2, "large1" for Extra Large 1, "large2" for Extra Large 2, and "large3" for Extra Large 3. If the postpay mode is set to pay-as-you-go, "unlimited" can also be used to allow unlimited speed.
autoRenewLength
int
No
RequestBody
Support creating prepaid BLB with auto-renewal enabled. It value ranges vary by autoRenewTimeUnit, with 1-9 for month and 1-3 for year.
autoRenewTimeUnit
String
No
RequestBody
Support enabling auto-renewal when creating BLB, with values being month or year (month by default)
resourceGroupId
String
No
RequestBody
Support binding resource group ID when creating BLB
allowDelete
Boolean
No
RequestBody
Indicate whether deletion is allowed. The default value is true, meaning deletion is permitted.
allocateIpv6
Boolean
No
RequestBody
Specify whether to allocate an IPv6 address. A value of true allocates an IPv6 address, while false does not.
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
Parameter name
Types
Description
address
String
Assigned server IP address, through which the instance can be accessed.
name
String
LoadBalancer name
desc
String
LoadBalancer description
blbId
String
Provide the LoadBalancer ID, which is required for subsequent operations on this instance.
Idempotency Token, with length no more than 64 characters.
name
String
No
RequestBody
Name of LoadBalancer for easy memorization. Length: 1 – 65 bytes, starting with a letter. It can contain letters, numbers and the characters -_/. If this parameter is not specified, it will be generated automatically.
desc
String
No
RequestBody
Provide a description for the LoadBalancer instance with a length of 0 to 450 bytes. It supports Chinese and is empty by default.
allowDelete
Boolean
No
RequestBody
Indicate whether deletion is allowed. The default value is true, meaning deletion is permitted.
allocateIpv6
Boolean
No
RequestBody
Specify whether to allocate an IPv6 address. A value of true allocates an IPv6 address, while false does not.
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Address of the LoadBalancer to be queried, i.e. IP in dotted decimal format
name
String
No
Query
LoadBalancer name to be queried
blbId
String
No
Query
LoadBalancer ID to be queried (only exact query supported)
bccId
String
No
Query
LoadBalancer bound to this BCC (only exact query supported)
exactlyMatch
boolean
No
Query
Set the query match type: true for exact match and false for fuzzy match. The default value is false.
marker
String
No
Query
The starting position of the batch list query is a system-generated string
maxKeys
int
No
Query
Maximum number of items per page is 1,000, with a default value of 1000.
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
The identifier of the LoadBalancer to be queried (the complete blbId must be entered)
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Payment time: Prepaid or Postpaid. Currently, only Prepaid is supported.
paymentTiming
String
Charge type: "ByCapacityUnit" for pay-as-you-go mode, and "BySpec" for fixed specification mode.
performanceLevel
String
Performance specifications." "small1" Standard 1, "small2" Standard 2, "medium1" Enhance 1, "medium2" Enhance 1, "large1" Extra Large 1, "large2" Extra Large 2, and "large3" Extra Large 3.
expireTime
String
Expiration time of prepay instance
eipRouteType
String
EIP Internet connection type
publicIpv6
String
This item is displayed if the Load Balancer is bound to an EIPv6; otherwise, it is not displayed
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)