CreateUser - API Reference| Alibaba Cloud Documentation Center

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer automatically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	CreateUser	The operation that you want to perform. Set the value to CreateUser.
UserName	String	Yes	zhangq****	The name of the RAM user. The name must be 1 to 64 characters in length, and can contain letters, digits, periods (.), hyphens (-), and underscores (_).
DisplayName	String	No	zhangq****	The display name of the RAM user. The name must be 1 to 128 characters in length, and can contain letters, digits, periods (.), at signs (@), hyphens (-), and spaces.
MobilePhone	String	No	86-1868888****	The mobile phone number of the RAM user. Format: <International area code>-<Mobile phone number>
Email	String	No	zhangq****@example.com	The email address of the RAM user.
Comments	String	No	This is a cloud computing engineer.	The description of the RAM user. The description must be 1 to 128 characters in length.

Response parameters


Parameter	Type	Example	Description
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE73368	The ID of the request.
User	Struct		The information about the RAM user.
Comments	String	This is a cloud computing engineer.	The description of the RAM user.
CreateDate	String	2015-01-23T12:33:18Z	The time when the RAM user was created.
DisplayName	String	zhangq****	The display name of the RAM user.
Email	String	zhangq****@example.com	The email address of the RAM user.
MobilePhone	String	86-1868888****	The mobile phone number of the RAM user.
UserId	String	122748924538****	The unique ID of the RAM user.
UserName	String	zhangq****	The name of the RAM user.

Examples

Sample requests

https://ram.aliyuncs.com/?Action=CreateUser
&UserName=zhangq****
&DisplayName=zhangq****
&MobilePhone=86-1868888****
&Email=zhangq****@example.com
&Comments=This is a cloud computing engineer.
&<Common request parameters>

Sample success responses

XML format

<CreateUserResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <User>
            <UserId>122748924538****</UserId>
            <UserName>zhangq****</UserName>
            <DisplayName>zhangq****</DisplayName>
            <MobilePhone>86-1868888****</MobilePhone>
            <Email>zhangq****@example.com</Email>
            <Comments>This is a cloud computing engineer. </Comments>
            <CreateDate>2015-01-23T12:33:18Z</CreateDate>
      </User>
</CreateUserResponse>

JSON format

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "User": {
        "UserId": "122748924538****",
        "UserName": "zhangq****",
        "DisplayName": "zhangq****",
        "MobilePhone": "86-1868888****",
        "Email": "zhangq****@example.com",
        "Comments": "This is a cloud computing engineer.",
        "CreateDate": "2015-01-23T12:33:18Z"
    }
}

Error codes

For a list of error codes, visit the API Error Center.

After a RAM user is created, you can perform the following operations:

You can call the CreateLoginProfile operation to allow the RAM user to log on to the Alibaba Cloud Management Console. Then, you can configure settings for the RAM user such as logon passwords. For more information, see CreateLoginProfile.
You can call the CreateAccessKey operation to create an AccessKey pair for the RAM user. For more information, see CreateAccessKey.