全部产品
Search

搜索本产品

    应用身份服务：CreateUser - 创建一个EIAM账户

    文档中心

    应用身份服务：CreateUser - 创建一个EIAM账户

    更新时间：Dec 12, 2025

    在指定EIAM实例下创建一个EIAM账户

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    eiam:CreateUser

    create

    *User

    acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/user/*

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    InstanceId

    string

    是

    实例 ID。

    idaas_ue2jvisn35ea5lmthk267xxxxx
    Username

    string

    是

    账户名称，可包含英文字母、数字、符号“_” 、“ .”、“@”、“-”，长度最大限制 64 字符。

    user_001
    DisplayName

    string

    否

    账户展示名称，长度最大限制 64 字符。

    name_001
    Password

    string

    否

    密码，具体格式要求参考密码策略。

    123456
    PhoneRegion

    string

    否

    手机区号，格式为 1～6 位数字，不含"+"。

    86
    PhoneNumber

    string

    否

    手机号，格式为 6～15 位数字。

    12345678901
    PhoneNumberVerified

    boolean

    否

    手机号是否验证，为可信手机号，手机号若设置此字段必须设置，无特殊业务可直接设置为 true。

    true
    Email

    string

    否

    邮箱，邮箱前缀可包含大写英文字母、小写英文字母、数字、点、下划线或中划线，长度限制最长为 64 字符。

    example@example.com
    EmailVerified

    boolean

    否

    邮箱是否已验证，为可信邮箱，邮箱若设置此字段必须设置，无特殊业务可直接设置为 true。

    true
    UserExternalId

    string

    否

    账户外部 ID，用于与外部系统的关联，最大长度限制 64 字符，若不设置，默认设置为账户 ID。

    user_d6sbsuumeta4h66ec3il7yxxxx
    PrimaryOrganizationalUnitId

    string

    是

    主组织 ID。

    ou_wovwffm62xifdziem7an7xxxxx
    OrganizationalUnitIds

    array

    否

    从属组织 ID 列表，账户可从属于多个组织。

    string

    否

    组织 ID。

    ou_adz2vmgiwpo4tu6jtss3mynjji
    Description

    string

    否

    描述，最大长度限制 256 字符。

    description text
    CustomFields

    array<object>

    否

    扩展字段列表。

    description

    object

    否

    扩展字段对象。

    FieldName

    string

    否

    扩展字段标识，需提前创建相关扩展字段，参考控制台扩展字段模块。

    age
    FieldValue

    string

    否

    扩展字段值，该值遵循对应扩展字段的相关属性限制。

    10
    PasswordInitializationConfig

    object

    否

    密码初始化配置。

    PasswordInitializationPolicyPriority

    string

    否

    密码初始化策略优先级，默认不生效，取值可选范围：

    • global：全局优先，采用实例级别的密码初始化策略，即本次设置的密码初始化策略均无效，参考密码相关策略的密码初始化策略。

    • custom：自定义优先，以当前定义的密码初始化策略为准，包括是否开启强制改密、密码初始化方式以及通知渠道。

    global
    PasswordForcedUpdateStatus

    string

    否

    强制修改密码状态，默认不启用，取值可选范围：

    • enabled：开启。

    • disabled：禁用。

    enabled
    UserNotificationChannels

    array

    否

    密码通知渠道列表。

    sms

    string

    否

    密码通知渠道，取值可选范围：

    • email：邮件。

    • sms：短信。

    sms
    PasswordInitializationType

    string

    否

    密码初始化方式，取值可选范围：

    • random：随机。

    random
    ClientToken

    string

    否

    保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参考文档《如何保证幂等性》。

    client-token-example

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    0441BD79-92F3-53AA-8657-F8CE4A2B912A
    UserId

    string

    账户 ID。

    user_d6sbsuumeta4h66ec3il7yxxxx

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "UserId": "user_d6sbsuumeta4h66ec3il7yxxxx"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    403 ResourceDuplicated.Username The specified resource: Username already exist. 用户名已重复

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。