提供基于资源实际使用周期的分摊账单，如将包年包月订单费用分摊到实际生效周期的每一日；如需使用请及时[开通](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=ListAmortizedCostBillDetail&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)。 **Action** string 必选 `示例值：ListAmortizedCostBillDetail` 要执行的操作，取值：ListAmortizedCostBillDetail。 **Version** string 必选 `示例值：2022-01-01` API的版本，取值：2022\-01\-01。 **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：调账\-系统；默认不选为全部 **AmortizedType** string[] `可选` `示例值：[1]` 分摊类型：1：履约计费分摊；2：合同计费分摊；3：按量计费分摊；4：新购分摊；5：更配分摊；6：续费分摊；7：退订分摊；8：预留实例调整分摊；9：试用分摊；10：转正分摊；默认不选为全部 **Product** string[] `可选` `示例值：[ECS]` 产品名称，默认不选为全部 **PayerID** long[] `可选` `示例值：[2100057673]` Payer账号ID **OwnerID** long[] `可选` `示例值：[2100057673]` Owner账号ID；财务托管场景下，不指定owner时主账号可获取自身及其下绑定所有owner子账号费用；选择owner后，可精准获取指定owner的账单费用； **Project** string[] `可选` `示例值：["project1","peoject2"]` 项目筛选 **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 ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336) **List** object[] `示例值：-` 成本明细列表 **CostID** string `示例值：Cost7265731716064792869` 成本账单明细业务主键 **AmortizedMonth** string `示例值：2023-08` 分摊月：资源实际使用日期对应的自然月；如4月27日购买包月实例，根据实际使用日期分摊到了2025年5月1日，则该条成本明细的归属分摊月为2025年5月； **BillPeriod** string `示例值：2023-08` 账务账期 **AmortizedDay** string `示例值：分摊日` 2023\-08\-01 **BusiPeriod** string `示例值：2023-08` 业务账期 **PayerID** string `示例值：2100153894` 支付账号ID **PayerUserName** string `示例值：Doooo` 支付账号名 **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` 计费单元 **Region** string `示例值：华北2（北京)` 地域 **Zone** string `示例值：可用区北京B` 可用区 **Factor** string `示例值：{"type":"zanya"}` 影响因子 **ExpandField** string `示例值：type-large` 扩展字段 **ExpenseBeginTime** string `示例值：2023-08-01 00:00:00` 消费开始时间，格式：2023\-03\-02 15:04:05 **ExpenseEndTime** string `示例值：2023-08-01 01:00:00` 消费结束时间，格式：2023\-04\-02 23:59:59 **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 `示例值：北京火山引擎科技有限公司` 主体名 **ConfigName** string `示例值：低配` 配置名称 **PreferentialBillAmount** string `示例值：0.0` 有优惠金额 **RoundAmount** string `示例值：0.0` 抹零金额 **DiscountBillAmount** string `示例值：200.0` 折后价 **OriginalBillAmount** string `示例值：200.0` 原价 **PaidAmount** string `示例值：0.00` 现金支付 **DailyAmortizedOriginalBillAmount** string `示例值：0.00` 每日分摊\-原价 **DailyAmortizedPreferentialBillAmount** string `示例值：0.00` 每日分摊\-优惠金额 **DailyAmortizedRoundAmount** string `示例值：0.00` 每日分摊\-抹零金额 **DailyAmortizedDiscountBillAmount** string `示例值：0.00` 每日分摊\-折后价 **DailyAmortizedPaidAmount** string `示例值：0.00` 每日分摊\-现金支付 **Price** string `示例值：0.52` 单价 **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 `示例值：默认项目` 项目中文名 **Currency** string `示例值：CNY` 币种 **InstanceName** string `示例值：ECS-fEaG` 实例名称 **DeductionUseDuration** string `示例值：1.0000000000` 抵扣量 **SplitItemID** string `示例值：split_test_1` 分拆项ID **SplitItemName** string `示例值：split_test_1` 分拆项名称 **TaxAmount** string `示例值：0.23` 税额 **RealValue** 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` 每日分摊结算币种税前真实价值 **PayableAmount** string `示例值：2.99` 应付金额 **PreTaxPayableAmount** string `示例值：2.76` 税前应付金额 **DailyAmortizedPreTaxPayableAmount** string `示例值：0.08` 每日分摊税前应付金额 **SettlePreTaxPayableAmount** string `示例值：0.08` 税前应付金额\-结算币种 **DailyAmortizedSettlePreTaxPayableAmount** string `示例值：0.08` 每日分摊税前应付金额\-结算币种 **SettlePayableAmount** string `示例值：0.08` 应付金额\-结算币种 **DailyAmortizedSettlePayableAmount** string `示例值：0.09` 每日分摊应付金额\-结算币种 **DailyAmortizedSettleTaxAmount** string `示例值：0.08` 每日分摊税前税额 **CountryArea** string `示例值：SG` 国家地区 **PreTaxRealValue** string `示例值：2.76` 税前真实价值 **DailyAmortizedTaxAmount** string `示例值：0.01` 每日分摊税额 **SettleTaxAmount** string `示例值：7.1805000000` 税额\-结算币种 **TaxRate** string `示例值：0.090000` 税率 **ExchangeRate** string `示例值：7.1805000000` 汇率 **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 国家地区 **Tax** string `示例值：0.23` 税额 **MainContractNumber** string 合同号 **OriginalOrderNo** string 原订单号 **ResourceID** string 资源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` 偏移量 ## 请求示例 ```text // 以下示例不包含签名，建议直接使用API Explorer或下载SDK调试。 curl --location 'https://open.volcengineapi.com?Action=ListAmortizedCostBillDetail&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": "2024040219432652D49C2212775A77B24F", "Action": "ListAmortizedCostBillDetail", "Version": "20220101", "Service": "billing" }, "Result": { "List": [ { AmortizedBeginTime: "2025-05-07 00:00:00", AmortizedDay: "2025-05-07", AmortizedEndTime: "2025-05-07 23:59:59", AmortizedMonth: "2025-05", AmortizedType: "Allocated by purchase", BillCategory: "Consumption-purchase", BillID: "Order8494000008697792132", BillPeriod: "2025-04", BillingFunction: "Fixed Price", BillingMethodCode: "Monthly Prepaid", BillingMode: "Yearly/monthly", BusiPeriod: "2025-04", BusinessMode: "General business", ConfigName: "预付费-包月-多计费-小数价格", CostID: "Cost10877798651140", Count: "1.00", CountryArea: "SG", CouponAmount: "0.000000", Currency: "USD", DailyAmortizedCouponAmount: "0.000000", DailyAmortizedDiscountBillAmount: "0.080000", DailyAmortizedOriginalBillAmount: "0.089032", DailyAmortizedPaidAmount: "0.00", DailyAmortizedPayableAmount: "0.09", DailyAmortizedPreTaxPayableAmount: "0.08", DailyAmortizedPreTaxRealValue: "0.08", DailyAmortizedPreferentialBillAmount: "0.000000", DailyAmortizedRealValue: "0.09", DailyAmortizedRoundAmount: "0.000000", DailyAmortizedSettlePayableAmount: "0.09", DailyAmortizedSettlePreTaxPayableAmount: "0.08", DailyAmortizedSettlePreTaxRealValue: "0.08", DailyAmortizedSettleRealValue: "0.09", DailyAmortizedSettleTaxAmount: "0.00", DailyAmortizedTaxAmount: "0.00", DeductionUseDuration: "0.0000000000", DiscountBillAmount: "2.760000", DiscountBizBillingFunction: "-", DiscountBizMeasureInterval: "-", DiscountBizUnitPrice: "-", DiscountBizUnitPriceInterval: "-", EffectiveFactor: "1", Element: "范围值", ExchangeRate: "", ExpandField: "-", ExpenseBeginTime: "2025-04-14 19:22:22", ExpenseEndTime: "2025-05-14 23:59:59", Factor: "价格影响因子-价因2", InstanceName: "-", InstanceNo: "RegressionTestProduct7492995859626725661", MarketPrice: "", MeasureInterval: "-", OriginalBillAmount: "2.760000", OwnerCustomerName: "BytePlus Pte. Ltd.", OwnerID: "3000004494", OwnerUserName: "MingHaoLiu", PaidAmount: "0.00", PayableAmount: "2.99", PayerCustomerName: "BytePlus Pte. Ltd.", PayerID: "3000004494", PayerUserName: "MingHaoLiu", PreTaxPayableAmount: "2.76", PreTaxRealValue: "2.76", PreferentialBillAmount: "0.000000", Price: "2.756400", PriceInterval: "-", PriceUnit: "Mbps", Product: "RegressionTestProduct", ProductZh: "回归测试产品", Project: "-", ProjectDisplayName: "", RealValue: "2.99", Region: "AP1", RoundAmount: "0.000000", SellerCustomerName: "Byteplus Pte. Ltd.", SellerID: "1065", SellerUserName: "BytePlus", SettlePayableAmount: "2.99", SettlePreTaxPayableAmount: "2.76", SettlePreTaxRealValue: "2.76", SettleRealValue: "2.99", SettleTaxAmount: "0.23", SplitItemID: "", SplitItemName: "", SubjectName: "Byteplus Pte. Ltd.", Tag: "", TaxAmount: "0.23", TaxRate: "0.09", TradeTime: "2025-04-14 19:22:22", Unit: "Mbps", UseDuration: "1", UseDurationUnit: "Month", Zone: "-" } ], "Total": 7723, "Limit": 1, "Offset": 0 } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |RequestInvalid |Request Invalid | | |400 |InvalidParameter |The specified parameter body is invalid. |\-\- | |500 |InternalError |Service has some internal Error. Pls Contact With Admin. |服务内部异常 |

费用中心