查询云经销商列表
接口约束
该接口只允许使用华为云总经销商的AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/partners/indirect-partners/query
请求消息
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
account_name |
否 |
String |
最大长度:64 |
云经销商伙伴的账号名。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
associated_on_begin |
否 |
String |
最大长度:20 |
云经销商关联华为云总经销商的开始时间。 UTC时间(包括时区),比如2016-03-28T00:00:00Z。 此参数不携带或携带值为null时,不作为筛选条件。 |
associated_on_end |
否 |
String |
最大长度:20 |
云经销商关联华为云总经销商的结束时间。 UTC时间(包括时区),比如2016-03-28T00:00:00Z。 此参数不携带或携带值为null时,不作为筛选条件。 |
indirect_partner_id |
否 |
String |
最大长度:64 |
云经销商ID。获取方法请参见查询云经销商列表。 如果需要查询具体某个云经销商伙伴,必须携带该字段。除此之外,此参数不做处理。 |
offset |
否 |
Integer |
[0-40000000] |
偏移量,从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-100] |
每次查询的数量限制。默认值为10。 |
POST https://bss.myhuaweicloud.com/v2/partners/indirect-partners/query HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "account_name": "account_name", "associated_on_begin": "2017-12-17T10:32:02Z", "associated_on_end": "2017-12-17T10:32:02Z", "offset": 0, "limit": 10, "indirect_partner_id": "c9e731c4663646988ef4cdb3122837b6" }
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
error_code |
String |
最大长度:20 |
状态码。具体请参考状态码。只有失败才返回该字段。 |
error_msg |
String |
最大长度:1000 |
错误描述信息。只有失败才返回该字段。 |
count |
Integer |
[0-最大整数] |
符合条件的记录个数,只有成功的时候出现。 |
indirect_partners |
List<IndirectPartnerInfo> |
- |
云经销商列表,具体参见表1。 |
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
indirect_partner_id |
String |
最大长度:64 |
云经销商ID。 |
mobile_phone |
String |
最大长度:20 |
云经销商的手机号码。 |
|
String |
最大长度:200 |
云经销商的邮箱。 |
account_name |
String |
最大长度:64 |
云经销商的账户名。 |
name |
String |
最大长度:255 |
云经销商的名称。 |
associated_on |
String |
最大长度:20 |
云经销商关联华为云总经销商的时间。 UTC时间(包括时区),例如2016-03-28T00:00:00Z。 |
account_manager_id |
String |
最大长度:64 |
客户经理登录账户名。 |
account_manager_name |
String |
最大长度:255 |
客户经理的名称。 |
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "count": 1, "indirect_partners": [ { "indirect_partner_id": "c9e731c4663646988ef4cdb3122837b6", "mobile_phone": "186xxxxxxxxx", "email": "xxx@huawei.com", "account_name": "account_name", "name": "account_name2", "associated_on": "2017-12-17T10:32:02Z", "account_manager_id":"manager_id", "account_manager_name":"manager_name" } ] }