费用中心
费用中心
文档指南
请输入
- 文档首页
费用中心API参考账单管理ListAmortizedCostBillDetail - 查询成本账单明细
复制全文
下载 pdfListAmortizedCostBillDetail - 查询成本账单明细
文档反馈
问问助手注意事项
- 查询QPS限制为5QPS，超过限流将报错；
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListAmortizedCostBillDetail
要执行的操作，取值：ListAmortizedCostBillDetail。
Version string 必选 示例值：2022-01-01
API的版本，取值：2022-01-01。
BillCategory string[] 可选 示例值：[consume-use]
账单类型：consume-use：消费-使用；consume-new：消费-新购；consume-renew：消费-续费；consume-formalize：消费-转正；consume-modify：消费-更配；consume-trial：消费-试用；refund-terminate：退款-退订；refund-modify：退款-更配；transfer-manual：调账-人工；transfer-system：调账-系统；默认不选为全部
AmortizedType string[] 可选 示例值：[1]
分摊类型：1：履约计费分摊；2：合同计费分摊；3：按量计费分摊；4：新购分摊；5：更配分摊；6：续费分摊；7：退订分摊；8：预留实例调整分摊；9：试用分摊；10：转正分摊；默认不选为全部
Product string[] 可选 示例值：[ECS]
产品名称，默认不选为全部
BillingMode string[] 可选 示例值：[1]
计费模式：1：包年包月，代表预付费；2：按量计费，代表后付费；3：合同计费，代表线下计费；4：履约计费；默认不选为全部；
PayerID long[] 可选 示例值：[2100057673]
Payer账号ID
OwnerID long[] 可选 示例值：[2100057673]
Owner账号ID；财务托管场景下，不指定owner时主账号可获取自身及其下绑定所有owner子账号费用；选择owner后，可精准获取指定owner的账单费用；
Project string[] 可选 示例值：["project1","peoject2"]
项目筛选
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 可选 示例值：10
用于在分页查询中指定“从结果集的第几条记录开始返回”（也就是先跳过多少条记录），通常与 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
AmortizedDay string 可选 示例值：2023-08-01
分摊日：格式为YYYY-MM-DD；仅支持单日查询；最早只能查询2023-04-01。该参数可提升查询性能，建议填写。
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[] 示例值：-
成本明细列表
ExpandField string 示例值：type-large
扩展字段
PayerUserName string 示例值：Doooo
支付账号名
BillPeriod string 示例值：2023-08
账务账期
AmortizedDay string 示例值：分摊日
2023-08-01
BusiPeriod string 示例值：2023-08
业务账期
PayerID string 示例值：2100153894
支付账号ID
ExpenseBeginTime string 示例值：2023-08-01 00:00:00
消费开始时间，格式：2023-03-02 15:04:05
PayerCustomerName string 示例值：北京火山引擎科技有限公司
支付账号客户名称
SellerID string 示例值：3423
Seller账号ID
SellerUserName string 示例值：火山引擎
Seller账号名
SellerCustomerName string 示例值：北京火山引擎科技有限公司
Seller账号客户名称
OwnerID string 示例值：2100153894
Owner账号ID
OwnerUserName string 示例值：Doooo
Owner账号名
OwnerCustomerName string 示例值：北京火山引擎科技有限公司
Owner账号客户名称
Product string 示例值：ECS
产品英文名称
ProductZh 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-01 01:00:00
分摊结束时间，格式：2023-04-02 23:59:59
BillID string 示例值：Bill7262035879529697551
预付费账单为订单号，否则为账单号
InstanceNo string 示例值：i-ycjlq77tdg8rx6ib4v1s
云产品计费实例id，承载购买的云资源或资产的计费实体；
Element string 示例值：ecs.g3i
计费单元
ExpenseEndTime string 示例值：2023-08-01 01:00:00
消费结束时间，格式：2023-04-02 23:59:59
PayableAmount string 示例值：2.99
应付金额
Factor string 示例值：{"type":"zanya"}
影响因子
Zone string 示例值：可用区北京B
可用区
AmortizedMonth string 示例值：2023-08
分摊月：资源实际使用日期对应的自然月；如4月27日购买包月实例，根据实际使用日期分摊到了2025年5月1日，则该条成本明细的归属分摊月为2025年5月；
Region string 示例值：华北2（北京)
地域
TradeTime string 示例值：2023-08-01 01:28:14
交易时间，格式：2006-01-02 15:04:05
PriceUnit string 示例值：台/时
单价单位
Count string 示例值：1.00
用量
Unit string 示例值：台
用量单位
UseDuration string 示例值：3600
使用时长
UseDurationUnit string 示例值：秒
使用时长单位
CouponAmount string 示例值：0.00
代金券抵扣
DailyAmortizedCouponAmount string 示例值：0.00
每日分摊-代金券抵扣
DailyAmortizedPayableAmount string 示例值：0.07
每日分摊-应付金额
Project string 示例值：default
项目：资源实例所属的项目信息，通常可定义为企业内部的部门、业务线等以便厘清成本归属与进行分账管理；取值为结算周期所在小时末实例所属的项目；按天/账期聚合时，项目展示为最新的项目；
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"]}
标签：资源实例的标识；同一资源可绑定多个标签键值对，如资源创建者、资源使用部门、资源应用系统或环境等来标识资源费用信息；取值为结算周期的最后一小时内资源实例存在过的标签信息；按天/账期聚合时，标签展示为最新的标签；
SubjectName string 示例值：北京火山引擎科技有限公司
主体名
Price string 示例值：0.52
单价
Currency string 示例值：CNY
币种
InstanceName string 示例值：ECS-fEaG
实例名称
CostID string 示例值：Cost7265731716064792869
成本账单明细业务主键
ConfigName string 示例值：低配
配置名称
OriginalBillAmount string 示例值：200.0
原价
PreferentialBillAmount string 示例值：0.0
有优惠金额
RoundAmount string 示例值：0.0
抹零金额
DiscountBillAmount string 示例值：200.0
折后价
DailyAmortizedOriginalBillAmount string 示例值：0.00
每日分摊-原价
DailyAmortizedPreferentialBillAmount string 示例值：0.00
每日分摊-优惠金额
DailyAmortizedRoundAmount string 示例值：0.00
每日分摊-抹零金额
DailyAmortizedDiscountBillAmount 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
抵扣量
PreTaxPayableAmount string 示例值：2.76
税前应付金额
TaxAmount string 示例值：0.23
税额
DailyAmortizedPreTaxPayableAmount string 示例值：0.08
每日分摊税前应付金额
DailyAmortizedTaxAmount string 示例值：0.01
每日分摊税额
SettlePreTaxPayableAmount string 示例值：0.08
税前应付金额-结算币种
DailyAmortizedSettlePreTaxPayableAmount string 示例值：0.08
每日分摊税前应付金额-结算币种
SettlePayableAmount string 示例值：0.08
应付金额-结算币种
DailyAmortizedSettlePayableAmount string 示例值：0.09
每日分摊应付金额-结算币种
SettleTaxAmount string 示例值：7.1805000000
税额-结算币种
DailyAmortizedSettleTaxAmount string 示例值：0.08
每日分摊税前税额
CountryArea string 示例值：SG
国家地区
TaxRate string 示例值：0.090000
税率
ExchangeRate string 示例值：7.1805000000
汇率
RealValue string 示例值：2.76
真实价值
PreTaxRealValue string 示例值：2.76
税前真实价值
DailyAmortizedRealValue string 示例值：0.09
每日分摊真实价值
DailyAmortizedPreTaxRealValue string 示例值：0.08
每日分摊税前真实价值
SettleRealValue string 示例值：2.99
结算币种真实价值
SettlePreTaxRealValue string 示例值：2.76
结算币种税前真实价值
DailyAmortizedSettleRealValue string 示例值：0.09
每日分摊结算币种真实价值
DailyAmortizedSettlePreTaxRealValue string 示例值：0.08
每日分摊结算币种税前真实价值
SavingPlanOriginalAmount string 示例值：42.857143
节省计划抵扣原价
SavingPlanDeductionSpID string 示例值：Spn-2000000036683109888
节省计划实例ID
SavingPlanDeductionDiscountAmount string 示例值：30.000000
节省计划抵扣金额
DailyAmortizedSavingPlanOriginalAmount string 示例值：42.857143
每日分摊-节省计划抵扣原价
DiscountInfo string 示例值：合同价：单一折扣,0.7,CN202505201929261
优惠信息
PosttaxAmount string 示例值：2.99
税后应付金额（定价币种）
DailyAmortizedPosttaxAmount string 示例值：0.07
每日分摊-税后应付金额（定价币种）
PretaxAmount string 示例值：2.99
税前应付金额（定价币种）
DailyAmortizedPretaxAmount string 示例值：0.07
每日分摊-税前应付金额（定价币种）
SettlePretaxAmount string 示例值：2.99
税前应付金额（结算币种）
DailyAmortizedSettlePretaxAmount string 示例值：0.07
每日分摊-税前应付金额（结算币种）
SettlePosttaxAmount string 示例值：2.99
税后应付金额（结算币种）
DailyAmortizedSettlePosttaxAmount string 示例值：0.07
每日分摊-税后应付金额（结算币种）
CurrencySettlement string 示例值：CNY
结算币种
CountryRegion string 示例值：cn
国家地区
Tax string 示例值：0.23
税额
MainContractNumber string 示例值：order12312312312
合同号
OriginalOrderNo string 示例值：order12312312312
原订单号
ResourceID string 示例值：order12312312312
资源ID
ChargeItemCode string 示例值：hourly_sum
计费项code
ConfigurationCode string 示例值：ecs.g1.large
配置Code
TagRemark string 示例值：""
标签备注
ProjectRemark string 示例值：""
项目备注
PointDeductAmount string 示例值：0.00
积分抵扣金额
DailyAmortizedPointDeductAmount string 示例值：0.00
每日分摊-积分抵扣金额
Total integer 示例值：100
总数，默认返回-1（NeedRecordNum=0时）
Limit integer 示例值：10
步长
Offset integer 示例值：0
偏移量
请求示例
返回示例
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidParameter | The specified parameter body is invalid. | -- |
400 | RequestInvalid | Request Invalid | |
500 | InternalError | Service has some internal Error. Pls Contact With Admin. | 服务内部异常 |
最近更新时间：2026.09.18 15:02:25
这个页面对您有帮助吗？
有用
有用
无用
无用