- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- API版本选择建议
- 如何调用API
- API(V3)
- API(V2)
- API(OpenStack API)
- 应用示例
- 权限和授权项
- 历史API
- 附录
- SDK参考
- 常见问题
- 视频帮助
- 产品术语
-
更多文档
- 用户指南(阿布扎比区域)
- API参考(阿布扎比区域)
-
用户指南 (巴黎区域)
- 产品介绍
- 快速入门
- 负载均衡器
- 监听器
- HTTP/HTTPS监听器高级配置
- 后端服务器组
- 后端服务器(独享型)
- 后端服务器(共享型)
- 证书管理
- 访问控制管理
- TLS安全策略
- 标签管理
- 访问日志
- 监控
- 审计
- 权限管理
- 关于配额
-
常见问题
- 高频常见问题
- 为什么通过负载均衡无法访问后端业务?
- 如何检查弹性负载均衡服务不通或异常中断?
- 如何排查ELB的异常返回码?
- 弹性负载均衡器是否可以单独使用?
- ELB是否支持TCP长连接?
- 弹性负载均衡是否支持后端FTP服务?
- 弹性负载均衡分配的EIP是否为独占?
- 单个用户默认可以创建多少个负载均衡器或监听器?
- ELB权限和使用范围是什么?
- 当负载均衡器正在运行中是否可以调整后端服务器的数量?
- 弹性负载均衡是否可以添加不同操作系统的服务器?
- ELB添加后端的端口号是否可以不一致?
- ELB支持跨用户、跨VPC使用么?
- 负载均衡器的后端服务器可以反过来访问公网/私网负载均衡器上的端口吗?
- ELB能否实现前端是HTTPS协议,后端也是HTTPS协议?
- ELB所属的VPC和子网支持修改吗?
- 是否支持在业务不中断的前提下,将共享型负载均衡升级为独享型负载均衡?
- ELB对于IPv6网络的支持情况是怎样的?
- 如何检查弹性负载均衡前后端流量不一致?
- 如何检查请求不均衡?
- 如何检查弹性负载均衡业务访问延时大?
- 如何检查压测性能上不去?
- 负载均衡器
- 监听器
-
后端服务器
- 为什么后端服务器上收到的健康检查报文间隔和设置的间隔时间不一致?
- 使用ELB后,后端服务器能否访问公网?
- 为什么100开头的IP在频繁访问后端服务器?
- ELB可以跨区域关联后端服务器么?
- 公网负载均衡的后端服务器要不要绑定EIP?
- 如何检查后端服务器网络状态?
- 如何检查后端服务器网络配置?
- 如何检查后端服务器服务状态?
- 后端服务器什么时候被认为是健康的?
- 如何检查通过EIP访问后端云服务器?
- 为什么云监控服务统计的ELB活跃连接数与后端服务器上的连接数不一致?
- 为什么配置了白名单后还能访问后端服务器?
- ELB修改后端服务器权重后多久生效?
- 为什么开启跨VPC后端需要确保负载均衡所属子网至少拥有16个可用IP地址?
- 健康检查
- 获取源IP
- HTTP/HTTPS监听器
- 会话保持
- 证书管理
- 监控
- 修订记录
- API参考 (巴黎区域)
- 用户指南(吉隆坡区域)
- API参考(吉隆坡区域)
- 用户指南(安卡拉区域)
- API参考(安卡拉区域)
- 通用参考
链接复制成功!
创建负载均衡器
功能介绍
创建私网类型的负载均衡器。创建成功后,该接口会返回创建的负载均衡器的ID、所属子网ID、负载均衡器内网IP等详细信息。
若要创建公网类型的负载均衡器,还需调用创建弹性IP的接口,将弹性IP与私网负载均衡器的vip_port_id绑定。
URI
POST /v2.0/lbaas/loadbalancers
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
loadbalancer |
是 |
Object |
负载均衡器对象。详见表2。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
负载均衡器名称。 支持的最大字符长度:255 |
description |
否 |
String |
负载均衡器的描述信息。 支持的最大字符长度:255 |
tenant_id |
否 |
String |
负载均衡器所在的项目ID。 支持的最大字符长度:255 需要和token中的project_id一致。 |
project_id |
否 |
String |
此参数和tenant_id参数含义一样,均指负载均衡器所在的项目ID。 需要和token中的project_id一致。 |
vip_subnet_id |
是 |
String |
负载均衡器所在的子网ID。可通过查询子网列表接口GET {vpc的endpoint}/v2.0/subnets获取。 vip_address将从该子网中产生。 只支持指定IPv4的子网ID。暂不支持IPv6。 |
provider |
否 |
String |
负载均衡器的生产者。 取值范围:vlb。 |
vip_address |
否 |
String |
负载均衡器的内网IP。 该IP必须为vip_subnet_id字段指定的子网网段中的IP。若不指定,自动从vip_subnet_id字段指定的子网网段中生成一个IP地址。 支持的最大字符长度:64 |
admin_state_up |
否 |
Boolean |
负载均衡器的管理状态。 该字段为预留字段,暂未启用。默认为true。 |
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
loadbalancer |
Object |
负载均衡器对象。详见表4。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
负载均衡器ID。 |
tenant_id |
String |
负载均衡器所在项目的ID。 支持的最大字符长度:255 |
name |
String |
负载均衡器名称。 支持的最大字符长度:255 |
description |
String |
负载均衡器的描述信息。 支持的最大字符长度:255 |
vip_subnet_id |
String |
负载均衡器所在子网的ID。 |
vip_port_id |
String |
负载均衡器内网IP对应的端口ID。 创建弹性负载均衡时,会自动为负载均衡创建一个port并关联一个默认的安全组,这个安全组对所有流量不生效。 |
provider |
String |
负载均衡器的生产者名称。 |
vip_address |
String |
负载均衡器的内网IP。 支持的最大字符长度:64 |
listeners |
Array |
负载均衡器关联监听器ID的列表。详见表5 |
pools |
Array |
负载均衡器关联后端服务器组ID的列表。详见表6 |
operating_status |
String |
负载均衡器的操作状态。取值范围:可以为ONLINE和FROZEN。 |
provisioning_status |
String |
该字段为预留字段,暂未启用。 负载均衡器的配置状态。取值范围:可以为ACTIVE。 |
admin_state_up |
Boolean |
负载均衡器的管理状态。 该字段为预留字段,暂未启用。取值范围:true/false。
|
tags |
Array |
负载均衡器的标签列表。 |
created_at |
String |
负载均衡器的创建时间。 格式为UTC时间:YYYY-MM-DDTHH:MM:SS 支持的最大字符长度:19 |
updated_at |
String |
负载均衡器的更新时间。 格式为UTC时间:YYYY-MM-DDTHH:MM:SS 支持的最大字符长度:19 |
请求示例
- 请求样例1 创建私网负载均衡器
POST https://{Endpoint}/v2.0/lbaas/loadbalancers { "loadbalancer": { "name": "loadbalancer1", "description": "simple lb", "tenant_id": "1867112d054b427e808cc6096d8193a1", "vip_subnet_id": "58077bdb-d470-424b-8c45-2e3c65060a5b", "vip_address": "192.168.0.100", "admin_state_up": true } }
- 请求样例2
在 请求样例1 创建私网负载均衡器的基础上,为私网负载均衡器的vip_port绑定弹性IP,具体参数说明参考表7。
表7 请求参数说明 参数
是否必选
参数类型
描述
publicip
是
Object
弹性IP对象,请参见表8。
bandwidth
是
Object
带宽对象,请参见表9。
enterprise_project_id
否
String
- 企业项目ID。最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。
- 创建弹性IP时,给弹性公网IP绑定企业项目ID。
- 不指定该参数时,默认值是 0
说明:
关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理用户指南》。
表8 publicip参数说明 参数
是否必选
参数类型
描述
type
是
String
- 功能说明:弹性IP的类型
- 约束:
- 必须是系统具体支持的类型
- publicip_id为IPv4端口,所以"publicip_type"字段未给定时,默认为5_bgp。
ip_version
否
Integer
- 功能说明:弹性IP的版本
- 取值范围:4、6,分别表示创建ipv4和ipv6
- 约束:
- 必须是系统具体支持的类型
- 不填或空字符串时,默认创建ipv4
ip_address
否
String
- 功能说明:希望申请到的弹性IP的地址,不指定时由系统自动分配
- 约束:必须为IPv4地址格式,且必须在可用地址池范围内
表9 bandwidth字段说明 参数
是否必选
参数类型
描述
name
是
String
- 功能说明:带宽名称
- 取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)
- 如果share_type是PER,该参数必须带,如果share_type是WHOLE并且id有值,该参数会忽略。
size
是
Integer
- 功能说明:带宽大小
- 取值范围:默认1Mbit/s~300Mbit/s(具体范围以各区域配置为准,请参见控制台对应页面显示)。
- 约束:share_type是PER,该参数必须带,如果share_type是WHOLE并且id有值,该参数会忽略。
- 注意:调整带宽时的最小单位会根据带宽范围不同存在差异。
- 小于等于300Mbit/s:默认最小单位为1Mbit/s。
- 300Mbit/s~1000Mbit/s:默认最小单位为50Mbit/s。
- 大于1000Mbit/s:默认最小单位为500Mbit/s。
id
否
String
- 功能说明:带宽ID,创建弹性IP时可以指定已有的共享带宽
- 取值范围:共享(WHOLE类型)带宽ID
share_type
是
String
- 功能说明:带宽类型
- 取值为PER,表示独享带宽
charge_mode
否
String
- 取值为traffic,表示流量计费。
- step1 请求样例 申请弹性IP。
POST https://{VPCEndpoint}/v1/8b7e35ad379141fc9df3e178bd64f55c/publicips { "publicip": { "type": "5_bgp", "ip_version": 4 }, "bandwidth": { "name": "bandwidth123", "size": 10, "share_type": "PER" } }
- step1 响应样例
{ "publicip": { "id": "f588ccfa-8750-4d7c-bf5d-2ede24414706", "status": "PENDING_CREATE", "type": "5_bgp", "public_ip_address": "139.9.204.183", "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c", "ip_version": 4, "create_time": "2019-06-29 06:45:32", "bandwidth_size": 1 } }
- step2 请求样例 绑定弹性IP,public_id为▪step1 响应样例中的publicip id,port_id为 响应样例1的vip_port_id。
PUT /v1/8b7e35ad379141fc9df3e178bd64f55c/publicips/f588ccfa-8750-4d7c-bf5d-2ede24414706 { "publicip": { "port_id": "a7ecbdb5-5a63-41dd-a830-e16c0a7e04a7" } }
- step2 响应样例
{ "publicip": { "id": "f588ccfa-8750-4d7c-bf5d-2ede24414706", "status": "ACTIVE", "type": "5_bgp", "port_id": "a7ecbdb5-5a63-41dd-a830-e16c0a7e04a7", "public_ip_address": "139.9.204.183", "private_ip_address": "192.168.1.131", "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c", "create_time": "2019-06-29 07:33:18", "bandwidth_size": 1, "ip_version": 4 } }
- 完成以上步骤,负载均衡器已具备公网访问的能力,可通过响应体中的public_ip_address:139.9.204.183来访问负载均衡器。
响应示例
- 响应样例1
{ "loadbalancer": { "description": "simple lb", "provisioning_status": "ACTIVE", "tenant_id": "1867112d054b427e808cc6096d8193a1", "created_at": "2019-01-19T05:32:56", "admin_state_up": true, "updated_at": "2019-01-19T05:32:57", "id": "ea2843da-4026-49ec-8338-8fa015b067fc", "pools": [], "listeners": [], "vip_port_id": "a7ecbdb5-5a63-41dd-a830-e16c0a7e04a7", "operating_status": "ONLINE", "vip_address": "192.168.0.100", "vip_subnet_id": "58077bdb-d470-424b-8c45-2e3c65060a5b", "provider": "vlb", "tags": [], "name": "loadbalancer1" } }
- 响应样例 2
POST https://{Endpoint}/v2.0/lbaas/loadbalancers { "loadbalancer": { "name": "loadbalancer1", "description": "simple lb", "tenant_id": "1867112d054b427e808cc6096d8193a1", "vip_subnet_id": "58077bdb-d470-424b-8c45-2e3c65060a5b", "vip_address": "192.168.0.100", "admin_state_up": true } }
完成以上步骤,负载均衡器已具备公网访问的能力,可通过响应体中的public_ip_address:139.9.204.183来访问负载均衡器。
返回码
请参见状态码。