运营能力开放
  • 注册客户(伙伴)
    • 校验客户注册信息CheckUserIdentity
    • 创建客户CreateSubCustomer
    • 发送验证码SendVerificationMessageCode
  • 管理客户(伙伴)
    • 查询客户新客标签ListSubCustomerNewTag
    • 查询客户列表ListSubCustomers
  • 实名认证(伙伴)
    • 申请实名认证变更ChangeEnterpriseRealnameAuthentication
    • 申请企业实名认证CreateEnterpriseRealnameAuthentication
    • 申请个人实名认证CreatePersonalRealnameAuth
    • 查询实名认证审核结果ShowRealnameAuthenticationReviewResult
  • 管理云经销商(伙伴)
    • 查询云经销商列表ListIndirectPartners
  • 管理优惠券(公共)
    • 查询优惠券列表ListSubCustomerCoupons
  • 管理优惠券(伙伴)
    • 发放优惠券CreatePartnerCoupons
    • 查询已发放的优惠券ListIssuedPartnerCoupons
    • 查询优惠券的发放回收记录ListPartnerCouponsRecord
    • 查询优惠券额度ListQuotaCoupons
    • 回收优惠券ReclaimPartnerCoupons
  • 管理云经销商优惠券(伙伴)
    • 查询代金券额度的发放回收记录ListCouponQuotasRecords
    • 查询已发放的代金券额度ListIssuedCouponQuotas
    • 回收云经销商的代金券额度ReclaimCouponQuotas
    • 向云经销商发放代金券额度UpdateCouponQuotas
  • 管理客户账户(伙伴)
    • 查询客户账户余额ListCustomersBalancesDetail
    • 查询收支明细ListPartnerAccountChangeRecords
    • 查询调账记录ListPartnerAdjustRecords
    • 查询云经销商账户余额ListPartnerBalances
    • 回收客户账户余额ReclaimToPartnerAccount
    • 向客户账户拨款UpdateCustomerAccountAmount
  • 管理云经销商账户(伙伴)
    • 回收云经销商账户拨款ReclaimIndirectPartnerAccount
    • 向云经销商账户拨款UpdateIndirectPartnerAccount
  • 管理账户(客户)
    • 查询收支明细(客户)ListCustomerAccountChangeRecords
    • 查询储值卡列表ListStoredValueCards
    • 查询账户余额ShowCustomerAccountBalances
  • 购买云服务(公共)
    • 查询按需产品价格ListOnDemandResourceRatings
    • 查询包年/包月产品价格ListRateOnPeriodDetail
    • 查询待续订包年包月资源的续订金额ListRenewRateOnPeriod
  • 管理包年/包月订单(公共)
    • 查询订单列表ListCustomerOrders
    • 查询订单详情ShowCustomerOrderDetails
    • 查询退款订单的金额详情ShowRefundOrderDetails
  • 管理包年/包月订单(客户)
    • 设置包年/包月资源自动续费AutoRenewalResources
    • 取消包年/包月资源自动续费CancelAutoRenewalResources
    • 取消待支付订单CancelCustomerOrder
    • 退订包年/包月资源CancelResourcesSubscription
    • 查询订单可用优惠券ListOrderCouponsByOrderId
    • 查询订单可用折扣ListOrderDiscounts
    • 查询客户包年/包月资源列表ListPayPerUseCustomerResources
    • 支付包年/包月产品订单PayOrders
    • 续订包年/包月资源RenewalResources
    • 设置或取消包年/包月资源到期转按需UpdatePeriodToOnDemand
  • 管理按需资源(伙伴)
    • 查询客户按需资源列表ListCustomerOnDemandResources
  • 管理客户消费(伙伴)
    • 查询伙伴子客户消费记录ListSubCustomerBillDetail
  • 管理账单(伙伴)
    • 查询伙伴消费子客户列表ListConsumeSubCustomers
    • 查询客户月度消费账单ListSubcustomerMonthlyBills
  • 管理账单(客户)
    • 查询流水账单ListCustomerBillsFeeRecords
    • 查询资源详单ListCustomerselfResourceRecordDetails
    • 查询资源消费记录ListCustomerselfResourceRecords
    • 查询95计费资源用量明细ListResourceUsage
    • 查询95计费资源用量汇总ListResourceUsageSummary
    • 查询汇总账单ShowCustomerMonthlySum
  • 管理企业项目(客户)
    • 开通客户企业项目权限CreateEnterpriseProjectAuth
  • 管理企业多账号(客户)
    • 企业主账号向企业子账号拨款优惠券ClaimEnterpriseMultiAccountCoupon
    • 创建企业子账号CreateSubEnterpriseAccount
    • 查询企业子账号可回收余额ListEnterpriseMultiAccount
    • 查询企业组织结构ListEnterpriseOrganizations
    • 查询企业子账号列表ListEnterpriseSubCustomers
    • 查询企业子账号可回收优惠券列表ListMultiAccountRetrieveCoupons
    • 查询企业主账号可拨款优惠券列表ListMultiAccountTransferCoupons
    • 企业主账号从企业子账号回收优惠券ReclaimEnterpriseMultiAccountCoupon
    • 企业主账号从企业子账号回收拨款ReclaimSubEnterpriseAmount
    • 发送短信验证码SendSmsVerificationCode
    • 查询企业主账号可拨款余额ShowMultiAccountTransferAmount
    • 企业主账号向企业子账号拨款UpdateSubEnterpriseAmount
  • 查询国家省市信息(公共)
    • 查询城市信息ListCities
    • 查询区县信息ListCounties
    • 查询省份信息ListProvinces
  • 管理产品(公共)
    • 查询度量单位进制ListConversions
    • 查询度量单位列表ListMeasureUnits
    • 查询资源类型列表ListResourceTypes
    • 根据云服务类型查询资源列表ListServiceResources
    • 查询云服务类型列表ListServiceTypes
    • 查询使用量类型列表ListUsageTypes
  • 管理产品(伙伴)
    • 查询产品的折扣和激励策略ListIncentiveDiscountPolicies
  • 管理成本(客户)
    • 查询成本数据ListCosts
    • 查询月度成本ListCustomerBillsMonthlyBreakDown
  • 管理资源包(客户)
    • 查询资源包列表ListFreeResourceInfos
    • 查询资源包使用明细ListFreeResourcesUsageRecords
    • 查询资源包使用量ListFreeResourceUsages

ListSubCustomers

查询客户列表

POST
https://bss.myhuaweicloud.com/v2/partners/sub-customers/query
高级设置
只看必填项
填写默认值
密文显示特定参数
*
Region
Headers
*
Authorization
Body
*{
*
account_name
:
*
customer
:
*
offset
:
*
limit
:
*
label
:
*
association_type
:
*
associated_on_begin
:
*
associated_on_end
:
*
customer_id
:
*
indirect_partner_id
:
}
接口说明

伙伴可以查询合作伙伴的客户信息列表。

伙伴登录合作伙伴中心查询客户信息列表请参见这里

约束说明

该接口只允许使用合作伙伴AK/SK或者Token调用。

URL
POST  https://bss.myhuaweicloud.com/v2/partners/sub-customers/query
请求参数
名称类型IN必选描述
X-Auth-Token
stringheader

合作伙伴Token调用

Body参数
名称类型必选描述
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。获取方法请参见查询云经销商列表。如果需要查询云经销商的子客户列表,必须携带该字段。除此之外,此参数不做处理。

返回参数
返回码: 200

查询子客户列表响应

名称类型描述
customer_infos
Array of CustomerInformation objects

客户信息列表。 具体请参见表1。

count
integer

总记录数。

200 customer_infos
名称类型描述
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。|

200 customer_infos.account_managers
名称类型描述
account_name
string

客户经理登录名称。

返回码: 400

参数错误

请求示例
示例 1
"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********" }
返回示例
返回码:200

查询子客户列表响应

示例 1
{
"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"
}
SDK
点击 运营能力开放 (BSS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明
变更历史
2025-02-27
查询客户列表
POST
   ListSubCustomers
修改
变更参数
2025-01-23
查询客户列表
POST
   ListSubCustomers
修改
变更参数
2024-10-31
查询客户列表
POST
   ListSubCustomers
修改
变更参数
2024-04-03
查询客户列表
POST
   ListSubCustomers
修改
变更参数

本文导读

接口说明
约束说明
URL
请求参数
返回参数
请求示例
返回示例
SDK
错误码
变更历史