QueryAccountBill - 账号账单查询服务 - 阿里云交易和账单管理API

查询用户某个账期内的消费，并以资源所有者的维度进行汇总。

接口说明

当月数据查询结果仅供参考，不作为对账依据；当月最终账单在次月 3 日 12 点后支持查看/导出（月中会发生包括但不限于以下少数场景：延迟出账，退款，调账，欠费核销等）。
支持近 18 个月数据。
账单数据相对于实际费用消耗延迟 24 小时更新，其中实例 ID 相关的信息（实例配置，实例规格，实例昵称，资源组，公网 IP，私网 IP，可用区）延迟 48 小时更新。
账单数据不支持提供分拆型云产品（例如：CDN、OSS、共享带宽等）各个分拆项（例如：域名、Bucket、EIP 等）的具体费用（如需统计含分拆项数据，请前往分账账单）。
对于云通信产品，仅支持查询 2020 年 6 月及以后的明细数据，万网产品（包括域名、商标等）仅支持查询 2020 年 11 月及以后的明细数据。
单用户限流 10 笔/秒，如遇超时，请重试。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
bssapi:QueryAccountBill	Read	全部资源 *	bssapi:ProductCode bssapi:ProductType	无

请求参数

名称	类型	必填	描述	示例值
BillingCycle	string	是	账单日期，YYYY-MM。	2018-07
PageNum	integer	否	页码，默认值为 1。	1
PageSize	integer	否	每页数量，默认值 20，最大值：300。	20
IsGroupByProduct	boolean	否	是否增加产品 Code 汇总。 true。 false。默认 false。	false
ProductCode	string	否	产品 code。	rds
BillOwnerId	long	否	资源归属账号 ID，资源归属账号是实际使用资源的账号。	122
Granularity	string	否	查询账单的颗粒度。取值： MONTHLY：月。与费用中心-费用账单-账单明细-账期账单一致。 DAILY：日。与费用中心-费用账单-账单明细-按天账单一致。说明选择 DAILY 需指定 BillingDate。	MONTHLY
BillingDate	string	否	账单日期，仅当 Granularity 为 DAILY 时必填，格式为 YYYY-MM-DD。	2021-06-01

返回参数

名称	类型	描述	示例值
	object
Code	string	状态码。	Success
Message	string	错误信息。	Successful!
RequestId	string	请求 ID。	3BFC23FE-A182-4D96-A1E4-7521B30B8E43
Success	boolean	是否成功。	true
Data	object	返回数据。
PageNum	integer	页码。	1
BillingCycle	string	账期，格式：YYYY-MM。	2020-03
AccountID	string	账号 ID。	1857xxxxx489
PageSize	integer	每页显示条数。	20
TotalCount	integer	总记录数。	1
AccountName	string	账号。	test@test.aliyunid.com
Items	object []	账单详情。
PipCode	string	产品 Code，与费用中心账单产品 Code 一致	rds
PretaxAmount	float		0
BillingDate	string	账单日期。	2021-03-01
ProductName	string	产品名称。说明仅当 IsGroupByProduct 为 true 时返回。	rds
AdjustAmount	float	信用额度退款抵扣。	0
OwnerName	string	子账号名称。	aligzncloudtest2
Currency	string	币种。取值： CNY。 USD。 JPY。	CNY
BillAccountName	string	账单所属账号名称。	test@test.aliyunid.com
SubscriptionType	string	产品订阅类型：预付费：Subscription。后付费：PayAsYouGo。说明仅当 IsGroupByProduct 为 true 时返回。	PayAsYouGo
DeductedByCashCoupons	float		0
BizType	string	业务类型。	trusteeship
OwnerID	string	子账号的阿里云 ID。	325434254
DeductedByPrepaidCard	float		0
DeductedByCoupons	float	优惠券抵扣。	0
BillAccountID	string	账单所属账号 ID。	1857xxxxx489
PaymentAmount	float	现金支付（含信用额度退款抵扣）。	0
InvoiceDiscount	float	优惠金额。	0
OutstandingAmount	float		0
CostUnit	string	财务单元。	未分配
PretaxGrossAmount	float	原始金额。	0
CashAmount	float	现金支付（不包含信用额度退款抵扣）。	0
ProductCode	string	产品 code。说明仅当 IsGroupByProduct 为 true 时返回。	rds

示例

正常返回示例

JSON格式

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "3BFC23FE-A182-4D96-A1E4-7521B30B8E43",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-03",
    "AccountID": "1857xxxxx489",
    "PageSize": 20,
    "TotalCount": 1,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "PipCode": "rds",
          "PretaxAmount": 0,
          "BillingDate": "2021-03-01",
          "ProductName": "rds",
          "AdjustAmount": 0,
          "OwnerName": "aligzncloudtest2",
          "Currency": "CNY",
          "BillAccountName": "test@test.aliyunid.com",
          "SubscriptionType": "PayAsYouGo",
          "DeductedByCashCoupons": 0,
          "BizType": "trusteeship",
          "OwnerID": "325434254",
          "DeductedByPrepaidCard": 0,
          "DeductedByCoupons": 0,
          "BillAccountID": "1857xxxxx489",
          "PaymentAmount": 0,
          "InvoiceDiscount": 0,
          "OutstandingAmount": 0,
          "CostUnit": "未分配",
          "PretaxGrossAmount": 0,
          "CashAmount": 0,
          "ProductCode": "rds"
        }
      ]
    }
  }
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-11-21

OpenAPI 描述信息更新

看变更集

变更项	变更内容
API 描述	OpenAPI 描述信息更新。