费用中心
费用中心
文档指南
请输入
- 文档首页
费用中心API参考账单管理ListAmortizedCostBillMonthly - 查询成本账单总览
复制全文
下载 pdfListAmortizedCostBillMonthly - 查询成本账单总览
文档反馈
问问助手提供基于资源实际使用周期的分摊账单并按分摊月聚合，如将包年包月订单费用分摊到实际生效周期的每一日；如需使用请及时开通，未开通时不提供成本分摊数据；相比账单明细存在2天延迟；了解更多详情可查看成本账单说明；
注意事项
- 查询QPS限制为5QPS，超过限流将报错；
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListAmortizedCostBillMonthly
要执行的操作，取值：ListAmortizedCostBillMonthly。
Version string 必选 示例值：2022-01-01
API的版本，取值：2022-01-01。
Product string[] 可选 示例值：[ECS]
产品名称，默认不选为全部
BillCategory string[] 可选 示例值：[consume-use]
账单类型：consume-use：消费-使用；consume-new：消费-新购；consume-renew：消费-续费；consume-formalize：消费-转正；consume-modify：消费-更配；consume-trial：消费-试用；refund-terminate：退款-退订；refund-modify：退款-更配；transfer-manual：调账-人工；transfer-system：调账-系统；默认不选为全部
BillingMode string[] 可选 示例值：[1]
计费模式：1：包年包月，代表预付费；2：按量计费，代表后付费；3：合同计费，代表线下计费；4：履约计费；默认不选为全部；
AmortizedType string[] 可选 示例值：[1]
分摊类型：1：履约计费分摊；2：合同计费分摊；3：按量计费分摊；4：新购分摊；5：更配分摊；6：续费分摊；7：退订分摊；8：预留实例调整分摊；9：试用分摊；10：转正分摊；默认不选为全部
PayerID long[] 可选 示例值：[2100057673]
Payer账号ID
OwnerID long[] 可选 示例值：[2100057673]
Owner账号ID；财务托管场景下，不指定owner时主账号可获取自身及其下绑定所有owner子账号费用；选择owner后，可精准获取指定owner的账单费用；
TagKVFilterMode integer 可选 示例值：0
标签键值对筛选匹配模式。当传入多个 TagKV 条件时，用于控制条件之间的匹配逻辑。
- 0：任一匹配，满足任意一个标签键值对条件即可返回结果。
- 1：全部匹配，必须同时满足所有标签键值对条件才返回结果。
TagKV object[] 可选 示例值：[ { "Key":"k1", "Value":"v1" }, { "Key":"k2", "Value":"v2" } ]
标签，最大支持传递20个
Key string 可选 示例值：k1
标签键
Value string 可选 示例值：v1
标签值
Offset integer 可选 示例值：0
用于在分页查询中指定“从结果集的第几条记录开始返回”（也就是先跳过多少条记录），通常与 limit 搭配使用实现翻页：例如每页 limit=300 时，第 1 页传 offset=0 获取第 1–300 条，第 2 页传 offset=300 获取第 301–600 条，第 3 页传 offset=600 获取第 601–900 条；因此每往后一页，offset 按固定步长累加：offset = offset + limit（等价于 offset = (page-1) * limit）。
Limit integer 必选 示例值：10
数量：[1-300]，用于指定接口响应中返回记录的最大数量（上限），例如Limit=20表示每次请求最多返回20条
BillPeriod string 可选 示例值：2023-08
账务账期：格式为YYYY-MM；仅支持单月查询；所查账期至多距今 24 个月；最早只能查询2023-04
AmortizedMonth string 必选 示例值：2023-08
分摊月：格式为YYYY-MM；仅支持单月查询；所查分摊月至多距今 24 个月；最早只能查询2023-04；资源实际使用日期对应的自然月；如4月27日购买包月实例，根据实际使用日期分摊到了2025年5月1日，则该条成本明细的归属分摊月为2025年5月；
InstanceNo string 可选 示例值：i-ycjlq77tdg8rx6ib4v1s
实例id，默认不选为全部
IgnoreZero integer 可选 示例值：1
是否忽略折后价为0的数据：0：不忽略；1忽略；默认为不忽略
NeedRecordNum integer 可选 示例值：1
是否需要访问列表的总记录数：用于前端分页；1：表示需要； 0：表示不需要；默认为不需要，Total返回-1
返回参数
Warning string 示例值：The specified tags are not enabled for the current account. No data is available.
当请求可被处理但部分筛选条件被忽略、过滤或降级时返回；为空表示无提示。
List object[] 示例值：-
成本总览列表
DailyAmortizedOriginalBillAmount string 示例值：0.00
每日分摊-原始账单金额
DailyAmortizedPreferentialBillAmount string 示例值：0.00
每日分摊-优惠金额
DailyAmortizedRoundAmount string 示例值：0.00
每日分摊-抹零金额
DailyAmortizedDiscountBillAmount string 示例值：0.00
每日分摊-折后价
BeforeAmortizedOriginalBillAmount string 示例值：0.00
期初已分摊-原价
BeforeAmortizedPreferentialBillAmount string 示例值：0.00
期初已分摊-优惠金额
BeforeAmortizedRoundAmount string 示例值：0.00
期初已分摊-抹零金额
BeforeAmortizedDiscountBillAmount string 示例值：0.00
期初已分摊-折后价
NowAmortizedOriginalBillAmount string 示例值：0.00
本期已分摊-原价
NowAmortizedPreferentialBillAmount string 示例值：0.00
本期已分摊-优惠金额
NowAmortizedRoundAmount string 示例值：0.00
本期已分摊-抹零金额
NowAmortizedDiscountBillAmount string 示例值：0.00
本期已分摊-折后价
UnamortizedOriginalBillAmount string 示例值：0.00
未分摊-原价
UnamortizedPreferentialBillAmount string 示例值：0.00
未分摊-优惠金额
UnamortizedRoundAmount string 示例值：0.00
未分摊-抹零金额
UnamortizedDiscountBillAmount string 示例值：0.00
未分摊-折后价
DiscountBizUnitPrice string 示例值：1.3
优惠价格/折扣
DiscountBizUnitPriceInterval string 示例值：1,2,3
优惠价格区间
DiscountBizMeasureInterval string 示例值：0,100,200
优惠用量区间
EffectiveFactor string 示例值：1
有效因子
PriceInterval string 示例值：1,2,3
单价价格区间
MeasureInterval string 示例值：0,100,200
单价用量区间
BillingMethodCode string 示例值：按加和量小时结
计费方式
DiscountBizBillingFunction string 示例值：全额累进单价
代表优惠类型；当DiscountBizBillingFunction为固定单价和单一折扣时，优惠内容取DiscountBizUnitPrice字段；当DiscountBizBillingFunction为阶梯价时，单价取DiscountBizMeasureInterval和DiscountBizUnitPriceInterval字段，表达各个用量区间的不同优惠内容；
MarketPrice string 示例值：2.716
市场价
BillingFunction string 示例值：固定单价
代表单价价格类型；当BillingFunction为固定单价时，单价取Price字段；当BillingFunction为阶梯价时，单价取MeasureInterval和PriceInterval字段，表达各个用量区间的不同价格；
ProjectDisplayName string 示例值：默认项目
项目中文名
SplitItemID string 示例值：split_test_1
分拆项ID
SplitItemName string 示例值：split_test_1
分拆项名称
DeductionUseDuration string 示例值：1.0000000000
抵扣量
SavingPlanOriginalAmount string 示例值：242.857143
节省计划抵扣原价
DailyAmortizedSavingPlanOriginalAmount string 示例值：1.428571
每日分摊-节省计划抵扣原价
NowAmortizedSavingPlanOriginalAmount string 示例值：242.857143
本期已分摊-节省计划抵扣原价
BeforeAmortizedSavingPlanOriginalAmount string 示例值：242.857143
期初已分摊-节省计划抵扣原价
UnAmortizedSavingPlanOriginalAmount string 示例值：242.857143
未分摊-节省计划抵扣原价
CountryRegion string 示例值：cn
国家地区
PreTaxRealValue string 示例值：0.00
税前真实金额（定价币种）
PreTaxPayableAmount string 示例值：14.58
税前应付金额（定价币种）
PretaxAmount string 示例值：14.58
税前应付金额（定价币种）
Tax string 示例值：0.00
税额（定价币种）
SettlePreTaxRealValue string 示例值：0.00
税前真实金额（结算币种）
SettlePreTaxPayableAmount string 示例值：14.58
税前应付金额（结算币种）
SettlePretaxAmount string 示例值：14.58
税前应付金额（结算币种）
SettleTaxAmount string 示例值：0.00
税额（结算币种）
SettleRealValue string 示例值：0.00
税后真实金额（结算币种）
SettlePayableAmount string 示例值：14.58
税后应付金额（结算币种）
SettlePosttaxAmount string 示例值：14.58
税后应付金额（结算币种）
RealValue string 示例值：0.00
税后真实金额（定价币种）
PosttaxAmount string 示例值：14.58
税后应付金额（定价币种）
DailyAmortizedPreTaxRealValue string 示例值：0.00
每日分摊-税前真实金额（定价币种）
DailyAmortizedPreTaxPayableAmount string 示例值：14.58
每日分摊-税前应付金额（定价币种）
DailyAmortizedPretaxAmount string 示例值：14.58
每日分摊-税前应付金额（定价币种）
DailyAmortizedTaxAmount string 示例值：0.00
每日分摊-税额（定价币种）
DailyAmortizedSettlePreTaxRealValue string 示例值：0.00
每日分摊-税后真实金额（结算币种）
DailyAmortizedSettlePreTaxPayableAmount string 示例值：14.58
每日分摊-税前应付金额（结算币种）
DailyAmortizedSettlePretaxAmount string 示例值：14.58
每日分摊-税前应付金额（结算币种）
DailyAmortizedSettleTaxAmount string 示例值：0.00
每日分摊-税额（结算币种）
DailyAmortizedSettleRealValue string 示例值：0.00
每日分摊-税后真实金额（结算币种）
DailyAmortizedSettlePayableAmount string 示例值：14.58
每日分摊-税后应付金额（结算币种）
DailyAmortizedSettlePosttaxAmount string 示例值：14.58
每日分摊-税后应付金额（结算币种）
DailyAmortizedRealValue string 示例值：0.00
每日分摊-税后真实金额（定价币种）
DailyAmortizedPosttaxAmount string 示例值：14.58
每日分摊-税后应付金额（定价币种）
NowAmortizedPreTaxRealValue string 示例值：0.00
本期已分摊-税前真实金额（定价币种）
NowAmortizedPreTaxPayableAmount string 示例值：14.58
本期已分摊-税前应付金额（定价币种）
NowAmortizedPretaxAmount string 示例值：14.58
本期已分摊-税前应付金额（定价币种）
NowAmortizedTaxAmount string 示例值：0.00
本期已分摊-税额（定价币种）
NowAmortizedSettlePreTaxRealValue string 示例值：0.00
本期已分摊-税后真实金额（结算币种）
NowAmortizedSettlePreTaxPayableAmount string 示例值：14.58
本期已分摊-税前应付金额（结算币种）
NowAmortizedSettlePretaxAmount string 示例值：14.58
本期已分摊-税前应付金额（结算币种）
NowAmortizedSettleTaxAmount string 示例值：0.00
本期已分摊-税额（结算币种）
NowAmortizedSettleRealValue string 示例值：0.00
本期已分摊-税后真实金额（结算币种）
NowAmortizedSettlePayableAmount string 示例值：14.58
本期已分摊-税后应付金额（结算币种）
NowAmortizedSettlePosttaxAmount string 示例值：14.58
本期已分摊-税后应付金额（结算币种）
NowAmortizedRealValue string 示例值：0.00
本期已分摊-税后真实金额（定价币种）
NowAmortizedPosttaxAmount string 示例值：14.58
本期已分摊-税后应付金额（定价币种）
BeforeAmortizedPreTaxRealValue string 示例值：0.00
期初已分摊-税前真实金额（定价币种）
BeforeAmortizedPreTaxPayableAmount string 示例值：0.00
期初已分摊-税前应付金额（定价币种）
BeforeAmortizedPretaxAmount string 示例值：0.00
期初已分摊-税前应付金额（定价币种）
BeforeAmortizedTaxAmount string 示例值：0.00
期初已分摊-税额（定价币种）
BeforeAmortizedSettlePreTaxRealValue string 示例值：0.00
期初已分摊-税后真实金额（结算币种）
BeforeAmortizedSettlePreTaxPayableAmount string 示例值：0.00
期初已分摊-税前应付金额（结算币种）
BeforeAmortizedSettlePretaxAmount string 示例值：0.00
期初已分摊-税前应付金额（结算币种）
BeforeAmortizedSettleTaxAmount string 示例值：0.00
期初已分摊-税额（结算币种）
BeforeAmortizedSettleRealValue string 示例值：0.00
期初已分摊-税后真实金额（结算币种）
BeforeAmortizedSettlePayableAmount string 示例值：0.00
期初已分摊-税后应付金额（结算币种）
BeforeAmortizedSettlePosttaxAmount string 示例值：0.00
期初已分摊-税后应付金额（结算币种）
BeforeAmortizedRealValue string 示例值：0.00
期初已分摊-税后真实金额（定价币种）
BeforeAmortizedPosttaxAmount string 示例值：0.00
期初已分摊-税后应付金额（定价币种）
UnamortizedPreTaxRealValue string 示例值：0.00
未分摊-税前真实金额（定价币种）
UnamortizedPreTaxPayableAmount string 示例值：0.00
未分摊-税前应付金额（定价币种）
UnamortizedPretaxAmount string 示例值：0.00
未分摊-税前应付金额（定价币种）
UnamortizedTaxAmount string 示例值：0.00
未分摊-税额（定价币种）
UnamortizedSettlePreTaxRealValue string 示例值：0.00
未分摊-税后真实金额（结算币种）
UnamortizedSettlePreTaxPayableAmount string 示例值：0.00
未分摊-税前应付金额（结算币种）
UnamortizedSettlePretaxAmount string 示例值：0.00
未分摊-税前应付金额（结算币种）
UnamortizedSettleTaxAmount string 示例值：0.00
未分摊-税额（结算币种）
UnamortizedSettleRealValue string 示例值：0.00
未分摊-税后真实金额（结算币种）
UnamortizedSettlePayableAmount string 示例值：0.00
未分摊-税后应付金额（结算币种）
UnamortizedSettlePosttaxAmount string 示例值：0.00
未分摊-税后应付金额（结算币种）
UnamortizedRealValue string 示例值：0.00
未分摊-税后真实金额（定价币种）
UnamortizedPosttaxAmount string 示例值：0.00
未分摊-税后应付金额（定价币种）
CurrencySettlement string 示例值：CNY
结算币种
TaxRate string 示例值：0.00
税率
MainContractNumber string 示例值：order12312312312
合同号
OriginalOrderNo string 示例值：order12312312312
原订单号
ResourceID string 示例值：order12312312312
资源ID
ChargeItemCode string 示例值：hourly_sum
计费项Code
ConfigurationCode string 示例值：ecs.g1.large
配置Code
PointDeductAmount string 示例值：0.00
积分抵扣金额
DailyAmortizedPointDeductAmount string 示例值：0.00
每日分摊-积分抵扣金额
NowAmortizedPointDeductAmount string 示例值：0.00
本期已分摊-积分抵扣金额
BeforeAmortizedPointDeductAmount string 示例值：0.00
期初已分摊-积分抵扣金额
UnamortizedPointDeductAmount string 示例值：0.00
未分摊-积分抵扣金额
BillPeriod string 示例值：2023-08
账务账期
BusiPeriod string 示例值：2023-08
业务账期
PayerID string 示例值：2100153894
支付账号ID
PayerUserName string 示例值：Doooo
支付账号名
PayerCustomerName string 示例值：北京火山引擎科技有限公司
支付账号客户名称
SellerID string 示例值：3423
Seller账号ID
SellerUserName string 示例值：火山引擎
Seller账号名
SellerCustomerName string 示例值：北京火山引擎科技有限公司
Seller账号客户名称
AmortizedMonth string 示例值：2023-08
分摊月：资源实际使用日期对应的自然月；如4月27日购买包月实例，根据实际使用日期分摊到了2025年5月1日，则该条成本明细的归属分摊月为2025年5月；
InstanceNo string 示例值：i-ycjlq77tdg8rx6ib4v1s
云产品计费实例id，承载购买的云资源或资产的计费实体；
Factor string 示例值：{"type":"zanya"}
影响因子
InstanceName string 示例值：ECS-fEaG
实例名称
Element string 示例值：ecs.g3i
计费单元
Region string 示例值：华北2（北京)
地域
Zone string 示例值：可用区北京B
可用区
ExpandField string 示例值：type-large
扩展字段
ExpenseTime string 示例值：2033-08-08 00:00:00-2036-08-07 23:59:59
消费时间
Price string 示例值：0.52
单价
PriceUnit string 示例值：台/时
单价单位
Count string 示例值：1.00
用量
Unit string 示例值：台
用量单位
UseDuration string 示例值：864000
使用时长
UseDurationUnit string 示例值：秒
使用时长单位
AmortizedDayNum string 示例值：10
已分摊天数
BillID string 示例值：Bill7271090921067712812
预付费账单为订单号，否则为账单号
OwnerID string 示例值：2100153894
Owner账号ID
OwnerUserName string 示例值：Doooo
Owner账号名
OwnerCustomerName string 示例值：北京火山引擎科技有限公司
Owner账号客户名称
Product string 示例值：ECS
产品英文名称
ProductZh string 示例值：云服务器
产品中文名称
ConfigName string 示例值：低配
配置名称
BusinessMode string 示例值：普通业务
业务类型
BillingMode string 示例值：按量计费
计费模式：1：包年包月，代表预付费；2：按量计费，代表后付费；3：合同计费，代表线下计费；4：履约计费；
BillCategory string 示例值：消费-使用
账单类型
AmortizedType string 示例值：按量计费分摊
分摊类型
AmortizedBeginTime string 示例值：2023-08-01 00:00:00
分摊开始时间，格式：2023-04-02 00:00:00
AmortizedEndTime string 示例值：2023-08-11 00:00:00
分摊结束时间，格式：2023-04-02 23:59:59
DailyAmortizedPayableAmount string 示例值：0.00
每日分摊-应付金额
SubjectName string 示例值：北京火山引擎科技有限公司
主体名
Tag string 示例值：{"voKey1":["v1"],"voKey101":["v5"],"voKey2":["v2"],"volc:vke:cluster-id":["valu3"],"volc:vke:createdby-vke-flag":["valu4"],"volc:vke:used-by-vke-cluster":["value5"]}
标签：资源实例的标识；同一资源可绑定多个标签键值对，如资源创建者、资源使用部门、资源应用系统或环境等来标识资源费用信息；取值为结算周期的最后一小时内资源实例存在过的标签信息；按天/账期聚合时，标签展示为最新的标签；
BeforeAmortizedCouponAmount string 示例值：0.00
期初已分摊-代金券抵扣
Project string 示例值：default
项目：资源实例所属的项目信息，通常可定义为企业内部的部门、业务线等以便厘清成本归属与进行分账管理；取值为结算周期所在小时末实例所属的项目；按天/账期聚合时，项目展示为最新的项目；
Currency string 示例值：CNY
币种
UnamortizedPayableAmount string 示例值：0.00
未分摊-应付金额
UnamortizedCouponAmount string 示例值：0.00
未分摊-代金券抵扣
NowAmortizedPayableAmount string 示例值：14.58
本期已分摊-应付金额
NowAmortizedCouponAmount string 示例值：0.00
本期已分摊-代金券抵扣
BeforeAmortizedPayableAmount string 示例值：0.00
期初已分摊-应付金额
DailyAmortizedCouponAmount string 示例值：0.00
每日分摊-代金券抵扣
OriginalBillAmount string 示例值：200.0
原价
PreferentialBillAmount string 示例值：0.0
优惠金额
RoundAmount string 示例值：0.0
抹零金额
DiscountBillAmount string 示例值：200.0
折后价
PayableAmount string 示例值：14.58
应付金额
CouponAmount string 示例值：0.00
代金券抵扣
Total integer 示例值：100
总数，默认返回-1（NeedRecordNum=0时）
Limit integer 示例值：100
步长
Offset integer 示例值：0
偏移量
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParam | The parameter [AmortizedMonth] is missing. | -- |
400 | RequestInvalid | Request Invalid | |
500 | InternalError | Service has some internal Error. Pls Contact With Admin. |
最近更新时间：2026.09.18 15:02:25
这个页面对您有帮助吗？
有用
有用
无用
无用