文档首页 > > API参考> 管理客户> 注册客户> 创建客户

创建客户

分享
更新时间: 2020/03/05 GMT+08:00

功能介绍

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

注意事项:

  • 该接口只允许使用合作伙伴AK/SK或者Token调用。
  • 合作伙伴销售平台创建客户的页面必须体现华为云用户协议隐私政策声明
  • 此接口会为客户创建委托授权,用于将合作伙伴的Token置换成客户Token,即允许合作伙伴以客户的身份做资源开通、查询等相关操作。因此合作伙伴销售平台在调用此接口前请先获得客户授权说明。
  • 如果创建客户的时候输入手机号,在调用该接口前,请先调用“发送验证码”接口获取验证码。
  • 调用该接口为客户创建华为云账号后,如果想从合作伙伴销售平台跳转至华为云官网,还需要进行SAML认证,具体请参见“Web UI方式”中的“SAML认证”。
  • 如果创建的时候不输入手机号,那么客户将无法收到华为云发出的任何提醒短信,需要客户自己登录到华为云平台补充手机号。
  • 调用“创建客户”接口时,华为云会同步创建华为云客户账号,将客户ID及账号名返回给伙伴平台,然后华为云异步完成客户与伙伴的关联。伙伴与客户的关联结果可通过“查询客户列表”查询。
  • 合作伙伴调用该接口创建的客户为合作伙伴的垫付类客户。

URI

POST /v1.0/{partner_id}/partner/customer-mgr/customer

参数说明请参见下表。

参数

是否必选

取值范围

描述

partner_id

最大长度:64

合作伙伴ID(华为分配)。

获取方法请参见如何获取合作伙伴ID(partner_id)

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

domainName

String

最大长度:32

最小长度:5

客户的华为云账号名。

如果为空,随机生成。

不能以“op_”或“shadow_”开头且不能全为数字。

校验长度(5到32位)和规则^([a-zA-Z_-]([a-zA-Z0-9_-])*)$。

mobilePhone

String

最大长度:32

手机号。

目前系统只支持中国手机,必须全部是数字。

示例:13XXXXXXXXX

countryCode

String

[0086]

手机国家码,目前只支持0086,输入手机号的情况下,该字段如果不填写,系统默认是0086。

verificationCode

String

最大长度:10

验证码。

请调用“发送验证码”接口获取。

如果手机号不存在,则不需要输入验证码。

xAccountId

String

最大长度:128

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

xAccountType

String

最大长度:64

华为分给合作伙伴的平台标识。

该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值

password

String

长度:[6-32]

密码规则如下:

  • 至少包含以下四种字符中的两种: 大写字母、小写字母、数字、特殊字符;
  • 不能和账号名或倒序的账号名相同;
  • 不能包含手机号。

如果为空,密码随机生成。

isCloseMarketMs

String

长度:[0-10]

是否关闭营销消息的发送:

true:关闭;

false:不关闭(默认)。

cooperationType

String

-

合作类型。

1:推荐。

仅仅支持1,如果不传递,默认会创建成垫付模式的客户。

请求示例

POST  https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/customer HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "domainName":"xxxxxxx",
    "mobilePhone":"xxxxxxxxxxx",
    "countryCode":"0086",
    "verificationCode":"xxxxxx",
    "xAccountId":"xxxxxxx",
    "xAccountType":"xxxxxxx",
    "cooperationType":"1"
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

最大长度:16

状态码。具体请参考状态码。只有失败才会返回这个参数。

error_msg

String

最大长度:1024

错误描述信息。只有失败才会返回这个参数。

domainId

String

最大长度:64

客户ID。

只有成功或客户向伙伴授权发生异常(CBC.5025)时才会返回。

domainName

String

最大长度:64

客户的华为云账号名。

  • 若请求参数中传递了此参数值,此处返回的响应值与请求参数中取值一致。
  • 若请求参数中未传递此参数值,此处返回的响应值为系统随机生成的32位字符串。

只有成功或客户向伙伴授权发生异常(CBC.5025)时才会返回。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  

{
  "domainId":"xxxxxxx",
  "domainName":"xxxxxxx"
}

状态码

HTTP状态码

错误码

错误描述

400

CBC.0100

输入参数校验失败。

请根据“请求消息”中请求参数的描述检查输入的参数是否满足条件。

401

CBC.0154

token非法/过期。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

500

CBC.4006

手机号校验失败。

500

CBC.4008

有验证码,但是已经失效。

500

CBC.4009

有验证码,但是校验失败次数已经大于3。

500

CBC.4010

校验客户端输入的验证码错误。

400

CBC.0101

参数无效。

500

CBC.5012

客户登录名已经存在。

500

CBC.5014

客户手机号已经存在。

500

CBC.5015

客户登录名格式不合法。

500

CBC.5017

客户手机号格式不合法。

500

CBC.5018

xAccountId重复。

500

CBC.5019

客户数量超过license限制。

500

CBC.5025

客户向伙伴授权时发生异常。

500

CBC.7209

手机号注册数量超过上限。

500

CBC.7228

客户密码格式不合法。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区