最近更新时间: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 } }
您可访问公共错误码,获取更多错误码信息。