提供基于资源实际使用周期的分摊账单并按分摊日聚合，如将包年包月订单费用分摊到实际生效周期的每一日；如需使用请及时[开通](https://console.volcengine.com/finance/bill/cost-bill)，未开通时不提供成本分摊数据；相比账单明细存在2天延迟；了解更多详情可查看[成本账单](https://www.volcengine.com/docs/6269/1112862?lang=zh)说明； ## 注意事项 1. 查询QPS限制为5QPS，超过限流将报错； ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=ListAmortizedCostBillDaily&groupName=%E8%B4%A6%E5%8D%95%E4%B8%AD%E5%BF%83&serviceCode=billing&version=2022-01-01) ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。

注意

为了提升查询效率和成功率，您可使用分摊日"AmortizedDay"指定获取某日数据；

**Action** string 必选 `示例值：ListAmortizedCostBillDaily` 要执行的操作，取值：ListAmortizedCostBillDaily。 **Version** string 必选 `示例值：2022-01-01` API的版本，取值：2022\-01\-01。 **AmortizedType** string[] `可选` `示例值：[1]` 分摊类型：1：履约计费分摊；2：合同计费分摊；3：按量计费分摊；4：新购分摊；5：更配分摊；6：续费分摊；7：退订分摊；8：预留实例调整分摊；9：试用分摊；10：转正分摊；默认不选为全部 **BillingMode** string[] `可选` `示例值：[1]` 计费模式：1：包年包月，代表预付费；2：按量计费，代表后付费；3：合同计费，代表线下计费；4：履约计费；默认不选为全部； **BillCategory** string[] `可选` `示例值：[consume-use]` 账单类型：consume\-use：消费\-使用；consume\-new：消费\-新购；consume\-renew：消费\-续费；consume\-formalize：消费\-转正；consume\-modify：消费\-更配；consume\-trial：消费\-试用；refund\-terminate：退款\-退订；refund\-modify：退款\-更配；transfer\-manual：调账\-人工；transfer\-system：调账\-系统；默认不选为全部 **Product** string[] `可选` `示例值：[ECS]` 产品名称，默认不选为全部 **AmortizedDay** string `可选` `示例值：2023-10-01` 分摊日：格式为YYYY\-MM\-DD；仅支持单日查询；最早只能查询2023\-04\-01。该参数可提升查询性能，建议填写。 **PayerID** long[] `可选` `示例值：[2100057673]` Payer账号ID **OwnerID** long[] `可选` `示例值：[2100057673]` Owner账号ID；财务托管场景下，不指定owner时主账号可获取自身及其下绑定所有owner子账号费用；选择owner后，可精准获取指定owner的账单费用； **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 ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336) **List** object[] `示例值：-` 成本明细按天列表 **NowAmortizedRoundAmount** string `示例值：0.00` 本日已分摊\-抹零金额 **AmortizedDay** string `示例值：2023-10-01` 分摊日 **DailyAmortizedRoundAmount** string `示例值：0.00` 每日分摊\-抹零金额 **DailyAmortizedDiscountBillAmount** string `示例值：0.00` 每日分摊\-折后价 **DailyAmortizedPaidAmount** string `示例值：0.00` 每日分摊\-现金支付 **BillingMethodCode** string `示例值：按加和量小时结` 计费方式 **NowAmortizedOriginalBillAmount** string `示例值：0.00` 本日已分摊\-原价 **DailyAmortizedOriginalBillAmount** string `示例值：0.00` 每日分摊\-原始账单金额 **FactorCode** string `示例值：type:ESSD_PL0` 影响因子Code **NowAmortizedPaidAmount** string `示例值：0.00` 本日已分摊\-现金支付 **PaidAmount** string `示例值：0.00` 现金支付 **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 `示例值：默认项目` 项目中文名 **DeductionUseDuration** string `示例值：1.0000000000` 抵扣量 **SplitItemID** string `示例值：split_test_1` 分拆项ID **SplitItemName** string `示例值：split_test_1` 分拆项名称 **SavingPlanOriginalAmount** string `示例值：242.857143` 节省计划抵扣原价 **DailyAmortizedSavingPlanOriginalAmount** string `示例值：1.428571` 每日分摊\-节省计划抵扣原价 **NowAmortizedSavingPlanOriginalAmount** string `示例值：242.857143` 本日已分摊\-节省计划抵扣原价 **CountryRegion** string 国家地区 **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 合同号 **OriginalOrderNo** string 原订单号 **BillingFunction** string `示例值：固定单价` 代表单价价格类型；当BillingFunction为固定单价时，单价取Price字段；当BillingFunction为阶梯价时，单价取MeasureInterval和PriceInterval字段，表达各个用量区间的不同价格； **DiscountBizBillingFunction** string `示例值：全额累进单价` 代表优惠类型；当DiscountBizBillingFunction为固定单价和单一折扣时，优惠内容取DiscountBizUnitPrice字段；当DiscountBizBillingFunction为阶梯价时，单价取DiscountBizMeasureInterval和DiscountBizUnitPriceInterval字段，表达各个用量区间的不同优惠内容； **ResourceID** string 资源ID **ChargeItemCode** string `示例值：hourly_sum` 计费项Code **PointDeductAmount** string 积分抵扣金额 **DailyAmortizedPointDeductAmount** string `示例值：0.00` 每日分摊\-积分抵扣金额 **NowAmortizedPointDeductAmount** string `示例值：0.00` 本日已分摊\-积分抵扣金额 **Total** integer `示例值：100` 总数，默认返回\-1（NeedRecordNum=0时） **Limit** integer `示例值：100` 步长 **Offset** integer `示例值：0` 偏移量 ## 请求示例 ```text // 以下示例不包含签名，建议直接使用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 }' ``` ## 返回示例 ```json { "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 } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |InvalidParameter |The specified parameter body is invalid. | | |400 |InvalidParam |The parameter [AmortizedDay] is invalid. |\-\- | |500 |InternalError |Service has some internal Error. Pls Contact With Admin. |服务内部异常 |

费用中心