ListBillOverviewByProd - 分页查询账单总览-产品汇总信息--费用中心-火山引擎

文档中心

立即注册

导航

ListBillOverviewByProd - 分页查询账单总览-产品汇总信息

最近更新时间：2024.06.12 11:34:26首次发布时间：2023.12.06 17:34:30

分页查询账单总览-产品汇总信息

调试

API Explorer

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

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	ListBillOverviewByProd	要执行的操作，取值：ListBillOverviewByProd。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
PayerID	Array of Long	否	[2100057673]	Payer账号ID
OwnerID	Array of Long	否	[2100057673]	Owner账号ID
Offset	Integer	否	10	偏移量
Limit	Integer	是	10	数量：[1-300]
BillPeriod	String	是	2023-08	账期：格式为YYYY-MM；仅支持单月查询；最多24个月；最早只能查询2022-01（新版账单的时间）
IgnoreZero	Integer	否	1	是否忽略折后价为0的数据：0：不忽略；1忽略；默认为不忽略；
NeedRecordNum	Integer	否	1	是否需要访问列表的总记录数：用于前端分页；1：表示需要； 0：表示不需要；默认为不需要
BillingMode	Array of String	否	[1]	计费模式：1：包年包月；2：按量计费；3：合同计费；4：履约计费；默认不选为全部
BillCategoryParent	Array of String	否	[consume]	账单大类类型：consume：消费；refund：退款；transfer：调账；默认不选为全部；
Product	Array of String	否	[ECS]	产品名称，默认不选为全部

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
List	Array of BillOverviewByProd		账单总览-产品汇总列表
Total	Integer	100	总数
Limit	Integer	100	步长
Offset	Integer	0	偏移量

请求示例

POST /?Action=ListBillOverviewByProd&Version=2022-01-01 HTTP/1.1
Host: https://open.volcengineapi.com?Action= ListBillOverviewByProd&Version=2022-01-01
Content-Type: application/json; charset=UTF-8
X-Date: 20240510T082035Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240510/cn-beijing/billing/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "Limit": 10,
  "BillPeriod": "2023-08"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202302151539373422AB4D3113FA66F8E3",
        "Action": "ListBillOverviewByProd",
        "Version": "2022-01-01",
        "Service": "billing",
        "Region": "cn-north-1"
    },
    "Result": {
        "List": [
            {
                "BillPeriod": "2022-10",
                "PayerID": "2000010593",
                "PayerUserName": "WtestID",
                "PayerCustomerName": "W测试",
                "SellerID": "3423",
                "SellerUserName": "火山引擎",
                "SellerCustomerName": "北京火山引擎科技有限公司",
                "OwnerID": "2000010593",
                "OwnerUserName": "WtestID",
                "OwnerCustomerName": "W测试",
                "BusinessMode": "普通业务",
                "Product": "on_line",
                "ProductZh": "线上测试产品-勿动",
                "BillingMode": "2",
                "BillCategoryParent": "consume",
                "OriginalBillAmount": "158452.248288",
                "PreferentialBillAmount": "0.000000",
                "RoundBillAmount": "2.568288",
                "DiscountBillAmount": "158449.68",
                "CouponAmount": "0.00",
                "PayableAmount": "0.00",
                "PaidAmount": "0.00",
                "UnpaidAmount": "0.00",
                "SettlementType": "非结算"
            }
        ],
        "Total": 1,
        "Limit": 10,
        "Offset": 0
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。