以摊销月视角查询月实例摊销成本。
接口说明
- 摊销成本不作为结算及对账依据。摊销成本提供费用分摊能力，将您在云上产生的费用（含预付费和后付费）按照指定的分摊规则进行分摊。
- 当月最终数据在次月 6 日 12 点后支持使用（月中会发生包括但不限于以下少数场景：延迟出账，退款，调账，欠费核销等）。当月数据中不包含未结算（未出账，累账中）的后付费数据。
- 摊销成本数据支持近 12 个月数据。
- 摊销成本中分拆项相关数据在分账账单数据出具后延迟 48 小时更新（若需使用分拆费用请提前开通分账账单）；非分拆项相关数据在明细账单出具后延迟 48 小时更新。
- 2021 年 8 月（不含）之前的摊销成本月中不更新，仅于摊销次月 6 日 12 点后统一更新，也不支持提供分拆型云产品（例如：CDN、OSS、共享带宽等）各个分拆项（例如：域名、Bucket、EIP 等）的具体费用。
- 摊销成本数据需要用户开通摊销成本后才可提供，自开通后延迟 48 小时可使用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| BillingCycle | string | 是 | 摊销月 格式：YYYY－MM。 | 2022-10 |
| ConsumePeriodFilter | array | 否 | 账期月筛选条件。 最多元素个数：10。 | |
| string | 否 | 账期月 格式：YYYY－MM。 | 2022-09 | |
| SubscriptionType | string | 否 | 订阅类型。取值：
| 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 |
返回参数
示例
正常返回示例
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 | 错误码 | 错误信息 |
|---|---|---|
| 400 | NotActiveService | You are not active Amotized Cost ，please use after activation. |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||||
|---|---|---|---|---|---|---|---|---|
| 2023-01-10 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 看变更集 | ||||||
| ||||||||
| 2022-12-29 | OpenAPI 错误码发生变更 | 看变更集 | ||||||
| ||||||||
| 2022-12-23 | API 内部配置变更，不影响调用 | 看变更集 | ||||||
| ||||||||
| 2022-12-22 | 新增 OpenAPI | 看变更集 |