调用CreateUser创建RAM用户_访问控制-阿里云帮助中心

本文将提供一个示例，创建一个名为test的RAM用户。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateUser	要执行的操作。取值：CreateUser。
UserPrincipalName	String	是	test@example.onaliyun.com	RAM用户的登录名称。格式为`<username>@<AccountAlias>.onaliyun.com`，其中`<username>`为RAM用户名称，`<AccountAlias>.onaliyun.com`为默认域名。关于如何获取默认域名，请参见GetDefaultDomain。 `UserPrincipalName`总长度为1~128个字符，可包含英文字母、数字、半角句号（.）、短划线（-）和下划线（_）。其中`<username>`的长度为1~64个字符。
DisplayName	String	是	test	RAM用户的显示名称。长度为1~24个字符。
MobilePhone	String	否	86-1868888****	RAM用户的手机号码。格式：国际区号-号码。说明该参数仅适用于中国站。
Email	String	否	alice@example.com	RAM用户的电子邮箱。说明该参数仅适用于中国站。
Comments	String	否	This is a cloud computing engineer.	备注。长度为1~128个字符。
Tag.N.Key	String	否	operator	标签键。 N的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持128个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。
Tag.N.Value	String	否	alice	标签值。 N的取值范围：1~20。可以为空字符串。最多支持128个字符，不能以`acs:`开头，不能包含`http://`或者`https://`。

关于公共请求参数的详情，请参见公共参数。

返回数据


名称	类型	示例值	描述
User	Object		RAM用户信息。
DisplayName	String	test	RAM用户的显示名称。
UserPrincipalName	String	test@example.onaliyun.com	RAM用户的登录名称。
Email	String	alice@example.com	RAM用户的电子邮箱。说明该参数仅适用于中国站。
UpdateDate	String	2020-10-12T09:12:00Z	RAM用户的更新时间。
MobilePhone	String	86-1868888****	RAM用户的手机号码。说明该参数仅适用于中国站。
UserId	String	20732900249392****	RAM用户ID。
Comments	String	This is a cloud computing engineer.	备注。
LastLoginDate	String	2020-10-12T09:12:00Z	RAM用户最近一次登录控制台的时间。
CreateDate	String	2020-10-12T09:12:00Z	RAM用户的创建时间。
ProvisionType	String	Manual	同步类型。可能的取值： Manual：在RAM中手动创建的RAM用户。 SCIM：通过SCIM协议同步创建的RAM用户。 CloudSSO：通过云SSO同步创建的用户。
Tags	Array of Tag		标签列表。
Tag
TagKey	String	operator	标签键。
TagValue	String	alice	标签值。
RequestId	String	2BB8C44A-2862-4922-AD43-03924749173B	请求ID。

示例

请求示例

https://[Endpoint]/?Action=CreateUser
&UserPrincipalName=test@example.onaliyun.com
&DisplayName=test
&MobilePhone=86-1868888****
&Email=alice@example.com
&Comments=This is a cloud computing engineer.
&Tag.1.Key=operator
&Tag.1.Value=alice
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateUserResponse>
    <User>
        <DisplayName>test</DisplayName>
        <UserPrincipalName>test@example.onaliyun.com</UserPrincipalName>
        <Email>alice@example.com</Email>
        <UpdateDate>2020-10-12T09:12:00Z</UpdateDate>
        <MobilePhone>86-1868888****</MobilePhone>
        <UserId>20732900249392****</UserId>
        <Comments>This is a cloud computing engineer.</Comments>
        <LastLoginDate>2020-10-12T09:12:00Z</LastLoginDate>
        <CreateDate>2020-10-12T09:12:00Z</CreateDate>
        <ProvisionType>Manual</ProvisionType>
        <Tags>
            <TagKey>operator</TagKey>
            <TagValue>alice</TagValue>
        </Tags>
    </User>
    <RequestId>2BB8C44A-2862-4922-AD43-03924749173B</RequestId>
</CreateUserResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "User" : {
    "DisplayName" : "test",
    "UserPrincipalName" : "test@example.onaliyun.com",
    "Email" : "alice@example.com",
    "UpdateDate" : "2020-10-12T09:12:00Z",
    "MobilePhone" : "86-1868888****",
    "UserId" : "20732900249392****",
    "Comments" : "This is a cloud computing engineer.",
    "LastLoginDate" : "2020-10-12T09:12:00Z",
    "CreateDate" : "2020-10-12T09:12:00Z",
    "ProvisionType" : "Manual",
    "Tags" : [ {
      "TagKey" : "operator",
      "TagValue" : "alice"
    } ]
  },
  "RequestId" : "2BB8C44A-2862-4922-AD43-03924749173B"
}

错误码

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