客户运营能力-查询汇总账单:URI

时间:2024-05-16 19:42:34

URI

GET /v2/bills/customer-bills/monthly-sum

参数说明请参见下表。

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

bill_cycle

String

最大长度:8

查询消费汇总数据所在的账期,东八区时间,格式为YYYY-MM。

service_type_code

String

最大长度:64

云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。

此参数不携带或携带值为空时,不作为筛选条件。

enterprise_project_id

String

最大长度:64

企业项目标识(企业项目ID)。

  • default项目对应ID:0
  • 未归集(表示该云服务不支持企业项目管理能力)项目对应ID:-1
  • 其余项目对应ID获取方法请参见如何获取企业项目ID

此参数不携带或携带值为空时,不作为筛选条件。携带值为null时,作为筛选条件。不支持携带值为空串。

method

String

最大长度:64

查询方式。

  • oneself:自身
  • sub_customer:企业子客户
  • all:自己和企业子客户

此参数不携带或携带值为空时,默认值为“all”,如果没有企业子客户,all的时候也是查询客户自己的数据。

说明:

若需要查询财务独立企业子的账单信息,前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。

sub_customer_id

String

最大长度:64

企业子客户的账号ID。

说明:
  • 如果method取值不为sub_customer,则该参数无效。
  • 如果method取值为sub_customer,则该参数不能为空。

offset

Integer

[0-最大整数]

偏移量,从0开始。默认值为0。

说明:

offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。

示例1,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。

示例2,查询总数20条,期望每页返回10条数据,则获取第一页数据,入参offset填写0,limit填写10;获取第二页数据,入参offset填写10,limit填写10。

limit

Integer

[1-1000]

每次查询的数量。默认值为10。

support.huaweicloud.com/api-oce/mbc_00008.html