DescribeCenBandwidthPackagesBilling--云企业网-火山引擎

文档中心

立即注册

导航

DescribeCenBandwidthPackagesBilling

最近更新时间：2024.09.06 08:10:42首次发布时间：2024.01.09 07:27:01

调用 DescribeCenBandwidthPackagesBilling 接口，查看带宽包的计费相关信息。

调试

API Explorer

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

去调试

请求参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	DescribeCenBandwidthPackagesBilling	要执行的操作，取值为DescribeCenBandwidthPackagesBilling。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
CenBandwidthPackageIds.N	String	否	CenBandwidthPackageIds.1=cbp-4c2zaavbvh5x****	带宽包的ID。您可以调用DescribeCenBandwidthPackages接口获取带宽包ID。参数 - N：表示带宽包ID的序号，取值范围为1～100。多个带宽包ID之间用&分隔。
PageNumber	Integer	否	1	列表的页码，默认值为1。
PageSize	Integer	否	20	分页查询时每页显示的行数。取值范围为1~100，默认值为20。

返回参数

参数名称	类型	示例值	描述
PageSize	Integer	20	当前分页的行数。
PageNumber	Integer	1	当前页码。
TotalCount	Integer	2	符合条件的带宽包实例总数。
CenBandwidthPackages	Array of Struct	-	带宽包实例的详细信息。具体请参见“ CenBandwidthPackage结构”。

CenBandwidthPackage结构

参数名称	类型	示例值	描述
CenBandwidthPackageId	String	cbp-4c2zaavbvh5x****	带宽包实例ID。
BillingStatus	Integer	1	带宽包实例的计费状态。取值如下： 0：创建中 1：运行中 3：已退订 4：到期关停 5：到期回收 8：退订关停
BillingType	Integer	1	带宽包实例的计费方式。 1：包年包月。
ExpiredTime	String	2021-05-07 23:59:59	带宽包实例的到期时间。说明当参数`BillingType`为1时，返回该参数。
ReclaimTime	String	2021-05-07 23:23:23	带宽包实例到期后的回收时间。说明当参数`BillingType`为1时，返回该参数。
RemainRenewTimes	Integer	1	自动续费的次数。取值包括-1和1～100，默认值为-1，表示自动续费无限次。说明当参数`RenewType`为2时，返回该参数。
RenewType	String	Auto	带宽包实例的续费类型。 Manual：手动续费 Auto：自动续费 NoRenew：不续费。说明当参数`BillingType`为1时，返回该参数。

请求示例

GET /?Action=DescribeCenBandwidthPackagesBilling&Version=2020-04-01&CenBandwidthPackageIds.1=cbp-bp1o94dp5**** HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021081115253901022514606****",
        "Action": "DescribeCenBandwidthPackagesBilling",
        "Version": "2020-04-01",
        "Service": "cen",
        "Region": "cn-beijing"
    },
    "Result": {
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 1,
        "CenBandwidthPackages": [
            {
                "CenBandwidthPackageId": "cbp-4c2zaavbvh5x****",
                "BillingStatus": 1,
                "BillingType": 1,
                "ExpiredTime": "2021-05-07 23:59:59",
                "ReclaimTime": "2021-15-07 23:59:59",
                "RemainRenewTimes": 1,
                "RenewType": "Auto"
            },
            {
                "CenBandwidthPackageId": "cbp-4c26aavrvh80****",
                "BillingStatus": 1,
                "BillingType": 1,
                "ExpiredTime": "2022-05-07 23:59:59",
                "ReclaimTime": "2021-15-07 23:59:59",
                "RemainRenewTimes": 1,
                "RenewType": "Auto"
            }
        ]
    }
}

错误码

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

HttpCode	错误码	错误信息	描述
400	InvalidPage.Malformed	The specified page is malformed.	指定的分页参数不合法。
400	LimitExceeded.ResourceIds	You've reached the limit of 100 resource IDs that can be specified in this request.	已达到单次可查询的实例数量上限。