Users

The orka user group of commands in the Orka CLI. These commands are used for user management.

Create user

Command

Create a new useruser - To work with Orka, you need to have a user with an assigned license. You will use this user and the respective credentials to authenticate against the Orka service. After being authenticated against the service, you can run Orka CLI commands and Orka API calls. for your Orka environment. This command requires additional administrative authentication with an Orka license key.

orka user create

OR

orka user create -e <EMAIL> --password <PASSWORD> -y

Output

Options

You can pass the following options with orka user create in direct mode:

Option

Description

Sample value

-e

The email address for the new user. This also serves as username.

[email protected]

--password

A password for the new user.

pa$$w0rd

-l

An Orka license key used for authentication against your Orka environment. Set this option, if you want to use a license key different from the one cached locally.

orka-license-key

-y

Bypasses the interactive prompt and executes the command with the specified parameters.

--json

Returns the output of the command in JSON.

List users

Command

List all users in your Orka environment. This command requires additional administrative authentication with an Orka license key.

orka user list

Options

You can pass the following options with orka user list in direct mode:

Option

Description

Sample value

-l

An Orka license key used for authentication against your Orka environment. Set this option, if you want to use a license key different from the one cached locally.

orka-license-key

--json

Returns the output of the command in JSON.

Reset password (Admin-only)

Command

Reset the password for the specified user. This operation is intended for administrators who need to change the password of an existing user.

You must specify the email of the user whose password you want to reset.

This command requires additional administrative authentication with an Orka license key.

orka user reset

OR

orka user reset -e <EMAIL> --password <PASSWORD> -y

Output

Options

You can pass the following options with orka user reset in direct mode:

Option

Description

Sample value

-e

The username (email) for the user whose password you want to reset.

[email protected]

--password

The new password for the specified user.

pa$$w0rd

-l

An Orka license key used for authentication against your Orka environment. Set this option, if you want to use a license key different from the one cached locally.

orka-license-key

-y

Bypasses the interactive prompt and executes the command with the specified parameters.

--json

Returns the output of the command in JSON.

Update user

Command

Update your password or change the email address for your Orka user. This operation is intended for regular Orka users who need to update their information or credentials.

orka user update

OR (change current email)

orka user update -e <EMAIL> -y

OR (change current password)

orka user update --password <PASSWORD> -y

OR (change both)

orka user update -e <EMAIL> --password <PASSWORD> -y

Output

Options

You can pass the following options with orka user update in direct mode:

Option

Description

Sample value

-e

Your username (email).

[email protected]

--password

The new password that you want to use.

pa$$w0rd

-y

Bypasses the interactive prompt and executes the command with the specified parameters.

--json

Returns the output of the command in JSON.

Delete user

Command

Deletes the specified user. The user must have no Orka resources associated with them. This command requires additional administrative authentication with an Orka license key.

orka user delete

OR

orka user delete -e <EMAIL> -y

Output

Options

You can pass the following options with orka user group in direct mode:

Option

Description

Sample value

-e

The username (email) of the user that you want to delete.

[email protected]

-l

An Orka license key used for authentication against your Orka environment. Set this option, if you want to use a license key different from the one cached locally.

orka-license-key

-y

Bypasses the interactive prompt and executes the command with the specified parameters.

--json

Returns the output of the command in JSON.

Manage user grouping

Command

Applies or removes a user group label from the specified user. The user must exist.

orka user group

OR

orka user group -g <GROUP> -e <EMAIL> -y

OR (to remove a user group)

orka user group -g -e <EMAIL> -y

Output

Options

You can pass the following options with orka user group in direct mode:

Option

Shorthand option

Description

Sample value

--email

-e

The username (email) of the user whose user group label you want to modify.

[email protected]

--group

-g

The user group label that you want to apply. The label may or may not already exist.

To remove a group label, leave blank.

mygroup

-y

Bypasses the interactive prompt and executes the command with the specified parameters.

--json

Returns the output of the command in JSON.


Did this page help you?