查询已创建的负载均衡实例。

调试

  1. 点击这里OpenAPI Explorer中可视化调试,并自动生成SDK调用示例。

请求参数

名称 类型 是否必须 描述
Action String 要执行的操作。取值:

DescribeLoadBalancers

RegionId String 负载均衡实例的地域。

您可以通过调用 DescribeRegions接口获取地域ID。

LoadBalancerId String 负载均衡实例ID。

支持多值查询,最多可输入10个ID,以逗号分隔。

LoadBalancerName String 负载均衡实例名称。

支持多值查询,最多可输入10个名称,以逗号分隔。

AddressType String 负载均衡实例的网络类型,取值:

intranet | internet

NetworkType String 私网负载均衡实例的网络类型,取值:
  • vpc:专有网络实例
  • classic:经典网络实例
VpcId String 负载均衡实例所属的VPC ID。
VswitchId String 负载均衡实例所属的VSwitch ID。
Address String 负载均衡实例的服务地址。
ServerIntranetAddress Integer 添加的后端服务器(ECS实例)的内网地址。

支持多值查询,以逗号分隔。

InternetChargeType String 公网类型实例付费方式。取值:paybybandwidthpaybytraffic
ServerId String 添加的后端服务器(ECS实例)的ID。
MasterZoneId String 负载均衡实例的主可用区ID。
SlaveZoneId String 负载均衡实例的备可用区ID。
Tags String 负载均衡实例绑定的标签。

最多可指定10个标签。

表 1. Tag
名称 类型 是否必须 描述
TagKey String 标签的key。
说明 如果指定了 Tags参数,则该参数必选。
TagValue String 对应标签Key的value,不能以aliyun开头。
说明 如果指定了 Tags参数,则该参数必选。

返回参数

名称 类型 描述
RequestId String 请求ID。
LoadBalancers List 查询到的负载均衡实例列表。
表 2. LoadBalancer
名称 类型 描述
LoadBalancerId String 负载均衡实例ID。
LoadBalancerName String 负载均衡实例的名称。
LoadBalancerStatus String 负载均衡实例状态:
  • inactive: 此状态的实例监听不会再转发流量。
  • active: 实例创建后,默认状态为active
  • locked: 实例已经被锁定。
Address String 负载均衡实例的服务地址。
RegionId String 负载均衡实例的地域ID。
RegionIdAlias String 负载均衡实例的地域名称。
AddressType String 负载均衡实例的网络类型。
VSwitchId String 私网负载均衡实例的交换机ID。
VpcId String 私网负载均衡实例的专有网络ID。
NetworkType String 私网负载均衡实例的网络类型:
  • vpc:专有网络实例
  • classic:经典网络实例
CreateTime String 负载均衡实例的创建时间。
MasterZoneId String 实例的主可用区ID。
SlaveZoneId String 实例的备可用区ID。
InternetChargeType String 公网实例的计费方式。取值:
  • paybybandwidth:按带宽计费
  • paybytraffic:按流量计费(默认值)
说明PayType参数的值为PrePay时,只支持按带宽计费。
PayType String 实例的计费类型,取值:
  • PayOnDemand:按量付费
  • PrePay:预付费
ResourceGroupId String 企业资源组ID。

示例

请求示例

  1. https://slb.aliyuncs.com/?Action=DescribeLoadBalancers&RegionId=cn-hangzhou&公共请求参数
返回示例
  • XML格式

    1. <?xml version=”1.0 encoding=”UTF-8”?><DescribeLoadBalancersResponse> <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId> <LoadBalancers> <LoadBalancer> <LoadBalancerId>139a00604ad-cn-east-hangzhou-01</LoadBalancerId> <LoadBalancerName>abc</LoadBalancerName> <Address>100.98.28.56</Address> <AddressType>intranet</AddressType> <RegionId>cn-east-hangzhou-01</RegionId> <VSwitchId>vsw-255ecrwq4</VSwitchId> <VpcId>vpc-25dvzy9f9</VpcId> <NetworkType>vpc</NetworkType> <LoadBalancerStatus>active</LoadBalancerStatus> <MasterZoneId>cn-hangzhou-b</MasterZoneId> <SlaveZoneId>cn-hangzhou-d</SlaveZoneId> </LoadBalancer> <LoadBalancer> <LoadBalancerId>282b00102ac-cn-east-hangzhou-01</LoadBalancerId> <LoadBalancerName>def</LoadBalancerName> <Address>100.98.28.55</Address> <AddressType>intranet</AddressType> <RegionId>cn-east-hangzhou-01</RegionId> <VSwitchId>vsw-255ecrwq5</VSwitchId> <VpcId>vpc-25dvzy9f8</VpcId> <NetworkType>vpc</NetworkType> <LoadBalancerStatus>active</LoadBalancerStatus> <MasterZoneId>cn-hangzhou-b</MasterZoneId> <SlaveZoneId>cn-hangzhou-d</SlaveZoneId> </LoadBalancer> </LoadBalancers></DescribeLoadBalancersResponse>
  • JSON格式

    1. { RequestId”: 365F4154-92F6-4AE4-92F8-7FF34B540710”, LoadBalancers”: { LoadBalancer”: [ { LoadBalancerId”: 139a00604ad-cn-east-hangzhou-01”, LoadBalancerName”: abc”, Address”: 100.98.28.56”, AddressType”: intranet”, RegionId”: cn-east-hangzhou-01”, VSwitchId”: vsw-255ecrwq4”, VpcId”: vpc-25dvzy9f9”, NetworkType”: vpc”, LoadBalancerStatus “: active”, MasterZoneId”: cn-hangzhou-b”, SlaveZoneId”: cn-hangzhou-d }, { LoadBalancerId”: 282b00102ac-cn-east-hangzhou-01”, LoadBalancerName”: def”, Address”: 100.98.28.55”, AddressType”: intranet”, RegionId”: cn-east-hangzhou-01”, VSwitchId”: vsw-255ecrwq5”, VpcId”: vpc-25dvzy9f8”, NetworkType”: vpc”, LoadBalancerStatus “: active”, MasterZoneId”: cn-hangzhou-b”, SlaveZoneId”: cn-hangzhou-d } ] }}