新建用户 · 金山云

新建用户（CreateUser）

描述

新建IAM用户

请求参数

名称	类型	必须	长度限制(字符)	参数格式	描述
Action	String	是	确定值	`[a-zA-Z]+`	操作接口名，系统规定参数，取值：CreateUser
Path	String	否	最短1,最长512	`/`	可选参数，用户名的路径，当前只能传入`/`
UserName	String	是	最短1,最长64	`[\w+=,.@-]+`	待创建的IAM用户的用户名
RealName	String	否	最短2,最长128	`[\u4e00-\u9fff]+`	待创建的IAM用户的真实姓名

返回元素（调用成功）

名称	类型	描述
User	UserType	新创建的用户的基本信息

错误码（调用不成功）

错误代码(Code)	错误消息(Message)	HTTP 状态码	中文描述（语义）
InvalidParameterValue	An value must be supplied for the input parameter %s.	400	输入参数%s的值不能为空，具体参数名在%s说明
InvalidParameterValue	An invalid or out-of-range value was supplied for the input parameter %s.	400	输入参数 %s的值无效、不合法或者超出范围，具体参数名在%s说明
UserAlreadyExists	User with name %s already exists.	409	用户名 %s的用户已经存在,具体用户名在%s说明
LimitExceeded	The request was rejected because it attempted to create resources beyond the current KSC account limits.	409	请求被拒绝，因其创建的资源对象数量超过当前账户限制(User数量限制是100)

示例（调用成功）

请求示例

https://iam.api.ksyun.com/?Action=CreateUser&Path=/&UserName=Bob&公共请求参数

返回示例

XML格式

<CreateUserResponse>
    <CreateUserResult>
        <User>
            <Path>/</Path>
            <UserName>Bob</UserName>
            <RealName/>
            <UserId>29UAJdL1Tv6YPMxKS7y0qg</UserId>
            <Krn>krn:ksc:iam::73407420:user/Bob</Krn>
            <CreateDate>2016-05-16T13:32:52.939Z</CreateDate>
            <PasswordLastUsed/>
        </User>
    </CreateUserResult>
    <ResponseMetadata>
        <RequestId>dcf456de-f879-4783-adcc-2799ae966e72</RequestId>
    </ResponseMetadata>
</CreateUserResponse>

JSON示例

{
    "CreateUserResult": {
       "User": {
           "Path": "/",
           "UserName": "Bob",
           "UserId": "29UAJdL1Tv6YPMxKS7y0qg",
           "Krn": "krn:ksc:iam::73407420:user/Bob",
           "CreateDate": "2016-05-16T13:32:52.939Z"
       }
   },
   "ResponseMetadata": {
       "RequestId": "dcf456de-f879-4783-adcc-2799ae966e72"
   }
}