财务相关

    资源月账单

    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,
                 "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请求响应项的命名规则是首字母小写的驼峰格式。

    上一篇
    访问控制
    下一篇
    附录