Creating a User

You can create users in your account to manage which actions they can perform.

You then need to grant permissions and create access keys for new users, so that they can authenticate to OUTSCALE services and perform the actions they are allowed to. For more information, see Managing Policies to Access Your Resources and Creating an EIM Access Key.

To add a user to a group, see Adding or Removing a User from a Group.

Creating a User Using Cockpit v2

Creating a User as a Root User Using Cockpit v2

  1. In the EIM Users dashboard, click IconAddFull Create EIM User.
    The CREATE EIM USER dialog box appears.

  2. In the Name field, type the name you want to give the user.

    This name must be unique and must contain between 1 and 64 characters. Allowed characters are a-z, A-Z, 0-9, and +=,.@-_.

  3. (optional) In the Email field, type the email of the user.

  4. (optional) In the Path field, type a path to indicate where the user is within your organization.

    This name must begin and end with a slash (/), and contain between 1 and 512 alphanumeric characters and/or slashes (/), or underscores (_).

  5. Click Create.
    The user is created.

Creating a User as an EIM User Using Cockpit v2

  1. In the EIM Users dashboard, click IconAddFull Create EIM User.
    The CREATE EIM USER dialog box appears.

  2. In the Name field, type the name you want to give the user.

    This name must be unique and must contain between 1 and 64 characters. Allowed characters are a-z, A-Z, 0-9, and +=,.@-_.

  3. (optional) In the Path field, type a path to indicate where the user is within your organization.

    This name must begin and end with a slash (/), and contain between 1 and 512 alphanumeric characters and/or slashes (/), or underscores (_).

  4. Click Create.
    The user is created.

Creating a User Using OSC CLI

The CreateUser command creates an EIM user for your account.

For more information, see About EIM Users.

Request sample
$ osc-cli api CreateUser --profile "default" \
    --UserEmail "user@example.com" \
    --UserName "example-user" \
    --Path "/documentation/"

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Path: (optional) The path to the EIM user you want to create (by default, /). This path name must begin and end with a slash (/), and contain between 1 and 512 alphanumeric characters and/or slashes (/), or underscores (_).

  • UserEmail: (optional) The email address of the EIM user.

  • UserName: The name of the EIM user. This user name must contain between 1 and 64 alphanumeric characters and/or pluses (+), equals (=), commas (,), periods (.), at signs (@), dashes (-), or underscores (_).

The CreateUser command returns the following elements:

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

  • User: Information about the EIM user.

    • CreationDate: The date and time (UTC) of creation of the EIM user.

    • LastModificationDate: The date and time (UTC) of the last modification of the EIM user.

    • Path: The path to the EIM user.

    • UserEmail: The email address of the EIM user.

    • UserId: The ID of the EIM user.

    • UserName: The name of the EIM user.

Result sample
{
  "User": {
    "CreationDate": "2010-10-01T12:34:56.789+0000",
    "LastModificationDate": "2017-05-10T12:34:56.789+0000",
    "UserEmail": "user@example.com",
    "UserName": "example-user",
    "UserId": "ABCDEFGHIJKLMNOPQRSTUVWXYZ12345",
    "Path": "/documentation/"
  },
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Creating a User Using oapi-cli

The CreateUser command creates an EIM user for your account.

For more information, see About EIM Users.

Request sample
$ oapi-cli --profile "default" CreateUser \
    --UserEmail "user@example.com" \
    --UserName "example-user" \
    --Path "/documentation/"

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Path: (optional) The path to the EIM user you want to create (by default, /). This path name must begin and end with a slash (/), and contain between 1 and 512 alphanumeric characters and/or slashes (/), or underscores (_).

  • UserEmail: (optional) The email address of the EIM user.

  • UserName: The name of the EIM user. This user name must contain between 1 and 64 alphanumeric characters and/or pluses (+), equals (=), commas (,), periods (.), at signs (@), dashes (-), or underscores (_).

The CreateUser command returns the following elements:

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

  • User: Information about the EIM user.

    • CreationDate: The date and time (UTC) of creation of the EIM user.

    • LastModificationDate: The date and time (UTC) of the last modification of the EIM user.

    • Path: The path to the EIM user.

    • UserEmail: The email address of the EIM user.

    • UserId: The ID of the EIM user.

    • UserName: The name of the EIM user.

Result sample
{
  "User": {
    "CreationDate": "2010-10-01T12:34:56.789+0000",
    "LastModificationDate": "2017-05-10T12:34:56.789+0000",
    "UserEmail": "user@example.com",
    "UserName": "example-user",
    "UserId": "ABCDEFGHIJKLMNOPQRSTUVWXYZ12345",
    "Path": "/documentation/"
  },
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Creating a User Using AWS CLI

Before you begin: Install and configure AWS CLI. For more information, see Installing and Configuring AWS CLI.

To create a user, use the create-user command following this syntax:

Request sample
$ aws iam create-user \
    --profile YOUR_PROFILE \
    --user-name USER_NAME \
    --path /PATH/SUB_PATH/ \
    --endpoint https://eim.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • user-name: The name you want to give to the user.

    This name must be unique and must contain between 1 and 64 characters. Allowed characters are a-z, A-Z, 0-9, and +=,.@-_.

  • (optional) path: The path for the user name. If you do not specify a path, it is by default set to a slash (/). For more information, see Resource Identifiers.

  • endpoint: The endpoint corresponding to the Region you want to send the request to. For more information, see Installing and Configuring AWS CLI.

The create-user command returns the following elements:

  • user: Information about the newly created user. This element contains the following information:

    • UserName: The name of the user.

    • Path: The path for the user name.

    • CreateDate: The date and time of creation of the user.

    • UserId: The user ID.

    • Arn: The OUTSCALE Resource Name (ORN) of the user. For more information, see Resource Identifiers.

Result sample
{
    "User": {
        "UserName": "USER_NAME",
        "Path": "/PATH/SUB_PATH/",
        "CreateDate": "2016-05-12T12:12:24.165Z",
        "UserId": "123456789000",
        "Arn": "arn:aws:iam::123456789000:user/USER_NAME"
    }
}

The user is created in your account.

Related Pages

Corresponding API Methods

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.