DescribeLoadBalancersBilling--负载均衡-火山引擎

文档中心

立即注册

导航

DescribeLoadBalancersBilling

最近更新时间：2024.10.21 14:07:14首次发布时间：2022.03.01 08:57:47

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

调试

API Explorer

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

去调试

请求参数

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

返回参数

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

LoadBalancerBillingConfigs

名称	类型	示例值	描述
LoadBalancerId	String	clb-bp1b6c719dfa08ex****	CLB实例的ID。
BillingType	Integer	2	CLB实例的计费类型。 1：包年包月 2：按量计费-按规格计费 3：按量计费-按使用量计费说明按使用量计费正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。
RenewType	Integer	2	CLB实例的续费类型。 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	CLB实例的计费状态。 0：创建中 1：运行中 2：创建失败 3：已退订 4：到期关停 5：到期回收 6：欠费关停 7：欠费回收 8：退订关停
ExpiredTime	String	2021-08-11T23:59:59Z	CLB实例的到期时间。说明当参数`BillingType`为1时，返回该参数。
ReclaimTime	String	2021-08-26T23:59:59Z	CLB实例到期后的回收时间。说明当参数`BillingType`为1时，返回该参数。
OverdueTime	String	2021-08-11T16:37:37Z	CLB实例欠费关停的时间。说明当参数`BillingType`为2或3时，返回该参数。
OverdueReclaimTime	String	2021-08-11T16:37:37Z	CLB实例欠费关停后的回收时间。说明当参数`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.	已达到单次可查询负载均衡的数量上限。