查询产品的折扣和激励策略-ListIncentiveDiscountPolicies

功能介绍

伙伴在伙伴销售平台上查询产品的折扣和激励策略。

伙伴登录合作伙伴中心查看产品的折扣和激励策略请参见这里。

接口约束

该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见为组织人员分配权限。

接口对应的权限项如下：

场景	子场景	接口名称	接口URL	权限项	权限项名称
管理产品	查询产品信息	查询产品的折扣和激励策略	GET /v2/products/incentive-discount-policies	BPC_ITEM_SALES_040100	销售-激励-产品激励策略-产品折扣与激励策略查看

URI

GET /v2/products/incentive-discount-policies

参数说明请参见表查询参数。

表1 查询参数
参数	是否必选	参数类型	取值范围	描述
time	是	String	最大长度：20	查询策略的指定时间。东八区时间，格式：YYYY-MM。说明：实际查询结果为指定时间所在月最后一天23:59:59的策略情况。
service_type_code	否	String	最大长度：64	云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表-ListServiceTypes接口获取。此参数不携带或携带值为空或携带值为null时，不作为筛选条件；携带值为空串，作为筛选条件。
offset	否	Integer	[0-最大整数]	偏移量，从0开始。默认值为0。此参数不携带或携带值为空或携带值为null时，取默认值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-100]	每次查询的数量，默认值为10。此参数不携带或携带值为空或携带值为null时，取默认值10；不支持携带值为空串。

请求消息

请求参数

无

请求示例

GET https://bss.myhuaweicloud.com/v2/products/incentive-discount-policies?time=2021-10&service_type_code=hws.service.type.workplace&offset=0&limit=10 HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数	参数类型	取值范围	描述
error_code	String	最大长度：16	状态码。具体请参见状态码。
error_msg	String	最大长度：1024	错误描述信息。
total_count	Integer	-	查询总条数。
policies	List<IncentiveAndDiscountPolicy>	-	产品折扣和激励策略信息列表。具体请参见表2。

表2 IncentiveAndDiscountPolicy
参数	参数类型	取值范围	描述
service_type_code	String	最大长度：64	云服务类型编码。例如OBS的云服务类型编码为“hws.service.type.obs”。
service_type_name	String	最大长度：200	云服务类型名称。例如ECS的云服务类型名称为“弹性云服务器”。
incentive_policy	String	最大长度：64	激励策略。 0：非特定产品 1：特定产品 2：无业绩无返点 13：有业绩无返点
allow_discount	String	最大长度：64	是否允许应用伙伴授予折扣。 YES：允许应用 NO：不许应用

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
    "policies": [
        {
            "service_type_code": "hws.service.type.workplace",
            "service_type_name": "华为云WeLink",
            "incentive_policy": "0",
            "allow_discount": "YES"
        }
    ],
    "total_count": 1
}