文档中心

DescribeLoadBalancersBilling

最近更新时间：2024.01.12 10:21:39

首次发布时间：2022.03.01 08:57:47

调用DescribeLoadBalancersBilling接口，查询指定负载均衡实例计费相关的信息。

调试

API Explorer

您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLoadBalancersBilling	要执行的操作，取值为DescribeLoadBalancersBilling。
Version	String	是	2020-04-01	API版本信息，当前版本为：2020-04-01。
PageSize	Integer	否	10	分页查询时每页的行数，取值范围为1 ~ 100，默认值为10。
PageNumber	Integer	否	1	列表的页码，默认值为1。
LoadBalancerIds.N	String	否	LoadBalancerIds.1=clb-bp1b6c719dfa08ex**&LoadBalancerIds.2=clb-2fea2u2m4qhog5oxruuoo**	负载均衡实例ID列表。您可以调用DescribeLoadBalancers接口获取负载均衡实例ID。参数 - N：表示负载均衡实例ID的序号，取值范围为1 ～ 20，表示指定实例ID时最多可查询20个。多个负载均衡实例ID间使用&符号连接。

返回参数

名称	类型	示例值	描述
RequestId	String	20210811152539010225146063030****	请求ID。
PageSize	Integer	10	当前分页的行数。
PageNumber	Integer	1	当前页码。
TotalCount	Integer	1	符合条件的实例总数。
LoadBalancerBillingConfigs	Array of Struct	-	负载均衡实例的账单配置。具体请参见下表“ LoadBalancerBillingConfigs ”。

LoadBalancerBillingConfigs

名称	类型	示例值	描述
LoadBalancerId	String	clb-bp1b6c719dfa08ex****	负载均衡实例的ID。
BillingType	Integer	2	负载均衡实例的计费类型。 1：包年包月 2：按量计费-按规格计费 3：按量计费-按使用量计费
RenewType	Integer	2	负载均衡实例的续费类型。 1：手动续费 2：自动续费 3：到期不续费说明当参数`BillingType`为1时，返回该参数。
RenewPeriodTimes	Integer	1	单次自动续费的时长。说明当参数`RenewType`为1或3时，该参数返回0。
RemainRenewTimes	Integer	-1	自动续费的次数。取值包括-1和1～100，取值为-1，表示自动续费无限次。说明当参数`RenewType`为1或3时，该参数返回-1。
InstanceStatus	Integer	1	负载均衡实例的计费状态。 0：创建中 1：运行中 2：创建失败 3：已退订 4：到期关停 5：到期回收 6：欠费关停 7：欠费回收 8：退订关停
ExpiredTime	String	2021-08-11T23:59:59Z	负载均衡实例的到期时间。说明当参数`BillingType`为1时，返回该参数。
ReclaimTime	String	2021-08-26T23:59:59Z	负载均衡实例到期后的回收时间。说明当参数`BillingType`为1时，返回该参数。
OverdueTime	String	2021-08-11T16:37:37Z	负载均衡实例欠费关停的时间。说明当参数`BillingType`为2或3时，返回该参数。
OverdueReclaimTime	String	2021-08-11T16:37:37Z	负载均衡实例欠费关停后的回收时间。说明当参数`BillingType`为2或3时，返回该参数。

请求示例

GET /?Action=DescribeLoadBalancersBilling&Version=2020-04-01&LoadBalancerIds.1=clb-bp1b6c719dfa08ex**** HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: clb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210811152539010225146063030****",
        "Action": "DescribeLoadBalancersBilling",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-beijing"
    },   
    "Result": {
        "RequestId": "20210811152539010225146063030****",
        "PageNumber": 1,
        "PageSize": 10,
        "TotalCount": 1,
        "LoadBalancerBillingConfigs": [
            {
                "LoadBalancerId": "clb-bp1b6c719dfa08ex****",
                "BillingType": "2",
                "RenewType": "2",
                "RenewPeriodTimes": "1",
                "RemainRenewTimes": "-1",
                "InstanceStatus": "1",
                "ExpiredTime": "",
                "ReclaimTime": "",
                "OverdueTime": "",
                "OverdueReclaimTime": ""
            }
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode	错误码	错误信息	描述
400	InvalidPaging.Malformed	The specified PageNumber or PageSize is malformed.	指定的分页参数格式不合法。
400	LimitExceeded.LoadBalancerIdNumber	You've reached the limit on the number of description LoadBalancer that you can operate.	已达到单次可查询负载均衡的数量上限。

调试

请求参数

返回参数

LoadBalancerBillingConfigs

请求示例

返回示例

错误码