Creates a new IAM user for your AWS account.
For information about limitations on the number of IAM users you can create, see Limitations on IAM Entities in the IAM User Guide.
For information about the parameters that are common to all actions, see Common Parameters.
The path for the user name. For more information about paths, see IAM Identifiers in the IAM User Guide.
This parameter is optional. If it is not included, it defaults to a slash (/).
This paramater allows (per its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes, containing any ASCII character from the ! (\u0021) thru the DEL character (\u007F), including most punctuation characters, digits, and upper and lowercased letters.
Length Constraints: Minimum length of 1. Maximum length of 512.
The name of the user to create.
This parameter allows (per its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-. User names are not distinguished by case. For example, you cannot create users named both "TESTUSER" and "testuser".
Length Constraints: Minimum length of 1. Maximum length of 64.
The following element is returned by the service.
A structure with details about the new IAM user.
Type: User object
For information about the errors that are common to all actions, see Common Errors.
The request was rejected because it attempted to create a resource that already exists.
HTTP Status Code: 409
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error message describes the limit exceeded.
HTTP Status Code: 409
The request was rejected because it referenced an entity that does not exist. The error message describes the entity.
HTTP Status Code: 404
The request processing has failed because of an unknown error, exception or failure.
HTTP Status Code: 500
https://iam.amazonaws.com/?Action=CreateUser &Path=/division_abc/subdivision_xyz/ &UserName=Bob &Version=2010-05-08 &AUTHPARAMS
<CreateUserResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/"> <CreateUserResult> <User> <Path>/division_abc/subdivision_xyz/</Path> <UserName>Bob</UserName> <UserId>AIDACKCEVSQ6C2EXAMPLE</UserId> <Arn>arn:aws:iam::123456789012:user/division_abc/subdivision_xyz/Bob</Arn> </User> </CreateUserResult> <ResponseMetadata> <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId> </ResponseMetadata> </CreateUserResponse>
For more information about using this API in one of the language-specific AWS SDKs, see the following: