AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 费用与成本 开发参考 API参考指南 API目录 财务账单 DescribeInstanceAmortizedCostByAmortizationPeriod - 查询实例摊销月摊销成本

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

更新时间：
我的收藏

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

接口说明

  • 摊销成本不作为结算及对账依据。摊销成本提供费用分摊能力，将您在云上产生的费用（含预付费和后付费）按照指定的分摊规则进行分摊。

  • 当月最终数据在次月 6 日 12 点后支持使用（月中会发生包括但不限于以下少数场景：延迟出账，退款，调账，欠费核销等）。当月数据中不包含未结算（未出账，累账中）的后付费数据。

  • 摊销成本数据支持近 12 个月数据。

  • 摊销成本中分拆项相关数据在分账账单数据出具后延迟 48 小时更新（若需使用分拆费用请提前开通分账账单）；非分拆项相关数据在明细账单出具后延迟 48 小时更新。

  • 2021 年 8 月（不含）之前的摊销成本月中不更新，仅于摊销次月 6 日 12 点后统一更新，也不支持提供分拆型云产品（例如：CDN、OSS、共享带宽等）各个分拆项（例如：域名、Bucket、EIP 等）的具体费用。

  • 摊销成本数据需要用户开通摊销成本后才可提供，自开通后延迟 48 小时可使用。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bssapi:DescribeCostBill

get

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
BillingCycle

string

是

摊销月 格式：YYYY－MM。

2022-10
ConsumePeriodFilter

array

否

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

string

否

账期月 格式：YYYY－MM。

2022-09
SubscriptionType

string

否

订阅类型。取值：

  • Subscription：预付费。

  • PayAsYouGo：后付费。

Subscription
ProductCode

string

否

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

rds
ProductDetail

string

否

产品明细。

rds
CostUnitCode

string

否

财务单元 code。

123#
BillUserIdList

array

否

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

string

否

账单购买者 ID。

123
BillOwnerIdList

array

否

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

string

否

资源归属账号 ID。

123
InstanceIdList

array

否

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

string

否

实例 ID。

abc
NextToken

string

否

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

CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U
MaxResults

integer

否

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

20

返回参数

名称

类型

描述

示例值

object

BssResult

RequestId

string

请求 ID。

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

boolean

是否成功。

true
Code

string

状态码。

200
Message

string

消息说明。

Successful！
Data

object

返回数据

NextToken

string

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

CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U
AccountID

string

账号 ID。

185766xxxx
AccountName

string

用户账号。

test@test.aliyunid.com
MaxResults

integer

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

100
TotalCount

integer

总记录数。

100
Items

array<object>

数据条目。

object

数据项。

CostUnit

string

财务单元。

未分配
CostUnitCode

string

财务单元 code。

1234
InstanceID

string

实例 ID。

i-kjhdskjgshfdlkjfdh
ResourceGroup

string

资源组。

默认资源组

Tag

string

实例标签。

tag
InternetIP

string

公网 IP。

34.xx.x.x
IntranetIP

string

内网 IP。

192.xx.xx.xx
Region

string

地域。

杭州
Zone

string

可用区。

杭州1
SplitAccountName

string

分拆项所属账号名称。

test**1122
SplitProductDetail

string

分拆项产品明细名称。

rds
SplitItemID

string

分拆项 ID。

i-28bycvyb4
SplitItemName

string

分拆项名称。

iZ28bycvyb4Z
ConsumePeriod

string

账期。 格式：YYYYMM。

202210
AmortizationStatus

string

摊销状态，取值：

  • amortized 已摊销

  • unAmortized 未摊销

amortized
AmortizationPeriod

string

摊销月。 格式：YYYYMM。

202210
BillAccountID

integer

账单所属账号 ID。

185xxxxx489
BillAccountName

string

账单所属账号名称。

test@test.aliyunid.com
BillOwnerID

integer

资源归属账号 ID。

185xxxxx489
BillOwnerName

string

资源所属账号名称。

test@test.aliyunid.com
ProductCode

string

产品代码。

rds
ProductName

string

产品名称。

云数据库RDS
ProductDetailCode

string

产品明细 code。

rds
ProductDetail

string

产品明细。

云数据库RDS

BizType

string

业务类型。

trusteeship
SubscriptionType

string

订阅类型，取值：

  • Subscription：预付费。

  • PayAsYouGo：后付费。

PayAsYouGo
PretaxGrossAmount

number

官网价。

0
InvoiceDiscount

number

优惠金额。

0
RoundDownDiscount

number

抹零金额。

0
PretaxAmount

number

应付金额。

0
DeductedByCashCoupons

number

代金券抵扣。

0
DeductedByCoupons

number

优惠券抵扣。

0
DeductedByPrepaidCard

number

储值卡支付金额。

0
ExpenditureAmount

number

消费金额（可开票）。

0
PreviouslyAmortizedPretaxGrossAmount

number

期初已摊-官网价。

0
PreviouslyAmortizedInvoiceDiscount

number

期初已摊-优惠金额。

0
PreviouslyAmortizedRoundDownDiscount

number

期初已摊-抹零金额。

0
PreviouslyAmortizedPretaxAmount

number

期初已摊-应付金额。

0
PreviouslyAmortizedDeductedByCashCoupons

number

期初已摊-代金券抵扣。

0
PreviouslyAmortizedDeductedByCoupons

number

期初已摊-优惠券抵扣。

0
PreviouslyAmortizedDeductedByPrepaidCard

number

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

0
PreviouslyAmortizedExpenditureAmount

number

期初已摊-消费金额（可开票）。

0
CurrentAmortizationPretaxGrossAmount

number

本期摊销-官网价。

0
CurrentAmortizationInvoiceDiscount

number

本期摊销-优惠金额。

0
CurrentAmortizationRoundDownDiscount

number

本期摊销-抹零金额。

0
CurrentAmortizationPretaxAmount

number

本期摊销-应付金额。

0
CurrentAmortizationDeductedByCashCoupons

number

本期摊销-代金券抵扣。

0
CurrentAmortizationDeductedByCoupons

number

本期摊销-优惠券抵扣。

0
CurrentAmortizationDeductedByPrepaidCard

number

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

0
CurrentAmortizationExpenditureAmount

number

本期摊销-消费金额（可开票）。

0
RemainingAmortizationPretaxGrossAmount

number

期末待摊-官网价。

0
RemainingAmortizationInvoiceDiscount

number

期末待摊-优惠金额。

0
RemainingAmortizationRoundDownDiscount

number

期末待摊-抹零金额。

0
RemainingAmortizationPretaxAmount

number

期末待摊-应付金额。

0
RemainingAmortizationDeductedByCashCoupons

number

期末待摊-代金券抵扣。

0
RemainingAmortizationDeductedByCoupons

number

期末待摊-优惠券抵扣。

0
RemainingAmortizationDeductedByPrepaidCard

number

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

0
RemainingAmortizationExpenditureAmount

number

期末待摊-消费金额（可开票）。

0
AfterDiscountAmount

number

优惠后金额

0
PreviouslyAmortizedAfterDiscountAmount

number

期初已摊-优惠后金额

0
CurrentAmortizationAfterDiscountAmount

number

本期摊销-优惠后金额

0
RemainingAmortizationAfterDiscountAmount

number

期末未摊-优惠后金额

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,
        "AfterDiscountAmount": 0,
        "PreviouslyAmortizedAfterDiscountAmount": 0,
        "CurrentAmortizationAfterDiscountAmount": 0,
        "RemainingAmortizationAfterDiscountAmount": 0
      }
    ]
  }
}

错误码

HTTP status code

错误码

错误信息

描述
400 NotActiveService You are not active Amotized Cost ，please use after activation.

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

变更历史

更多信息，参考变更详情。

上一篇：QueryInstanceGaapCost - 查询月费用分摊服务下一篇：DescribeProductAmortizedCostByAmortizationPeriod - 查询产品摊销月摊销成本