请登录后查看
ListSubCustomers
查询客户列表
伙伴可以查询合作伙伴的客户信息列表。
伙伴登录合作伙伴中心查询客户信息列表请参见这里。
该接口只允许使用合作伙伴AK/SK或者Token调用。
名称 | 类型 | IN | 必选 | 描述 |
---|---|---|---|---|
X-Auth-Token | string | header | 是 | 合作伙伴Token调用 |
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
account_name | string | 否 | 客户登录名称(如果客户创建了IAM用户,此处需要填写主账号登录名称。关于主账号和IAM用户的具体介绍请参见身份管理中“账号”和“IAM用户”的描述)。 支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配;不支持携带空格查询。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
customer | string | 否 | 客户的实名认证名称,支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配;不支持携带空格查询。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
offset | integer | 否 | 偏移量,从0开始。默认值为0。 说明: offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。 例如,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。 |
limit | integer | 否 | 每次查询的客户数量。默认值为10。 |
label | string | 否 | 标签,支持模糊查找。仅支持前缀匹配、后缀匹配、中间匹配;不支持携带空格查询;不支持英文大小写模糊匹配查询。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
association_type | string | 否 | 关联类型: 1:顾问销售2:代售 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
associated_on_begin | string | 否 | 关联时间区间段开始,UTC时间。 格式:YYYY-MM-DD'T'hh:mm:ss'Z',例如“2019-05-06T08:05:01Z”。 此参数不携带或携带值为null时,不作为筛选条件,不支持携带值为空串。 |
associated_on_end | string | 否 | 关联时间区间段结束,UTC时间。 格式:YYYY-MM-DD'T'hh:mm:ss'Z',例如“2019-05-06T08:05:01Z”。 此参数不携带或携带值为null时,不作为筛选条件,不支持携带值为空串。 |
customer_id | string | 否 | 客户账号ID。您可以调用查询客户列表接口获取customer_id,或者可以从创建客户接口的响应获取domain_id。此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 |
indirect_partner_id | string | 否 | 云经销商ID。获取方法请参见查询云经销商列表。如果需要查询云经销商的子客户列表,必须携带该字段。除此之外,此参数不做处理。 |
查询子客户列表响应
名称 | 类型 | 描述 |
---|---|---|
customer_infos | Array of CustomerInformation objects | 客户信息列表。 具体请参见表1。 |
count | integer | 总记录数。 |
名称 | 类型 | 描述 |
---|---|---|
customer | string | 实名认证名称。 |
account_name | string | 客户登录名称(如果客户创建了子用户,此处返回主账号登录名称)。 |
customer_id | string | 客户账号ID。 |
associated_on | string | 客户和伙伴关联时间。 UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”,其中,HH范围是0~23,mm和ss范围是0~59。 |
association_type | string | 关联类型: 1:顾问销售2:代售 |
label | string | 标签。 |
telephone | string | 客户电话号码。 |
verified_status | string | 实名认证状态: -1:未实名认证0:实名认证审核中1:实名认证不通过2:已实名认证 |
country_code | string | 国家码,电话号码的国家码前缀。 例如:中国 0086。 |
customer_type | integer | 客户类型: -1:无类型0:个人1:企业 客户刚注册的时候,没有具体的客户类型,为“-1:无类型”,客户可以在账号中心通过设置客户类型或者在实名认证的时候,选择对应的企业/个人实名认证来决定自己的类型。 |
is_frozen | integer | 是否冻结: 0:否1:客户账号冻结2:客户账号和资源冻结 该字段预留。 |
account_managers | Array of AccountManager objects | 该客户对应的客户经理信息,目前只支持1个,具体参见表2。 |
xaccount_id | string | 伙伴销售平台的用户唯一标识,该标识的具体值由伙伴分配。 |
xaccount_type | string | 华为分配给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 |
customer_level | string | 客户等级。具体等级体系和权益请参见客户等级体系。 V0V1V2V3V4V5 |
email | string | |参数名称:客户邮箱| |参数的约束及描述:该参数为字符串 范围限制:0-256。| |
名称 | 类型 | 描述 |
---|---|---|
account_name | string | 客户经理登录名称。 |
参数错误
"POST https://bss.myhuaweicloud.com/v2/partners/sub-customers/query"
{
"account_name": "betahc_kehu107",
"customer": "sun***01",
"offset": 0,
"limit": 10,
"label": "sunny",
"association_type": "1",
"associated_on_begin": "2019-05-06T08:05:01Z",
"associated_on_end": "2019-05-06T08:05:01Z",
"customer_id": "065024********e90f44c01cbccfa280",
"indirect_partner_id": "si3fjg8ugf********"
}
查询子客户列表响应
{
"customer_infos": [
{
"customer": "sun***01",
"account_name": "betahc_kehu107",
"customer_id": "0b11fa********870f20c003f6a53940",
"associated_on": "2021-01-05T06:35:51Z",
"association_type": "1",
"label": "sunny",
"telephone": "134****6666",
"verified_status": "2",
"country_code": "0086",
"customer_type": 0,
"is_frozen": "0",
"account_managers": [
{
"account_name": "tan_ma"
}
],
"xaccount_id": "98**9707",
"xaccount_type": "***_IDP",
"customer_level": "V0",
"email": "test***@123"
}
],
"count": "1"
}