查询负载均衡实例列表

最近更新时间: 2024-06-18 14:31:28

1. 接口描述

接口请求域名: clb.api3.fincloud.tencent.cn。

查询一个地域的负载均衡实例列表

默认接口请求频率限制:20次/秒。

接口更新时间:2020-01-10 19:40:46。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数

参数名称 必选 允许NULL 类型 描述
Action String 公共参数,本接口取值:DescribeLoadBalancers
Version String 公共参数,本接口取值:2018-03-17
Region String 公共参数,详见产品支持的地域列表(TODO)
LoadBalancerIds Array of String 负载均衡实例 ID。
LoadBalancerType String 负载均衡实例的网络类型:<br>OPEN:公网属性, INTERNAL:内网属性。
Forward Int64 负载均衡实例的类型。1:通用的负载均衡实例,0:传统型负载均衡实例。如果不传此参数,则查询所有类型的负载均衡实例。
LoadBalancerName String 负载均衡实例的名称。
Domain String 腾讯云为负载均衡实例分配的域名,本参数仅对传统型公网负载均衡才有意义。
LoadBalancerVips Array of String 负载均衡实例的 VIP 地址,支持多个。
BackendPublicIps Array of String 负载均衡绑定的后端服务的外网 IP。
BackendPrivateIps Array of String 负载均衡绑定的后端服务的内网 IP。
Offset Int64 数据偏移量,默认为 0。
Limit Int64 返回负载均衡实例的数量,默认为20,最大值为100。
OrderBy String 排序参数,支持以下字段:LoadBalancerName,CreateTime,Domain,LoadBalancerType。
OrderType Int64 1:倒序,0:顺序,默认按照创建时间倒序。
SearchKey String 搜索字段,模糊匹配名称、域名、VIP。
ProjectId Int64 负载均衡实例所属的项目 ID,可以通过 DescribeProject 接口获取。
WithRs Int64 负载均衡是否绑定后端服务,0:没有绑定后端服务,1:绑定后端服务,-1:查询全部。
VpcId String 负载均衡实例所属私有网络唯一ID,如 vpc-bhqkbhdx,<br>基础网络可传入'0'。
SecurityGroup String 安全组ID,如 sg-m1cc9123
MasterZone String 主可用区ID,如 :"100001" (对应的是广州一区)
Filters Array of Filter 此参数对外不可见。
每次请求的Filters的上限为10,Filter.Values的上限为100。详细的过滤条件如下:<br><li> internet-charge-type - String - 是否必填:否 - (过滤条件)按照 CLB 的网络计费模式过滤,包括"BANDWIDTH_PREPAID","TRAFFIC_POSTPAID_BY_HOUR","BANDWIDTH_POSTPAID_BY_HOUR","BANDWIDTH_PACKAGE"。</li><br><li> master-zone-id - String - 是否必填:否 - (过滤条件)按照 CLB 的主可用区ID过滤,如 :"100001" (对应的是广州一区)。</li><br><li> tag-key - String - 是否必填:否 - (过滤条件)按照 CLB 标签的键过滤。</li>

3. 输出参数

参数名称 类型 描述
TotalCount Uint64 满足过滤条件的负载均衡实例总数。此数值与入参中的Limit无关。
LoadBalancerSet LoadBalancer 返回的负载均衡实例数组。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码 描述
InvalidParameter
InvalidParameterValue
InternalError
UnauthorizedOperation
FailedOperation
InvalidParameter.FormatError
InvalidParameterValue.Length
InvalidParameterValue.InvalidFilter