文档

DescribeInstanceAmortizedCostByAmortizationPeriod - 查询实例摊销月摊销成本

更新时间:
一键部署

以摊销月视角查询月实例摊销成本。

接口说明

  • 摊销成本不作为结算及对账依据。摊销成本提供费用分摊能力,将您在云上产生的费用(含预付费和后付费)按照指定的分摊规则进行分摊。
  • 当月最终数据在次月 6 日 12 点后支持使用(月中会发生包括但不限于以下少数场景:延迟出账,退款,调账,欠费核销等)。当月数据中不包含未结算(未出账,累账中)的后付费数据。
  • 摊销成本数据支持近 12 个月数据。
  • 摊销成本中分拆项相关数据在分账账单数据出具后延迟 48 小时更新(若需使用分拆费用请提前开通分账账单);非分拆项相关数据在明细账单出具后延迟 48 小时更新。
  • 2021 年 8 月(不含)之前的摊销成本月中不更新,仅于摊销次月 6 日 12 点后统一更新,也不支持提供分拆型云产品(例如:CDN、OSS、共享带宽等)各个分拆项(例如:域名、Bucket、EIP 等)的具体费用。
  • 摊销成本数据需要用户开通摊销成本后才可提供,自开通后延迟 48 小时可使用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
BillingCyclestring

摊销月 格式:YYYY-MM。

2022-10
ConsumePeriodFilterarray

账期月筛选条件。 最多元素个数:10。

string

账期月 格式:YYYY-MM。

2022-09
SubscriptionTypestring

订阅类型。取值:

  • Subscription:预付费。
  • PayAsYouGo:后付费。
Subscription
ProductCodestring

产品。 参考取值来源: 查 QueryProductList 查询产品信息, 查 DescribeResourcePackageProduct 查询某个资源包产品的信息。

rds
ProductDetailstring

产品明细。

rds
CostUnitCodestring

财务单元 code。

123#
BillUserIdListarray

账单购买者 ID 筛选条件。 子账号 ID。设置可查看财务云子账号账单,不填默认查看当前调用账号及其所有子账号。 最多元素个数:10。

string

账单购买者 ID。

123
BillOwnerIdListarray

资源归属账号筛选条件。 资源归属账号 ID,资源归属账号是实际使用资源的账号。 最多元素个数:10。

string

资源归属账号 ID。

123
InstanceIdListarray

实例 ID 筛选条件。 支持查询多个实例,不传默认查所有实例。 最多元素个数:10。

string

实例 ID。

abc
NextTokenstring

用来表示当前调用开始读取的位置,参数值必须为空或者使用返回结果中的 NextToken 设值,否则会报错。空代表从头开始读取。

CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U
MaxResultsinteger

本次读取的最大数据记录数量。默认值:20,最大值:300。

20

返回参数

名称类型描述示例值
object

BssResult

RequestIdstring

请求 ID。

79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Successboolean

是否成功。

true
Codestring

状态码。

200
Messagestring

消息说明。

Successful!
Dataobject

返回数据

NextTokenstring

用来表示当前调用开始读取的位置,参数值必须为空或者使用返回结果中的 NextToken 设值,否则会报错。空代表从头开始读取。

CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U
AccountIDstring

账号 ID。

185766xxxx
AccountNamestring

用户账号。

test@test.aliyunid.com
MaxResultsinteger

本次请求所返回的最大记录条数。

100
TotalCountinteger

总记录数。

100
Itemsobject []

数据条目。

CostUnitstring

财务单元。

未分配
CostUnitCodestring

财务单元 code。

1234
InstanceIDstring

实例 ID。

i-kjhdskjgshfdlkjfdh
ResourceGroupstring

资源组。

默认资源组
Tagstring

实例标签。

tag
InternetIPstring

公网 IP。

34.xx.x.x
IntranetIPstring

内网 IP。

192.xx.xx.xx
Regionstring

地域。

杭州
Zonestring

可用区。

杭州1
SplitAccountNamestring

分拆项所属账号名称。

test**1122
SplitProductDetailstring

分拆项产品明细名称。

rds
SplitItemIDstring

分拆项 ID。

i-28bycvyb4
SplitItemNamestring

分拆项名称。

iZ28bycvyb4Z
ConsumePeriodstring

账期。 格式:YYYYMM。

202210
AmortizationStatusstring

摊销状态,取值:

  • amortized 已摊销
  • unAmortized 未摊销
amortized
AmortizationPeriodstring

摊销月。 格式:YYYYMM。

202210
BillAccountIDlong

账单所属账号 ID。

185xxxxx489
BillAccountNamestring

账单所属账号名称。

test@test.aliyunid.com
BillOwnerIDlong

资源归属账号 ID。

185xxxxx489
BillOwnerNamestring

资源所属账号名称。

test@test.aliyunid.com
ProductCodestring

产品代码。

rds
ProductNamestring

产品名称。

云数据库RDS
ProductDetailCodestring

产品明细 code。

rds
ProductDetailstring

产品明细。

云数据库RDS
BizTypestring

业务类型。

trusteeship
SubscriptionTypestring

订阅类型,取值:

  • Subscription:预付费。
  • PayAsYouGo:后付费。
PayAsYouGo
PretaxGrossAmountdouble

官网价。

0
InvoiceDiscountdouble

优惠金额。

0
RoundDownDiscountdouble

抹零金额。

0
PretaxAmountdouble

应付金额。

0
DeductedByCashCouponsdouble

代金券抵扣。

0
DeductedByCouponsdouble

优惠券抵扣。

0
DeductedByPrepaidCarddouble

储值卡支付金额。

0
ExpenditureAmountdouble

消费金额(可开票)。

0
PreviouslyAmortizedPretaxGrossAmountdouble

期初已摊-官网价。

0
PreviouslyAmortizedInvoiceDiscountdouble

期初已摊-优惠金额。

0
PreviouslyAmortizedRoundDownDiscountdouble

期初已摊-抹零金额。

0
PreviouslyAmortizedPretaxAmountdouble

期初已摊-应付金额。

0
PreviouslyAmortizedDeductedByCashCouponsdouble

期初已摊-代金券抵扣。

0
PreviouslyAmortizedDeductedByCouponsdouble

期初已摊-优惠券抵扣。

0
PreviouslyAmortizedDeductedByPrepaidCarddouble

期初已摊-储值卡支付金额。

0
PreviouslyAmortizedExpenditureAmountdouble

期初已摊-消费金额(可开票)。

0
CurrentAmortizationPretaxGrossAmountdouble

本期摊销-官网价。

0
CurrentAmortizationInvoiceDiscountdouble

本期摊销-优惠金额。

0
CurrentAmortizationRoundDownDiscountdouble

本期摊销-抹零金额。

0
CurrentAmortizationPretaxAmountdouble

本期摊销-应付金额。

0
CurrentAmortizationDeductedByCashCouponsdouble

本期摊销-代金券抵扣。

0
CurrentAmortizationDeductedByCouponsdouble

本期摊销-优惠券抵扣。

0
CurrentAmortizationDeductedByPrepaidCarddouble

本期摊销-储值卡支付金额。

0
CurrentAmortizationExpenditureAmountdouble

本期摊销-消费金额(可开票)。

0
RemainingAmortizationPretaxGrossAmountdouble

期末待摊-官网价。

0
RemainingAmortizationInvoiceDiscountdouble

期末待摊-优惠金额。

0
RemainingAmortizationRoundDownDiscountdouble

期末待摊-抹零金额。

0
RemainingAmortizationPretaxAmountdouble

期末待摊-应付金额。

0
RemainingAmortizationDeductedByCashCouponsdouble

期末待摊-代金券抵扣。

0
RemainingAmortizationDeductedByCouponsdouble

期末待摊-优惠券抵扣。

0
RemainingAmortizationDeductedByPrepaidCarddouble

期末待摊-储值卡支付金额。

0
RemainingAmortizationExpenditureAmountdouble

期末待摊-消费金额(可开票)。

0

示例

正常返回示例

JSON格式

{
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Code": "200",
  "Message": "Successful!",
  "Data": {
    "NextToken": "CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U",
    "AccountID": "185766xxxx",
    "AccountName": "test@test.aliyunid.com",
    "MaxResults": 100,
    "TotalCount": 100,
    "Items": [
      {
        "CostUnit": "未分配",
        "CostUnitCode": "1234",
        "InstanceID": "i-kjhdskjgshfdlkjfdh",
        "ResourceGroup": "默认资源组\t",
        "Tag": "tag",
        "InternetIP": "34.xx.x.x",
        "IntranetIP": "192.xx.xx.xx",
        "Region": "杭州",
        "Zone": "杭州1",
        "SplitAccountName": "test**1122",
        "SplitProductDetail": "rds",
        "SplitItemID": "i-28bycvyb4",
        "SplitItemName": "iZ28bycvyb4Z",
        "ConsumePeriod": "202210",
        "AmortizationStatus": "amortized",
        "AmortizationPeriod": "202210",
        "BillAccountID": 0,
        "BillAccountName": "test@test.aliyunid.com",
        "BillOwnerID": 0,
        "BillOwnerName": "test@test.aliyunid.com",
        "ProductCode": "rds",
        "ProductName": "云数据库RDS",
        "ProductDetailCode": "rds",
        "ProductDetail": "云数据库RDS\t",
        "BizType": "trusteeship",
        "SubscriptionType": "PayAsYouGo",
        "PretaxGrossAmount": 0,
        "InvoiceDiscount": 0,
        "RoundDownDiscount": 0,
        "PretaxAmount": 0,
        "DeductedByCashCoupons": 0,
        "DeductedByCoupons": 0,
        "DeductedByPrepaidCard": 0,
        "ExpenditureAmount": 0,
        "PreviouslyAmortizedPretaxGrossAmount": 0,
        "PreviouslyAmortizedInvoiceDiscount": 0,
        "PreviouslyAmortizedRoundDownDiscount": 0,
        "PreviouslyAmortizedPretaxAmount": 0,
        "PreviouslyAmortizedDeductedByCashCoupons": 0,
        "PreviouslyAmortizedDeductedByCoupons": 0,
        "PreviouslyAmortizedDeductedByPrepaidCard": 0,
        "PreviouslyAmortizedExpenditureAmount": 0,
        "CurrentAmortizationPretaxGrossAmount": 0,
        "CurrentAmortizationInvoiceDiscount": 0,
        "CurrentAmortizationRoundDownDiscount": 0,
        "CurrentAmortizationPretaxAmount": 0,
        "CurrentAmortizationDeductedByCashCoupons": 0,
        "CurrentAmortizationDeductedByCoupons": 0,
        "CurrentAmortizationDeductedByPrepaidCard": 0,
        "CurrentAmortizationExpenditureAmount": 0,
        "RemainingAmortizationPretaxGrossAmount": 0,
        "RemainingAmortizationInvoiceDiscount": 0,
        "RemainingAmortizationRoundDownDiscount": 0,
        "RemainingAmortizationPretaxAmount": 0,
        "RemainingAmortizationDeductedByCashCoupons": 0,
        "RemainingAmortizationDeductedByCoupons": 0,
        "RemainingAmortizationDeductedByPrepaidCard": 0,
        "RemainingAmortizationExpenditureAmount": 0
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息
400NotActiveServiceYou are not active Amotized Cost ,please use after activation.

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-01-10OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2022-12-29OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    新增错误码:400
2022-12-23API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2022-12-22新增 OpenAPI看变更集