AWS OpsWorks
API Reference (API Version 2013-02-18)


Creates a new user profile.

Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

Request Syntax

{ "AllowSelfManagement": boolean, "IamUserArn": "string", "SshPublicKey": "string", "SshUsername": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


Whether users can specify their own SSH public key through the My Settings page. For more information, see Setting an IAM User's Public SSH Key.

Type: Boolean

Required: No


The user's IAM ARN; this can also be a federated user's ARN.

Type: String

Required: Yes


The user's public SSH key.

Type: String

Required: No


The user's SSH user name. The allowable characters are [a-z], [A-Z], [0-9], '-', and '_'. If the specified name includes other punctuation marks, AWS OpsWorks Stacks removes them. For example, will be changed to myname. If you do not specify an SSH user name, AWS OpsWorks Stacks generates one from the IAM user name.

Type: String

Required: No

Response Syntax

{ "IamUserArn": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


The user's IAM ARN.

Type: String


For information about the errors that are common to all actions, see Common Errors.


Indicates that a request was not valid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: