以账期月视角查询月产品摊销成本。
接口说明
- 摊销成本不作为结算及对账依据。摊销成本提供费用分摊能力,将您在云上产生的费用(含预付费和后付费)按照指定的分摊规则进行分摊。
- 当月最终数据在次月 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 |
AmortizationPeriodFilter | 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 筛选条件。 子账号 ID。设置可查看财务云子账号账单,不填默认查看当前调用账号及其所有子账号。 最多元素个数:10。 | |
string | 否 | 账单拥有者 ID。 | 123 | |
NextToken | string | 否 | 用来表示当前调用开始读取的位置,参数值必须为空或者使用返回结果中的 NextToken 设值,否则会报错。空代表从头开始读取。 | CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U |
MaxResults | integer | 否 | 本次读取的最大数据记录数量。默认值:20,最大值:300。 | 20 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F\n",
"Success": true,
"Code": "200",
"Message": "Successful!\n",
"Data": {
"NextToken": "CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U",
"AccountID": "185766xxxx",
"AccountName": "test@test.aliyunid.com\n",
"MaxResults": 100,
"TotalCount": 100,
"Items": [
{
"ConsumePeriod": "202210",
"AmortizationStatus": "amortized",
"AmortizationPeriod": "202210",
"BillAccountID": 0,
"BillAccountName": "test@test.aliyunid.com\n",
"BillOwnerID": 0,
"BillOwnerName": "test@test.aliyunid.com\n",
"ProductCode": "rds",
"ProductName": "云数据库RDS\n",
"ProductDetailCode": "rds",
"ProductDetail": "云数据库RDS\n",
"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. |
访问错误中心查看更多错误码。