You need to enable JavaScript to run this app.
文档中心
费用中心

费用中心

复制全文
下载 pdf
账单管理
ListAmortizedCostBillDaily - 查询成本账单按天
复制全文
下载 pdf
ListAmortizedCostBillDaily - 查询成本账单按天
提供基于资源实际使用周期的分摊账单并按分摊日聚合,如将包年包月订单费用分摊到实际生效周期的每一日;如需使用请及时开通,未开通时不提供成本分摊数据;相比账单明细存在2天延迟;了解更多详情可查看成本账单说明;​
注意事项​
  1. 查询QPS限制为5QPS,超过限流将报错;​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
注意​
为了提升查询效率和成功率,您可使用分摊日"AmortizedDay"指定获取某日数据;​
Action string 必选 示例值:ListAmortizedCostBillDaily​
要执行的操作,取值:ListAmortizedCostBillDaily。​
​
Version string 必选 示例值:2022-01-01​
API的版本,取值:2022-01-01。​
​
BillingMode string[] 可选 示例值:[1]​
计费模式:1:包年包月,代表预付费;2:按量计费,代表后付费;3:合同计费,代表线下计费;4:履约计费;默认不选为全部;​
​
AmortizedType string[] 可选 示例值:[1]​
分摊类型:1:履约计费分摊;2:合同计费分摊;3:按量计费分摊;4:新购分摊;5:更配分摊;6:续费分摊;7:退订分摊;8:预留实例调整分摊;9:试用分摊;10:转正分摊;默认不选为全部​
​
AmortizedDay string 可选 示例值:2023-10-01​
分摊日:格式为YYYY-MM-DD;仅支持单日查询;最早只能查询2023-04-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:调账-系统;默认不选为全部​
​
PayerID long[] 可选 示例值:[2100057673]​
Payer账号ID​
​
OwnerID long[] 可选 示例值:[2100057673]​
Owner账号ID;财务托管场景下,不指定owner时主账号可获取自身及其下绑定所有owner子账号费用;选择owner后,可精准获取指定owner的账单费用;​
​
TagKV object[] 可选 示例值:[ { "Key":"k1", "Value":"v1" }, { "Key":"k2", "Value":"v2" } ]​
标签,最大支持传递20个​
Key string 可选 示例值:k1​
标签键​
​
Value string 可选 示例值:v1​
标签值​
​
​
TagKVFilterMode integer 可选 示例值:0​
标签键值对筛选匹配模式。当传入多个 TagKV 条件时,用于控制条件之间的匹配逻辑。​
  • 0:任一匹配,满足任意一个标签键值对条件即可返回结果。​
  • 1:全部匹配,必须同时满足所有标签键值对条件才返回结果。​
​
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,默认不选为全部;云产品计费实例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[] 示例值:-​
成本明细按天列表​
NowAmortizedRoundAmount string 示例值:0.00​
本日已分摊-抹零金额​
​
AmortizedDay string 示例值:2023-10-01​
分摊日​
​
DailyAmortizedRoundAmount string 示例值:0.00​
每日分摊-抹零金额​
​
DailyAmortizedDiscountBillAmount string 示例值:0.00​
每日分摊-折后价​
​
BillingMethodCode string 示例值:按加和量小时结​
计费方式​
​
NowAmortizedOriginalBillAmount string 示例值:0.00​
本日已分摊-原价​
​
DailyAmortizedOriginalBillAmount string 示例值:0.00​
每日分摊-原始账单金额​
​
FactorCode string 示例值:type:ESSD_PL0​
影响因子Code​
​
NowAmortizedPreferentialBillAmount string 示例值:0.00​
本日已分摊-优惠金额​
​
ExpenseTime string 示例值:2033-08-08 00:00:00-2036-08-07 23:59:59​
消费时间​
​
DailyAmortizedPreferentialBillAmount string 示例值:0.00​
每日分摊-优惠金额​
​
ConfigurationCode string 示例值:ecs.g1.large​
配置Code​
​
ElementCode string 示例值:BE000137​
计费单元Code​
​
RegionCode string 示例值:R000671​
地域Code​
​
NowAmortizedDiscountBillAmount string 示例值:0.00​
本日已分摊-折后价​
​
ZoneCode string 示例值:Zone1​
可用区Code​
​
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 示例值:类型-ESSD_PL0​
影响因子​
​
InstanceName string 示例值:ECS-fEaG​
实例名称​
​
Element string 示例值:ecs.g3i​
计费单元​
​
Region string 示例值:华北2(北京)​
地域​
​
Zone string 示例值:可用区北京B​
可用区​
​
ExpandField string 示例值:type-large​
扩展字段​
​
Price string 示例值:0.52​
单价​
​
PriceUnit string 示例值:台/时​
单价单位​
​
Count string 示例值:1.00​
用量​
​
Unit string 示例值:台​
用量单位​
​
UseDuration string 示例值:864000​
使用时长​
​
UseDurationUnit string 示例值:秒​
使用时长单位​
​
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"]}​
标签:资源实例的标识;同一资源可绑定多个标签键值对,如资源创建者、资源使用部门、资源应用系统或环境等来标识资源费用信息;取值为结算周期的最后一小时内资源实例存在过的标签信息;按天/账期聚合时,标签展示为最新的标签;​
​
Project string 示例值:default​
项目:资源实例所属的项目信息,通常可定义为企业内部的部门、业务线等以便厘清成本归属与进行分账管理;取值为结算周期所在小时末实例所属的项目;按天/账期聚合时,项目展示为最新的项目;​
​
Currency string 示例值:CNY​
币种​
​
NowAmortizedPayableAmount string 示例值:14.58​
本日已分摊-应付金额​
​
NowAmortizedCouponAmount 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​
代金券抵扣​
​
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​
本日已分摊-节省计划抵扣原价​
​
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​
本日已分摊-税后应付金额(定价币种)​
​
CurrencySettlement string 示例值:CNY​
结算币种​
​
EffectiveFactor string 示例值:1​
有效因子​
​
TaxRate string 示例值:0.00​
税率​
​
MainContractNumber string 示例值:order12312312312​
合同号​
​
OriginalOrderNo string 示例值:order12312312312​
原订单号​
​
BillingFunction string 示例值:固定单价​
代表单价价格类型;当BillingFunction为固定单价时,单价取Price字段;当BillingFunction为阶梯价时,单价取MeasureInterval和PriceInterval字段,表达各个用量区间的不同价格;​
​
DiscountBizBillingFunction string 示例值:全额累进单价​
代表优惠类型;当DiscountBizBillingFunction为固定单价和单一折扣时,优惠内容取DiscountBizUnitPrice字段;当DiscountBizBillingFunction为阶梯价时,单价取DiscountBizMeasureInterval和DiscountBizUnitPriceInterval字段,表达各个用量区间的不同优惠内容;​
​
ResourceID string 示例值:order12312312312​
资源ID​
​
ChargeItemCode string 示例值:hourly_sum​
计费项Code​
​
PointDeductAmount string 示例值:0.00​
积分抵扣金额​
​
DailyAmortizedPointDeductAmount string 示例值:0.00​
每日分摊-积分抵扣金额​
​
NowAmortizedPointDeductAmount string 示例值:0.00​
本日已分摊-积分抵扣金额​
​
​
Total integer 示例值:100​
总数,默认返回-1(NeedRecordNum=0时)​
​
Limit integer 示例值:100​
步长​
​
Offset integer 示例值:0​
偏移量​
​
​
​
请求示例​
​
// 以下示例不包含签名,建议直接使用API Explorer或下载SDK调试。​
curl --location 'https://open.volcengineapi.com?Action=ListAmortizedCostBillDaily&Version=2022-01-01' \​
--header 'AccessKey: AK***mE' \​
--header 'SecretKey: T0***RQ==' \​
--header 'Region: cn-north-1' \​
--header 'ServiceName: billing' \​
--header 'Content-Type: application/json' \​
--header 'User-Agent: volcengine-go-sdk' \​
--data '{​
"AmortizedMonth": "2024-01",​
"Limit": 10,​
"Offset": 0,​
"NeedRecordNum": 1,​
"IgnoreZero": 0​
}'​
​
返回示例​
​
{​
"ResponseMetadata":{​
"RequestId":"202302151509010207BA7B59BCEA6513BD",​
"Action":"ListAmortizedCostBillDaily",​
"Version":"2022-01-01",​
"Service":"billing",​
"Region":"cn-north-1"​
},​
"Result":{​
"List": [​
{​
"AmortizedMonth": "2024-01",​
"AmortizedDay": "2024-01-30",​
"BillPeriod": "2024-01",​
"BusiPeriod": "2024-01",​
"PayerID": "2100058101",​
"PayerUserName": "yangjie-boe",​
"PayerCustomerName": "北京火山引擎科技有限公司",​
"SellerID": "3423",​
"SellerUserName": "火山引擎",​
"SellerCustomerName": "北京火山引擎科技有限公司",​
"OwnerID": "2100058101",​
"OwnerUserName": "yangjie-boe",​
"OwnerCustomerName": "北京火山引擎科技有限公司",​
"Product": "volume",​
"ProductZh": "弹性块存储",​
"BusinessMode": "普通业务",​
"BillingMode": "包年包月",​
"BillCategory": "退款-更配",​
"AmortizedType": "更配分摊",​
"AmortizedBeginTime": "2024-01-30 00:00:00",​
"AmortizedEndTime": "2024-01-30 23:59:59",​
"BillID": "Order7324986498372960300",​
"InstanceNo": "vol-3ve6goftbz48s2m0nokj",​
"InstanceName": "vol-3ve6goftbz48s2m0nokj",​
"Element": "EBS数据盘",​
"Region": "中国台湾-容灾演练",​
"Zone": "可用区A-东湾",​
"Factor": "类型-ESSD_PL0",​
"ExpandField": "-",​
"Price": "0.50",​
"PriceUnit": "GiB",​
"Count": "30.00",​
"Unit": "GiB",​
"UseDuration": "-1",​
"UseDurationUnit": "-",​
"CouponAmount": "0.00",​
"PayableAmount": "-14.26",​
"PaidAmount": "-14.26",​
"DailyAmortizedCouponAmount": "0.00",​
"DailyAmortizedPayableAmount": "-0.44",​
"DailyAmortizedOriginalBillAmount": "-0.445625",​
"DailyAmortizedPreferentialBillAmount": "0.000000",​
"DailyAmortizedRoundAmount": "0.000000",​
"DailyAmortizedDiscountBillAmount": "-0.44",​
"DailyAmortizedPaidAmount": "-0.44",​
"NowAmortizedCouponAmount": "0.00",​
"NowAmortizedPayableAmount": "-0.44",​
"NowAmortizedOriginalBillAmount": "-0.445625",​
"NowAmortizedPreferentialBillAmount": "0.000000",​
"NowAmortizedRoundAmount": "0.000000",​
"NowAmortizedDiscountBillAmount": "-0.44",​
"NowAmortizedPaidAmount": "-0.44",​
"Currency": "CNY",​
"Project": "-",​
"Tag": "{\"volc:ecs:linkedresource\":[\"trn:ecs:cn-taiwan-boe:2100058101:instance/i-ycwwh2qha845nhw2ys1d\"]}",​
"SubjectName": "北京火山引擎科技有限公司",​
"ConfigName": "数据盘-极速型SSD-PL0-包年包月",​
"OriginalBillAmount": "-14.260000",​
"PreferentialBillAmount": "0.000000",​
"RoundAmount": "0.000000",​
"DiscountBillAmount": "-14.26",​
"ExpenseTime": "2024-01-17 17:01:07-2024-02-17 23:59:59",​
"BillingMethodCode": "包月",​
"ElementCode": "BE001550",​
"RegionCode": "R004564",​
"ZoneCode": "cn-taiwan-boe-a",​
"FactorCode": "type:ESSD_PL0",​
"ConfigurationCode": "data-EBS_ESSD_PL0.month",​
"ProjectDisplayName": "默认项目"​
}​
],​
"Total":74,​
"Limit":10,​
"Offset":0​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidParam​
The parameter [AmortizedDay] is invalid.​
--​
400​
InvalidParameter​
The specified parameter body is invalid.​
​
500​
InternalError​
Service has some internal Error. Pls Contact With Admin.​
服务内部异常​
​
​
最近更新时间:2026.09.18 15:02:25
这个页面对您有帮助吗?
有用
有用
无用
无用