资源月账单
更新时间:2021-09-24
GetResourceMonthBill接口
接口描述
分页获取资源月账单详情。
企业组织财务管理中的主账户可以查询子账户的账单详情。
加入财务圈的子账户会屏蔽代金券之外的其他金额。子用户要发起该请求,需要具有多用户访问控制的管理员权限或者FCFullControlPolicy多用户访问控制策略管理权限。
默认接口请求频率限制:20次/秒。
权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求,请参考鉴权认证。
注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden
,错误信息:AccessDenied
。
请求结构与示例
GET /v{version}/bill/resource/month?month={month}&productType={productType}&serviceType={serviceType}&queryAccountId={queryAccountId}&pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
Host: billing.baidubce.com
ContentType: application/json
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 > | 资源月账单列表 |
响应示例
HTTP/1.1 200 OK
x-bce-request-id: d4591fcf-025b-46bc-81eb-91ddda4e27bc
Server: BWS
Date: Tue, 09 Apr 2019 11:01:10 GMT
Content-Type: application/json;charset=UTF-8
{
"billMonth":"2019-02",
"beginTime":"2019-02-01",
"endTime":"2019-02-18",
"accountId":"xxx",
"loginName":"xxx",
"subAccountId":"/",
"subLoginName":"/",
"ouName":"/",
"pageNo":1,
"pageSize":20,
"totalCount":1,
"bills":[
{
"vendor":"百度智能云",
"accountId":"xxx",
"serviceType":"SCS",
"serviceTypeName":"简单缓存服务",
"productType":"postpay",
"region":"bj",
"instanceId":"30749",
"orderId":"/",
"orderType":"/",
"orderTypeDesc":"/",
"orderPurchaseTime":"2018-01-07T07:10:24.000Z",
"startTime":"2019-01-31T16:00:00.000Z",
"endTime":"2019-02-28T15:59:59.000Z",
"configurationCH":"容量:1G",
"tag":"tag:value",
"duration":"/",
"chargeItem":"RunningTimeMinutes",
"chargeItemDesc":"运行时间",
"amount":"35909",
"amountUnit":"分钟",
"discountAmount":"",
"unitPrice":"0.003333元/分钟",
"pricingUnit":"分钟",
"discountUnit":"100.00",
"tex":6,
"catalogPrice":119.68,
"originPrice":119.68,
"financePrice":119.68,
"cash":119.68,
"rebate":0,
"creditCost":0,
"creditRefund":0,
"debt":0,
"noPaidPrice":0,
"couponPrice":0,
"discountCouponPrice":0,
"discountPrice":0,
"sysGold":0
}
]
}
说明: JSON请求响应项的命名规则是首字母小写的驼峰格式。