合作伙伴中心-查询代金券额度的发放回收记录:URI

时间:2023-11-01 16:20:13

URI

GET /v2/partners/coupon-quotas/records
表1 查询参数

参数

是否必选

参数类型

取值范围

描述

indirect_partner_id

String

最大长度:64

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

  • 为空表示查询所有的代金券额度发放回收记录。
  • 不为空表示仅查询与该云经销商相关的代金券额度发放回收记录。

默认查询所有云经销商的代金券额度发放回收记录。

quota_id

String

最大长度:64

云经销商的代金券额度ID。获取方法请参见查询优惠券额度

即华为云总经销商给云经销商发放代金券额度时,产生的云经销商的代金券额度ID,或者从云经销商回收代金券额度时,云经销商的代金券额度ID。

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

operation_time_begin

String

最大长度:20

查询条件:操作起始时间。

UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。

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

operation_time_end

String

最大长度:20

查询条件:操作截止时间。

UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。其中,HH范围是0~23,mm和ss范围是0~59。

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

parent_quota_id

String

最大长度:64

父额度ID。

这即华为云总经销商给云经销商发放代金券额度时,华为云总经销商的额度ID,或者从云经销商回收代金券额度时,回收的华为云总经销商的额度ID。

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

operation_type

String

最大长度:8

操作类型。

  • 10:发放额度
  • 11:回收额度

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

limit

Integer

[1-100]

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

offset

Integer

[0-最大整数]

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

说明:

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

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

support.huaweicloud.com/api-bpconsole/espp_00007.html