运营能力开放
  • 注册客户(伙伴)
    • 校验客户注册信息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

CreateSubCustomer

创建客户

POST
https://bss.myhuaweicloud.com/v2/partners/sub-customers
高级设置
只看必填项
填写默认值
密文显示特定参数
*
Region
Headers
*
Authorization
Body
*{
*
domain_name
:
*
mobile_phone
:
*
verification_code
:
*
xaccount_id
:
*
xaccount_type
:
*
password
:
*
is_close_market_ms
:
*
cooperation_type
:
*
indirect_partner_id
:
*
include_association_result
:
}
接口说明

在伙伴销售平台创建客户时同步创建华为云账号,并将客户在伙伴销售平台上的账号与华为云账号进行映射。同时,创建的华为云账号与伙伴账号关联绑定。

华为云总经销商(一级经销商)可以注册云经销商(二级经销商)的子客户。注册完成后,子客户可以自动和云经销商绑定。

注意:

  • 调用该接口为客户创建华为云账号后,如果想从合作伙伴销售平台跳转至华为云官网,还需要进行SAML认证,具体请参见“Web UI方式”中的“SAML认证”。
  • 如果创建的时候不输入手机号,那么客户将无法收到华为云发出的任何提醒短信,需要客户自己登录到华为云平台补充手机号。
  • 调用“创建客户”接口时,华为云会同步创建华为云客户账号,将客户ID及账号名返回给伙伴平台,然后华为云异步完成客户与伙伴的关联。伙伴与客户的关联结果可通过“查询客户列表”查询。
约束说明

该接口只允许使用合作伙伴AK/SK或者Token调用。 合作伙伴调用该接口创建的客户为合作伙伴的垫付类客户。

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

合作伙伴Token调用

Body参数
名称类型必选描述
domain_name
string

客户的华为云账号名。 如果为空,随机生成。 不能以“op_”或“shadow_”开头且不能全为数字。 校验长度(5到32位)和规则^(a-zA-Z_-*)$。 此参数不携带或携带值为空串或携带值为null时,随机生成。

mobile_phone
string

手机号。 目前系统只支持中国的手机号。 示例:13XXXXXXXXX 此参数不携带或携带值为null时,不被赋值;携带值为空串时,赋值为空串。

verification_code
string

验证码。 请调用“发送验证码”接口获取。 如果手机号不存在,则不需要输入验证码。 此参数不携带或携带值为null时,不做处理;不支持携带值为空串。

xaccount_id
string

伙伴销售平台的用户唯一标识,该标识的具体值由伙伴分配。

xaccount_type
string

华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。

password
string

密码规则如下: 至少包含以下四种字符中的两种: 大写字母、小写字母、数字、特殊字符;不能和账号名或倒序的账号名相同;不能包含手机号。 如果为空,用户没有密码,则不能直接在华为云登录,只能通过伙伴系统SSO方式跳转到华为云。 此参数不携带或携带值为null时,密码随机生成;不支持携带值为空串。

is_close_market_ms
string

是否关闭营销消息的发送。 true:关闭false:不关闭(默认) 此参数不携带或携带值为空串或携带值为null时,赋值为false。

cooperation_type
string

合作类型。 1:顾问销售。 不传递或传递非1的值,默认会创建成代售模式的客户。

indirect_partner_id
string

云经销商ID。获取方法请参见查询云经销商列表。 如果需要创建云经销商的子客户,必须携带该字段。除此之外,此参数不做处理。

include_association_result
boolean

是否返回子客户的关联结果。 true:返回子客户和伙伴的关联结果false:不返回子客户和伙伴的关联结果 默认值为false。 此参数不携带或携带值为空串或携带值为null时,赋值为false。

返回参数
返回码: 200

创建客户返回

名称类型描述
domain_id
string

客户ID。 只有成功或者错误码在CBC.99000050时才会返回。

domain_name
string

客户的华为云账号名。 若请求参数中传递了此参数值,此处返回的响应值与请求参数中取值一致。若请求参数中未传递此参数值,此处返回的响应值为系统随机生成的32位字符串。 只有成功时或者错误码在CBC.99000050时才会返回。

返回码: 400

|CBC.0100:输入参数校验失败 parameter error| |CBC.0101:参数无效 parameter invalid|

请求示例
示例 1
"POST https://bss.myhuaweicloud.com/v2/partners/sub-customers"
{ "domain_name": "test", "mobile_phone": "188****8888", "verification_code": "253***", "xaccount_id": "35rey****", "xaccount_type": "***_IDP", "password": "*******", "is_close_market_ms": "true", "cooperation_type": "1", "indirect_partner_id": "a0d736********aab6502d1a828c1809", "include_association_result": false }
返回示例
返回码:200

创建客户返回

示例 1
{
"domain_id": "06a7969058802f0c0f01c00b91846780",
"domain_name": "a0d736359ada40aab6502d1a828c1809"
}
SDK
点击 运营能力开放 (BSS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明
变更历史
2024-05-30
创建客户
POST
   CreateSubCustomer
修改
变更参数
2024-04-03
创建客户
POST
   CreateSubCustomer
修改
变更参数

本文导读

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