负载均衡器列表
更新时间 2026-08-19 15:16:26
最近更新时间: 2026-08-19 15:16:26
接口功能介绍
获取负载均衡器列表
接口约束
无
URI
GET /v1/cae/elb/list
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| name | 否 | String | 负载均衡名称 | my-elb | |
| regionID | 否 | String | 资源池 ID | bb9fdb4205f84da3af9ff6e24e85d441 | |
| resourceType | 否 | String | 资源类型。internal:内网负载均衡,external:公网负载均衡 | internal |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池 ID | bb9fdb42056xxxeda1610242ac1xxxxx | |
| locale | 否 | String | 指定客户端期望的响应语言偏好,默认语言为中文 | en英文,zh-CH中文 |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 业务状态码(800为成功,900为失败) | 800 | |
| message | String | 业务状态码为900时的错误信息 | success | |
| description | String | 业务状态码为900时的错误描述 | 成功 | |
| returnObj | Object | 业务数据 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| elbList | Array of Objects | 负载均衡器列表 | ElbData | |
| requestID | String | 请求ID | 5fd3e6f7-9229-4fb4-a352-0f91bfd638b1 |
表 ElbData
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| ID | String | ELB标识 | 09db72fa-xxxx-xxxx-a1d8-24a420181216 | |
| adminStatus | String | 管理状态 | ACTIVE | |
| azName | String | 可用区名称 | az1 | |
| createdTime | String | 创建时间 | 2024-01-01T00:00:00Z | |
| deleteProtection | Boolean | 删除保护 | false | |
| description | String | ELB描述 | my-elb-desc | |
| eipInfo | Array of Objects | EIP信息 | EipInfo | |
| ipv6Address | String | IPv6地址 | 2001:db8::1 | |
| name | String | ELB名称 | my-elb | |
| portID | String | 端口标识 | port-xxxx | |
| privateIpAddress | String | 私网IP地址 | 10.0.0.1 | |
| projectID | String | 项目标识 | 0 | |
| regionID | String | 区域编码 | bb9fdb4205f84da3af9ff6e24e85d441 | |
| resourceType | String | 资源类型 | internal | |
| slaName | String | SLA名称 | eip.s1.small | |
| status | String | ELB状态 | ACTIVE | |
| subnetID | String | 子网标识 | subnet-xxxx | |
| updatedTime | String | 更新时间 | 2024-01-01T00:00:00Z | |
| vpcID | String | VPC标识 | vpc-tsge****asd |
表 EipInfo
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| bandwidth | Float | 带宽 | 1 | |
| eipAddress | String | EIP地址 | 100.100.100.1 | |
| eipID | String | EIP标识 | 09db72fa-xxxx-xxxx-a1d8-24a420181216 | |
| isTalkOrder | Boolean | 是否按流量计费 | false | |
| resourceID | String | EIP资源标识 | eip-001 |
枚举参数
无
请求示例
请求url
GET /v1/cae/elb/list
请求头header
regionId:20000000***1852
请求体body
无
响应示例
{
"statusCode": 800,
"message": "success",
"description": "成功",
"returnObj": {
"elbList": [
{
"ID": "09db72fa-xxxx-xxxx-a1d8-24a420181216",
"adminStatus": "ACTIVE",
"azName": "az1",
"createdTime": "2024-01-01T00:00:00Z",
"deleteProtection": false,
"description": "my-elb-desc",
"eipInfo": [
{
"bandwidth": 1,
"eipAddress": "100.100.100.1",
"eipID": "09db72fa-xxxx-xxxx-a1d8-24a420181216",
"isTalkOrder": false,
"resourceID": "eip-001"
}
],
"ipv6Address": "2001:db8::1",
"name": "my-elb",
"portID": "port-xxxx",
"privateIpAddress": "10.0.0.1",
"projectID": "0",
"regionID": "bb9fdb4205f84da3af9ff6e24e85d441",
"resourceType": "internal",
"slaName": "eip.s1.small",
"status": "ACTIVE",
"subnetID": "subnet-xxxx",
"updatedTime": "2024-01-01T00:00:00Z",
"vpcID": "vpc-tsge****asd"
}
],
"requestID": "5fd3e6f7-9229-4fb4-a352-0f91bfd638b1"
}
}
状态码
请参考 状态码
错误码
请参考 错误码