CreateUser - 创建一个EIAM账户

在指定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. 用户名已重复

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

变更历史

更多信息,参考变更详情