全部产品
Search
文档中心

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

更新时间:Mar 01, 2024

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

接口说明

  • 当月数据查询结果仅供参考,不作为对账依据;当月最终账单在次月 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:QueryAccountBillRead
  • 全部资源
    *
  • bssapi:ProductCode
  • bssapi:ProductType

请求参数

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

账单日期,YYYY-MM。

2018-07
PageNuminteger

页码,默认值为 1。

1
PageSizeinteger

每页数量,默认值 20,最大值:300。

20
IsGroupByProductboolean

是否增加产品 Code 汇总。

  • true。
  • false。

默认 false。

false
ProductCodestring

产品 code。

rds
BillOwnerIdlong

资源归属账号 ID,资源归属账号是实际使用资源的账号。

122
Granularitystring

查询账单的颗粒度。取值:

  • MONTHLY:月。与费用中心-费用账单-账单明细-账期账单一致。
  • DAILY:日。与费用中心-费用账单-账单明细-按天账单一致。
说明 选择 DAILY 需指定 BillingDate。
MONTHLY
BillingDatestring

账单日期,仅当 Granularity 为 DAILY 时必填,格式为 YYYY-MM-DD。

2021-06-01

返回参数

名称类型描述示例值
object
Codestring

状态码。

Success
Messagestring

错误信息。

Successful!
RequestIdstring

请求 ID。

3BFC23FE-A182-4D96-A1E4-7521B30B8E43
Successboolean

是否成功。

true
Dataobject

返回数据。

PageNuminteger

页码。

1
BillingCyclestring

账期,格式:YYYY-MM。

2020-03
AccountIDstring

账号 ID。

1857xxxxx489
PageSizeinteger

每页显示条数。

20
TotalCountinteger

总记录数。

1
AccountNamestring

账号。

test@test.aliyunid.com
Itemsobject []

账单详情。

PipCodestring

产品 Code,与费用中心账单产品 Code 一致

rds
BillingDatestring

账单日期。

2021-03-01
ProductNamestring

产品名称。

说明 仅当 IsGroupByProduct 为 true 时返回。
rds
OwnerNamestring

子账号名称。

aligzncloudtest2
Currencystring

币种。取值:

  • CNY。
  • USD。
  • JPY。
CNY
BillAccountNamestring

账单所属账号名称。

test@test.aliyunid.com
SubscriptionTypestring

产品订阅类型:

  • 预付费:Subscription。
  • 后付费:PayAsYouGo。
说明 仅当 IsGroupByProduct 为 true 时返回。
PayAsYouGo
BizTypestring

业务类型。

trusteeship
OwnerIDstring

子账号的阿里云 ID。

325434254
DeductedByCouponsfloat

优惠券抵扣。

0
BillAccountIDstring

账单所属账号 ID。

1857xxxxx489
InvoiceDiscountfloat

优惠金额。

0
CostUnitstring

财务单元。

未分配
PretaxGrossAmountfloat

原始金额。

0
ProductCodestring

产品 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-21OpenAPI 描述信息更新看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新