更新时间:2024-05-13 GMT+08:00
分享

查询云经销商列表

功能介绍

华为云总经销商(一级经销商)可以查询云经销商(二级经销商)列表。

一级经销商在伙伴中心查询二级经销商列表的方式请参见这里

接口约束

该接口只允许使用华为云总经销商的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-TokenMIIPAgYJKoZIhvcNAQcCo...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

表1 IndirectPartnerInfo

参数

参数类型

取值范围

描述

indirect_partner_id

String

最大长度:64

云经销商ID。

mobile_phone

String

最大长度:20

云经销商的手机号码。

email

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"
    }
  ]
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

400

CBC.0100

参数错误。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

相关文档