文档首页 > > API参考> 管理企业> 管理企业多账号> 创建企业子账号

创建企业子账号

分享
更新时间: 2019/11/15 GMT+08:00

功能介绍

企业主账号在客户自建平台创建企业子账号。

注意事项:

该接口只允许使用企业主账号AK/SK或者Token调用。

URI

POST /v1.0/{domain_id}/customer/customer-mgr/enterprise-customers

参数说明请参见下表。

参数

是否必选

取值范围

描述

domain_id

最大长度:64

客户账号ID,只能使用企业主账号。

获取方法请参见如何获取customer_id/domain_id

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

partyId

String

最大长度:20

子账号挂载的组织单元,填写组织单元的Party ID,通过查询企业组织结构接口的响应获得。

displayName

String

最大长度:64

企业子账号的显示名称。

  • 不限制特殊字符。

subCustomerAssociationType

Integer

-

子账号关联类型:

1:同一法人。

注:关联类型目前只能是同一法人。

permissionIds

List<String>

-

申请的权限列表。

支持的权限项参见表2

newSubCustomer

NewCustomer

-

企业子账号信息。具体请参见表1

表1 NewCustomer

参数

是否必选

参数类型

取值范围

描述

customerName

String

最大长度:32

客户主账号登录名。

email

String

最大长度:128

客户的Email。如果usePriMobilePhone为Y,则这个参数可选,否则必选。

mobilePhone

String

最大长度:20

管理员手机号码。如果usePriMobilePhone为Y,则这个参数可选,否则必选。

countryCode

String

最大长度:10

管理员手机号码国际区号,纯数字。如果usePriMobilePhone为Y,则这个参数可选,否则必选。

{'(澳大利亚)':'0043','(比利时)':'0032','(巴西)':'0055','(保加利亚)':'00359','(中文)' :'0086','(克罗地亚)':'00385','(塞浦路斯)':'00357','(捷克共和国)':'00420','(丹麦)':'0045','(爱沙尼亚共和国)':'00372','(芬兰)':'00358','(法国)':'0033','(德国)':'0049','(希腊)':'0030','(匈牙利)':'0036','(冰岛)':'00354','(爱尔兰)':'00353','(意大利)':'0039','(拉脱维亚)':'00371','(列支敦士登的)':'00423','(立陶宛共和国)':'00370','(卢森堡公国)':'00352','(马耳他共和国)':'00356','(荷兰)':'0031','(挪威)':'0047','(波兰)':'0048','(葡萄牙)':'00351','(罗马尼亚)':'0040','(斯洛伐克)':'00421','(斯洛文尼亚)':'00386','(西班牙)':'0034','(瑞典)':'0046','(瑞士)':'0041','(英国)':'0044'}

usePriMobilePhone

String

最大长度:10

是否使用企业主账号手机号码作为子账号手机号码:

Y:是;

N:否(默认值)。

注:当为Y时,mobilePhone输入无效。

password

String

最大长度:32

客户登录密码。

注:usePriMobilePhone为Y时才支持。

表2 权限项定义列表

参数

是否必选

READ_FINANCE_INFO

查看子账号财务信息。

READ_CONSUME_BILL

查看子账号消费信息。

SUBSTITUTE-OPEN-INVOICE

管理关联账号发票。

TAKE-OVER-OPEN-INVOICE

禁止关联账号开发票。

SHARE-CREDIT-TO-SUB

子账号共享主账号信用额度。

SHARE-BIZ-DISCOUNT-TO-SUB

子账号继承主账号商务折扣。

请求示例

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

{
    "partyId": "392",
    "displayName": "betaM12345",
    "subCustomerAssociationType": "1",
    "permissionIds": [
        "READ_CONSUME_BILL"
    ],
    "newSubCustomer": {
        "customerName": "betam12345",
        "email": "451231234@163.com",
        "mobilePhone": "18257531543",
        "countryCode": "0086"
    }
}

响应消息

响应参数

参数

是否必选

参数类型

取值范围

描述

error_code

String

20

状态码。具体请参考状态码。只有失败才返回该字段。

error_msg

String

1000

错误描述信息。只有失败才返回该字段。

failCheckItems

List<String>

N/A

不满足的业务规则检查项。

注1:当错误码为CBC.7004时返回。

表3 企业主账号创建企业子账号检查项

检查项ID

检查项名称

MAX_SUB_CUSTOMER_NUM

超过最大子账号数量。

IND_CUST_NOT_CREATE_SUB_CUST

个人客户不允许创建子账号。

响应示例

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

{
  
}

状态码

HTTP状态码

错误码

错误描述

400

CBC.0100

输入参数校验失败。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

500

CBC.7004

发起的业务操作存在不满足的业务检查项。

500

CBC.7228

客户密码格式不合法。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区