You need to enable JavaScript to run this app.
导航

ListAmortizedCostBillMonthly - 查询成本账单总览

最近更新时间2024.04.02 21:37:19

首次发布时间2023.12.06 17:34:46

查询成本账单总览

调试

请求参数

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

参数
类型
是否必填
示例值
描述
Action
String

ListAmortizedCostBillMonthly

要执行的操作,取值:ListAmortizedCostBillMonthly

Version
String

2022-01-01

API的版本,取值:2022-01-01

AmortizedType
Array of String

[1]

分摊类型:1:履约计费分摊;2:合同计费分摊;3:按量计费分摊;4:新购分摊;5:更配分摊;6:续费分摊;7:退订分摊;8:预留实例调整分摊;9:试用分摊;10:转正分摊;默认不选为全部

BillingMode
Array of String

[1]

计费模式:1:包年包月;2:按量计费;3:合同计费;4:履约计费;默认不选为全部

BillCategory
Array of String

[consume-use]

账单类型:consume-use:消费-使用;consume-new:消费-新购;consume-renew:消费-续费;consume-formalize:消费-转正;consume-modify:消费-更配;consume-trial:消费-试用;refund-terminate:退款-退订;refund-modify:退款-更配;transfer-manual:调账-人工;transfer-system:调账-系统;默认不选为全部

Product
Array of String

[ECS]

产品名称,默认不选为全部

Offset
Integer

0

偏移量

Limit
Integer

10

数量:[1-300]

BillPeriod
String

2023-08

账务账期:格式为YYYY-MM;仅支持单月查询;最多24个月;最早只能查询2023-04;

AmortizedMonth
String

2023-08

分摊月:格式为YYYY-MM;仅支持单月查询;最多24个月;最早只能查询2023-04;

InstanceNo
String

i-ycjlq77tdg8rx6ib4v1s

实例id,默认不选为全部

IgnoreZero
Integer

1

是否忽略折后价为0的数据:0:不忽略;1忽略;默认为不忽略;

NeedRecordNum
Integer

1

是否需要访问列表的总记录数:用于前端分页;1:表示需要; 0:表示不需要;默认为不需要

返回参数

本接口无特有的返回参数。更多信息请见返回结构

参数
类型
示例值
描述
List
Array of CostBillMonthly

成本总览列表

Total
Integer

100

总数

Limit
Integer

100

步长

Offset
Integer

0

偏移量

请求示例

curl --location --request POST 'https://open.volcengineapi.com?Action= ListAmortizedCostBillMonthly&Version=2022-01-01' \
--header 'AccessKey: AKLTZm*****' \
--header 'SecretKey: T1RVek*****' \
--header 'Region: cn-north-1' \
--header 'ServiceName: billing'\
--header 'Content-Type: application/json' \
--data-raw '{
    "AmortizedMonth":"2023-10",
    "Limit":1,
    "Offset":0
}'

返回示例

{
    "ResponseMetadata":{
        "RequestId":"202302151509010207BA7B59BCEA6513BD",
        "Action":"ListAmortizedCostBillMonthly",
        "Version":"2022-01-01",
        "Service":"billing",
        "Region":"cn-north-1"
    },
    "Result":{
        "List":[
            {
                "AmortizedMonth":"2023-03",
                "BillPeriod":"2023-03",
                "BusiPeriod":"2023-03",
                "PayerID":"2100057673",
                "PayerUserName":"weitest009",
                "PayerCustomerName":"俊杰1",
                "SellerID":"3423",
                "SellerUserName":"火山引擎",
                "SellerCustomerName":"北京火山引擎科技有限公司",
                "OwnerID":"2100057674",
                "OwnerUserName":"weitest10",
                "OwnerCustomerName":"俊杰1",
                "Product":"on_line",
                "ProductZh":"-",
                "BusinessMode":"财务托管",
                "BillingMode":"包年包月",
                "BillCategory":"消费-新购",
                "AmortizedType":"新购分摊",
                "AmortizedBeginTime":"2023-03-23 20:08:27",
                "AmortizedEndTime":"2023-03-26 23:59:59",
                "AmortizedDayNum":"4",
                "BillID":"Order7213685053558706476",
                "InstanceNo":"On_line7213685053558804780",
                "InstanceName":"-",
                "Element":"-",
                "Region":"不限",
                "Zone":"-",
                "Factor":"-",
                "ExpandField":"-",
                "Price":"30.00",
                "PriceUnit":"GB天",
                "Count":"1.00",
                "Unit":"GB天",
                "UseDuration":"4",
                "UseDurationUnit":"日",
                "CouponAmount":"0.00",
                "PayableAmount":"120.00",
                "DailyAmortizedCouponAmount":"0.00",
                "DailyAmortizedPayableAmount":"0.00",
                "BeforeAmortizedCouponAmount":"0.00",
                "BeforeAmortizedPayableAmount":"0.00",
                "NowAmortizedCouponAmount":"0.00",
                "NowAmortizedPayableAmount":"120.00",
                "UnamortizedCouponAmount":"0.00",
                "UnamortizedPayableAmount":"0.00",
                "Currency":"CNY",
                "Project":"project_test",
                "Tag":"voKey1*v1,voKey101*v5,volc:vke:cluster-id*valu3,volc:vke:createdby-vke-flag*valu4,volc:vke:used-by-vke-cluster*value5",
                "SubjectName":"北京火山引擎科技有限公司",
                "BillingFunction": "-",
                "MarketPrice": "",
                "DiscountBizBillingFunction": "固定单价",
                "DiscountBizUnitPrice": "0.0275",
                "DiscountBizUnitPriceInterval": "-",
                "DiscountBizMeasureInterval": "-",
                "EffectiveFactor": "1",
                "PriceInterval": "-",
                "MeasureInterval": "-",
                "BillingMethodCode": "按加和量小时结",
                "ProjectDisplayName": ""
            }
        ],
        "Total":74,
        "Limit":10,
        "Offset":0
    }
}

错误码

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