创建实例
更新时间：2026-07-15
描述
- 创建一个LoadBalancer，返回分配的服务地址及实例ID。
- 付费方式为后付费。
- 需要实名认证，若未通过实名认证可以前往百度智能云官网控制台中的安全认证下的实名认证中进行认证。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Text
1POST /v{version}/blb?clientToken={clientToken} HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "name": name,
7 "desc": desc,
8 "vpcId": vpcId,
9 "subnetId": subnetId,
10 "address": address,
11 "type": type,
12 "eip":eip,
13 "tags":[
14 {
15 "tagKey": tagKey,
16 "tagValue": tagValue
17 }
18 ]
19}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clientToken | String | 否 | Query参数 | 幂等性Token，长度不超过64位 |
| name | String | 否 | RequestBody参数 | LoadBalancer的名称，方便记忆。长度1~65个字节，字母开头，可包含字母数字-_/.字符。若不传该参数，会自动生成 |
| desc | String | 否 | RequestBody参数 | LoadBalancer实例的描述，便于用户添加更详细的描述信息。长度0~450个字节，支持中文，默认为空 |
| vpcId | String | 是 | RequestBody参数 | LoadBalancer实例所属VPC的ID |
| subnetId | String | 是 | RequestBody参数 | LoadBalancer实例所属子网的ID |
| address | String | 否 | RequestBody参数 | 指定负载均衡实例的私网IP地址，该地址必须包含在子网网段下。 |
| type | String | 否 | RequestBody参数 | 指定负载均衡实例的类型，不传默认为普通型，传"ipv6"代表创建ipv6类型的BLB。 |
| eip | String | 否 | RequestBody参数 | 绑定已有的eip。取值为eip的IP地址。 |
| tags | List<TagModel> | 否 | RequestBody参数 | 待创建的标签键值对列表 |
| billing | BillingForCreate | 否 | RequestBody参数 | 订单相关信息，购买预付费blb的时候必填 |
| performanceLevel | String | 否 | RequestBody参数 | 性能规格参数，默认为共享型。取值如下："small1"标准型1，"small2"标准型2，"medium1"增强型1，"medium2"增强型1，"large1"超大型1，"large2"超大型2，"large3"超大型3,如果是后付费按使用量计费的时候还可以传"unlimited"不限速 |
| autoRenewLength | int | 否 | RequestBody参数 | 支持创建预付费BLB同时开通自动续费，根据autoRenewTimeUnit的取值有不同的范围，month 为1到9，year 为1到3 |
| autoRenewTimeUnit | String | 否 | RequestBody参数 | 支持创建BLB同时开通自动续费，取值为 month 获 year （默认 month） |
| resourceGroupId | String | 否 | RequestBody参数 | 支持创建BLB同时绑定资源分组id |
| allowDelete | Boolean | 否 | RequestBody参数 | 是否允许删除。缺省值为true，代表允许删除 |
| allowModify | Boolean | 否 | RequestBody参数 | 默认true,表示关闭修改保护，允许通过控制台对实例进行变更。传递false表示开启修改保护，禁止通过控制台对实例进行变更（注意:OpenAPI调用不受限制） |
| modificationProtectionReason | String | 否 | RequestBody参数 | 不允许修改的原因,最多支持128个字符 |
| allocateIpv6 | Boolean | 否 | RequestBody参数 | 是否分配ipv6地址。true代表分配ipv6地址，false代表不分配ipv6地址 |
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| address | string | 分配的内网服务地址IP，通过这个IP即能通过内网访问该实例 |
| name | string | LoadBalancer的名称 |
| blbId | string | LoadBalancer的ID。后续针对该实例的操作，均需要在请求中带上此ID |
| desc | string | LoadBalancer的描述 |
请求示例
Text
1POST /v1/blb?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST blb.bj.baidubce.com
3Authorization: authorization string
4
5// 创建后付费blb实例
6{
7 "name":"blb-for-test",
8 "desc": "myblb",
9 "vpcId": "vpc-fy6vdykpwkqb",
10 "subnetId": "sbn-a34td0pxcucd",
11 "address": "192.168.0.24",
12 "eip": "100.88.8.139"
13}
14
15// 创建预付费blb实例
16{
17 "vpcId":"vpc-fbsxgfs9ty60",
18 "subnetId":"sbn-3317rkjfq8j9",
19 "name":"ccq20240223_ccq",
20 "billing": {
21 "paymentTiming":"Prepaid",
22 "reservation": {
23 "reservationLength":2
24 }
25 },
26 "performanceLevel":"small1"
27}响应示例
Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "blbId": "lb-BLuOPSLZ",
10 "name": "blb-for-test",
11 "address": "192.168.0.24",
12 "desc": "myblb"
13}评价此篇文章