创建客户（旧）
功能介绍
在伙伴销售平台创建客户时同步创建华为云账号，并将客户在伙伴销售平台上的账号与华为云账号进行映射。同时，创建的华为云账号与伙伴账号关联绑定。
注意事项：
- 该接口只允许使用合作伙伴AK/SK或者Token调用。
- 合作伙伴销售平台创建客户的页面必须体现华为云用户协议和隐私政策声明。
- 此接口会为客户创建委托授权，用于将合作伙伴的Token置换成客户Token，即允许合作伙伴以客户的身份做资源开通、查询等相关操作。因此合作伙伴销售平台在调用此接口前请先获得客户授权说明。
- 如果创建客户的时候输入邮箱，在调用该接口前，请先调用“14.1.2.1.2-发送验证码（旧）”接口获取验证码。
- 调用该接口为客户创建华为云账号后，如果想从合作伙伴销售平台跳转至华为云官网，还需要进行SAML认证，具体请参见“Web UI方式”中的“SAML认证”。
- 如果创建的时候不输入邮箱，那么客户将无法收到华为云发出的任何提醒邮件，需要客户自己登录到华为云平台补充邮箱。
- 调用“创建客户”接口时，华为云会同步创建华为云客户账号，将客户ID及账号名返回给伙伴平台，然后华为云异步完成客户与伙伴的关联。伙伴与客户的关联结果可通过“查询客户列表（旧）”查询。
- 合作伙伴调用该接口创建的客户为合作伙伴的转售类客户。
- 自2022年8月1日起，密码长度至少为8个字符。
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_-])*)$。 此参数不携带或携带值为空串或携带值为null时，随机生成。 |
|
|
否 |
String |
最大长度：64 |
邮箱地址。 必须含有@。 此参数不携带或携带值为null时，不被赋值；携带值为空串时，赋值空串。 |
|
verificationCode |
否 |
String |
[1-10] |
验证码。 请调用“14.1.2.1.2-发送验证码（旧）”接口获取。 如果邮箱不存在，不需要输入验证码。 此参数不携带或携带值为null时，不做处理；不支持携带值为空串。 |
|
domainArea |
是 |
String |
最大长度：2 |
客户所属国家地区的两位字母编号。该字母编号遵循ISO 3166标准。 例如：墨西哥 MX |
|
xAccountId |
是 |
String |
最大长度：128 |
伙伴销售平台的用户唯一标识，该标识的具体值由伙伴分配。 |
|
xAccountType |
是 |
String |
最大长度：64 |
华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 |
|
password |
否 |
String |
长度：[8-32] |
密码规则如下：
如果为空，密码随机生成。 此参数不携带或携带值为null时，密码随机生成；不支持携带值为空串。 |
|
isCloseMarketMs |
否 |
String |
长度：[0-10] |
是否关闭营销消息的发送： true：关闭； false：不关闭（默认）。 此参数不携带或携带值为空串或携带值为null时，赋值为false。 |
请求示例
POST https://bss-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/customer HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "domainName":"xxxxxxx", "email":"xxxxxxx@xxxxxxx", "domainArea":"xx", "verificationCode":"xxxxxx", "xAccountId":"xxxxxxx", "xAccountType":"xxxxxxx" }
响应消息
响应参数
|
参数 |
参数类型 |
取值范围 |
描述 |
|---|---|---|---|
|
error_code |
String |
最大长度：16 |
状态码。具体请参考状态码。只有失败才会返回这个参数。 |
|
error_msg |
String |
最大长度：1024 |
错误描述信息。只有失败才会返回这个参数。 |
|
domainId |
String |
最大长度：64 |
客户ID。 只有成功或客户向伙伴授权发生异常（CBC.5025）时才会返回。 |
|
domainName |
String |
最大长度：64 |
客户的华为云账号名。
只有成功或客户向伙伴授权发生异常（CBC.5025）时才会返回。 |
响应示例
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "domainId":"xxxxxxx", "domainName":"xxxxxxx" }
状态码
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
|
HTTP状态码 |
错误码 |
错误描述 |
|---|---|---|
|
400 |
CBC.0100 |
参数错误。 请根据“请求消息”中请求参数的描述检查输入的参数是否满足条件。 |
|
400 |
CBC. 50010059 |
一级经销商不允许关联子客户。 |
|
401 |
CBC.0154 |
token非法/过期。 |
|
403 |
CBC.0151 |
访问拒绝。 |
|
500 |
CBC.0999 |
其他错误。 |
|
500 |
CBC.4007 |
邮箱校验失败。 |
|
500 |
CBC.4008 |
有验证码，但是已经失效。 |
|
500 |
CBC.4009 |
有验证码，但是校验失败次数已经大于3。 |
|
400 |
CBC.0101 |
参数无效。 |
|
500 |
CBC.5012 |
客户登录名已经存在。 |
|
500 |
CBC.5013 |
客户邮箱已经存在。 |
|
500 |
CBC.5015 |
客户登录名格式不合法。 |
|
400 |
CBC.5016 |
客户邮箱格式不合法。 |
|
500 |
CBC.5018 |
xAccountId重复。 |
|
500 |
CBC.5025 |
客户向伙伴授权时发生异常。 |
|
500 |
CBC.7228 |
客户密码格式不合法。 |
|
500 |
CBC.7254 |
目前不支持该国家客户注册华为云。 |
|
400 |
CBC.99000051 |
该手机号/邮箱已被华为报备，无法创建客户。 |
|
400 |
CBC.50010085 |
该伙伴企业目前处于受限状态，无法拓客创建关联关系。 |
|
400 |
CBC.50010086 |
该伙伴是云经销商，其关联的总经销商企业目前处于受限状态，无法拓客创建关联关系。 |
