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

API描述

在调用该接口时,请注意:

阿里云2000元代金券免费领,最新优惠1折抢购,2核4G云服务器仅799元/3年,新老用户同享,立即抢购>>>

  • 账号账单由实例账单汇总,一般存在一天延迟。
  • 暂时不包括阿里通信和万网产品。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryAccountBill

系统规定参数。取值:QueryAccountBill。

BillingCycle String 2018-07

账单日期,YYYY-MM。

PageNum Integer 1

页码,默认值为1。

PageSize Integer 20

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

IsGroupByProduct Boolean false

是否增加产品Code汇总。

  • true。
  • false。

默认false。

ProductCode String rds

产品code。

返回数据

名称 类型 示例 描述
Code String Success

状态码。

Data Struct

返回数据。

AccountID String 1857xxxxx489

账号ID。

AccountName String test@test.aliyunid.com

账号。

BillingCycle String 2020-03

账期,格式:YYYY-MM。

Items Array

账单详情。

Item
CostUnit String 未分配

财务单元。

Currency String CNY

币种。取值:

  • CNY。
  • USD。
  • JPY。
DeductedByCashCoupons Float 0

代金券抵扣。

DeductedByCoupons Float 0

优惠券抵扣。

DeductedByPrepaidCard Float 0

储值卡抵扣。

InvoiceDiscount Float 0

优惠金额。

OutstandingAmount Float 0

未结清金额或信用结算金额。

OwnerID String 325434254

子账号的阿里云ID。

OwnerName String aligzncloudtest2

子账号名称。

PaymentAmount Float 0

现金支付。

PretaxAmount Float 0

应付金额。

PretaxGrossAmount Float 0

原始金额。

ProductCode String rds

产品code。

说明 仅当IsGroupByProduct为true时返回。

ProductName String rds

产品名称。

说明 仅当IsGroupByProduct为true时返回。

SubscriptionType String PayAsYouGo

产品订阅类型,

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

PageNum Integer 1

页码。

PageSize Integer 20

每页显示条数。

TotalCount Integer 1

总记录数。

Message String Successful!

错误信息。

RequestId String 3BFC23FE-A182-4D96-A1E4-7521B30B8E43

请求ID。

Success Boolean true

是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=QueryAccountBill &<公共请求参数>

正常返回示例

XML 格式

<QueryAccountBillResponse>       <Message>Successful!</Message>       <RequestId>3BFC23FE-A182-4D96-A1E4-7521B30B8E43</RequestId>       <Data>             <BillingCycle>2020-03</BillingCycle>             <TotalCount>0</TotalCount>             <AccountID>1857xxxxx489</AccountID>             <PageSize>20</PageSize>             <PageNum>1</PageNum>             <Items>         </Items>             <AccountName>test@test.aliyunid.com</AccountName>       </Data>       <Code>Success</Code>       <Success>true</Success> </QueryAccountBillResponse>

JSON 格式

{ 	"Message": "Successful!", 	"RequestId": "3BFC23FE-A182-4D96-A1E4-7521B30B8E43", 	"Data": { 		"BillingCycle": "2020-03", 		"TotalCount": 0, 		"AccountID": "1857xxxxx489", 		"PageSize": 20, 		"PageNum": 1, 		"Items": { 			"Item": [] 		}, 		"AccountName": "test@test.aliyunid.com" 	}, 	"Code": "Success", 	"Success": true }

错误码

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