资源月账单
更新时间：2025-08-21
GetResourceMonthBill接口
接口描述
分页获取资源月账单详情。
企业组织财务管理中的主账户可以查询子账户的账单详情。
加入财务圈的子账户会屏蔽代金券之外的其他金额。子用户要发起该请求，需要具有多用户访问控制的管理员权限或者FCFullControlPolicy多用户访问控制策略管理权限。
默认接口请求频率限制：20次/秒。
权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求，请参考鉴权认证。
注意事项
如果请求中没有用户验证信息（即匿名访问），返回403 Forbidden，错误信息：AccessDenied。
请求结构与示例
Plain Text
1 GET /v{version}/bill/resource/month?month={month}&productType={productType}&serviceType={serviceType}&queryAccountId={queryAccountId}&pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2 Host: billing.baidubce.com
3 ContentType: application/json
4 Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 参数位置 | 描述 | 是否必须 |
|---|---|---|---|---|
| month | String | Query参数 | 按月查询账单所属月份，格式yyyy-MM，例：2019-02 | 可选 |
| beginTime | String | Query参数 | 按天查询账单所属时间区间最早时间，格式yyyy-MM-dd，例：2019-02-01 | 可选 |
| endTime | String | Query参数 | 按天查询账单所属时间区间最晚时间，格式yyyy-MM-dd，例：2019-02-18。若按天查询参数非空，优先返回按天查询的结果；按天查询时间区间不支持跨月；按天查询可以查询本月今天之前的账单；若需查询昨日的账单，为保证数据准确处理完毕，请当日十点后查询。 | 可选 |
| productType | String | Query参数 | 计费类型：prepay/ postpay，分别表示预付费/后付费 | 必须 |
| serviceType | String | Query参数 | 产品类型，例：BCC，BOS等 | 可选 |
| queryAccountId | String | Query参数 | 查询账户ID，只有企业组织的主账户可以查询加入财务圈的子账户账单，其他查询场景会提示AccessDenied | 可选 |
| pageNo | int | Query参数 | 分页查询的页数，默认为1 | 可选 |
| pageSize | int | Query参数 | 每页包含的最大数量，最大数量不超过100，缺省值为20。 | 可选 |
说明：一次请求最多返回100个账单的信息。
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| billMonth | String | 按月查询账单所属月份，格式yyyy-MM，例：2019-02 |
| beginTime | String | 按天查询账单所属时间区间最早时间，格式yyyy-MM-dd，例：2019-02-01 |
| endTime | String | 按天查询账单所属时间区间最晚时间，格式yyyy-MM-dd，例：2019-02-18 |
| accountId | String | 当前账户不是财务圈子账户时，返回当前账户accountId；是财务圈子账户时，返回当前账户主账户的accountId |
| loginName | String | 当前账户不是财务圈子账户时，返回当前账户的登录名；是财务圈子账户时，返回当前账户主账户的登录名 |
| subAccountId | String | 当前账户不是财务圈子账户时，返回"/"；是财务圈子账户时，返回当前账户的accountId |
| subLoginName | String | 当前账户不是财务圈子账户时，返回"/"；是财务圈子账户时，返回当前账户的登录名 |
| ouName | String | 当前账户不是财务圈子账户时，返回"/"；是财务圈子账户时，返回当前账户所在组织单元的单元名 |
| pageNo | Integer | 分页查询编号 |
| pageSize | Integer | 分页查询分页大小 |
| totalCount | Integer | 当前查询条件总条目 |
| bills | List< ResourceMonthInstanceBill > | 资源月账单列表 |
响应示例
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: d4591fcf-025b-46bc-81eb-91ddda4e27bc
3 Server: BWS
4 Date: Tue, 09 Apr 2019 11:01:10 GMT
5 Content-Type: application/json;charset=UTF-8
6 {
7 "billMonth":"2019-02",
8 "beginTime":"2019-02-01",
9 "endTime":"2019-02-18",
10 "accountId":"xxx",
11 "loginName":"xxx",
12 "subAccountId":"/",
13 "subLoginName":"/",
14 "ouName":"/",
15 "pageNo":1,
16 "pageSize":20,
17 "totalCount":1,
18 "bills":[
19 {
20 "vendor":"百度智能云",
21 "accountId":"xxx",
22 "serviceType":"SCS",
23 "serviceTypeName":"简单缓存服务",
24 "productType":"postpay",
25 "region":"bj",
26 "instanceId":"30749",
27 "orderId":"/",
28 "orderType":"/",
29 "orderTypeDesc":"/",
30 "orderPurchaseTime":"2018-01-07T07:10:24.000Z",
31 "startTime":"2019-01-31T16:00:00.000Z",
32 "endTime":"2019-02-28T15:59:59.000Z",
33 "configurationCH":"容量：1G",
34 "tag":"tag:value",
35 "duration":"/",
36 "chargeItem":"RunningTimeMinutes",
37 "chargeItemDesc":"运行时间",
38 "amount":"35909",
39 "amountUnit":"分钟",
40 "discountAmount":"",
41 "unitPrice":"0.003333元/分钟",
42 "pricingUnit":"分钟",
43 "discountUnit":"100.00",
44 "tex":6,
45 "catalogPrice":119.68,
46 "originPrice":119.68,
47 "financePrice":119.68,
48 "cash":119.68,
49 "rebate":0,
50 "creditCost":0,
51 "creditRefund":0,
52 "debt":0,
53 "noPaidPrice":0,
54 "couponPrice":0,
55 "discountCouponPrice":0,
56 "discountPrice":0,
57 "sysGold":0
58 }
59 ]
60 }说明： JSON请求响应项的命名规则是首字母小写的驼峰格式。