DescribeDirectConnectConnectionBilling--专线连接-火山引擎

文档中心

导航

DescribeDirectConnectConnectionBilling

最近更新时间：2024.09.20 11:49:14首次发布时间：2024.09.20 11:49:14

调用DescribeDirectConnectConnectionBilling查询物理专线的计费信息。

请求参数

参数名称	类型	是否必选	示例值	说明
Action	String	是	DescribeDirectConnectConnectionBilling	要执行的操作，取值：DescribeDirectConnectConnectionBilling。
PageSize	Integer	否	20	分页查询时每页的行数。取值范围：1～100，默认值为20。
PageNumber	Integer	否	1	分页查询的页码。如需传入此参数，请传入非负整数。不传或传入0，则均默认为1。
DirectConnectConnectionIds.N	List of String	否	DirectConnectConnections.1=dcc-8ha23ndut0jd93**&DirectConnectConnections.2=dcc-57ads1nudt2jd73**	物理专线的ID。您可调用DescribeDirectConnectConnections查询物理专线的ID。参数 - N：表示物理专线ID的序号。多个ID之间用&分隔。

返回参数

参数名称	类型	示例值	说明
RequestId	String	20220627103212010225145152058*****	请求ID。
PageSize	Integer	20	当前分页的行数。
PageNumber	Integer	1	当前页码。
TotalCount	Integer	1	符合查询条件的物理专线的数量。
DirectConnectConnections	Array of struct	-	物理专线详细的计费信息，具体请见下表“DirectConnectConnection”。

DirectConnectConnection

参数名称	类型	示例值	说明
DirectConnectConnectionId	String	dcc-8ha23ndut0jd93****	物理专线的ID。
BillingType	Integer	1	付费类型。当前仅支持“1”包年包月计费。
BillingStatus	Integer	1	付费状态。 1：计费运行中 2：计费创建实例失败 3：已退订 4：到期关停 5：到期回收
RenewType	String	Auto	续费方式。 Auto：自动续费 Manual：手动续费 NoRenew：到期不续费
RemainRenewTimes	Integer	1	剩余自动续费的次数。
ExpiredTime	String	2022-10-10 23:59:59	物理专线资源到期时间。
Reclaimed	String	2022-10-11 00:00:00	物理专线资源回收时间。

请求示例

GET /?Action=DescribeDirectConnectConnectionBilling&Version=2020-04-01&PageNumber=1&PageSize=20&DirectConnectConnectionIds=dcc-8ha23ndut0jd93**** HTTP/1.1
Host: open.volcengineapi.com
ServiceName: directconnect
Region: cn-beijing

返回示例

{
 "ResponseMetadata": {
     "RequestId": "20220627103212010225145152058*****",
     "Action": "DescribeDirectConnectConnectionBilling",
     "Version": "2020-04-01",
     "Service": "directconnect",
     "Region": "cn-beijing"
 },
 "Result": {
     "RequestId": "20220627103212010225145152058*****",
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 1,
        "DirectConnectConnections": [
            {
                "DirectConnectConnectionId": "dcc-8ha23ndut0jd93****",
                "BillingType": 1,
                "BillingStatus": 1,
                "RenewType": "Manual",
                "RemainRenewTimes": 1,
                "ExpiredTime": "2022-11-13 23:59:59",
                "ReclaimedTime": "2022-12-04 23:59:59"
            }
        ]
    }
}

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

HttpCode	错误码	错误信息	描述
400	LimitExceeded.DirectConnectConnectionId	You've reached the limit on the number of direct connect connection IDs that you can describe.	已达到可查询的物理连接ID数量上限。
400	InvalidPage.Malformed	The specified page is malformed.	指定的分页参数不合法。