合作伙伴中心-查询客户消费记录(旧):URI

时间:2024-06-28 08:45:26

URI

GET /v2/bills/partner-bills/subcustomer-bills/res-fee-records

参数说明请参见表1-1

表1 查询参数

参数

是否必选

参数类型

取值范围

描述

customer_id

String

最大长度:64

客户账号ID。您可以调用查询客户列表接口获取customer_id。

cycle

String

最大长度:10

查询的客户消费记录所在账期,格式:YYYY-MM。

charge_mode

String

最大长度:4

计费模式。

  • 1 : 包年/包月
  • 3:按需
  • 10: 预留实例

cloud_service_type

String

最大长度:64

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

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

region

String

最大长度:64

云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

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

bill_type

Integer

-

账单类型。

  • 1:消费-新购
  • 2:消费-续订
  • 3:消费-变更
  • 4:退款-退订
  • 5:消费-使用
  • 8:消费-自动续订
  • 9:调账-补偿
  • 14:消费-服务支持计划月末扣费
  • 16:调账-扣费
  • 18:消费-按月付费
  • 20:退款-变更

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

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。

resource_id

String

最大长度:64

资源ID。

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

include_zero_record

Boolean

-

返回是否包含应付金额为0的记录。

  • true:包含
  • false:不包含

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

indirect_partner_id

String

最大长度:64

云经销商ID。获取方法请参见查询云经销商列表

如果华为云总经销商需要查询客户在云经销商关联期间的消费,需要携带该字段;除此之外,此参数不做处理。否则只能查询该客户在与自己关联期间的消费。

bill_date_begin

String

最大长度:20

查询的资源消费记录的开始日期,格式为YYYY-MM-DD。

此参数不携带或携带值为空或携带值为空串时,默认值取cycle月份的第一天。

说明:

必须和cycle(即资源的消费账期)在同一个月。

bill_date_end

String

最大长度:20

查询的资源消费记录的结束日期,格式为YYYY-MM-DD。

此参数不携带或携带值为空或携带值为空串时,默认值取cycle月份的最后一天。

说明:
  • 必须和cycle(即资源的消费账期)在同一个月。
  • bill_date_begin和bill_date_end两个参数必须同时出现,否则仅按照cycle(即资源的消费账期)进行查询。
support.huaweicloud.com/api-bpconsole/mt_000501.html