Users
Version 5.6.0 introduces the ability to interact with user accounts from the cli.
user list
List Users.
user list [OPTIONS]
Options
- --columns <columns>
Columns to display. [options: id, username, email, displayName, status, hardwareCount, virtualGuestCount, 2FA, classicAPIKey, vpn]
- Default:
'id,username,email,displayName,2FA,classicAPIKey,vpn'
user detail
User details.
user detail [OPTIONS] IDENTIFIER
Options
- -k, --keys
Show the users API key.
- -p, --permissions
Display permissions assigned to this user. Master users will show no permissions
- -h, --hardware
Display hardware this user has access to.
- -v, --virtual
Display virtual guests this user has access to.
- -l, --logins
Show login history of this user for the last 30 days
- -e, --events
Show event log for this user.
Arguments
- IDENTIFIER
Required argument
user notifications
My Notifications.
user notifications [OPTIONS]
user permissions
User Permissions.
Some permissions here may also be managed by IBM IAM service. See https://cloud.ibm.com/docs/account?topic=account-migrated_permissions for more details.
user permissions [OPTIONS] IDENTIFIER
Arguments
- IDENTIFIER
Required argument
user edit-notifications
Enable or Disable specific notifications for the active user.
Notification names should be enclosed in quotation marks. Example:
slcli user edit-notifications --enable 'Order Approved' 'Reload Complete'
user edit-notifications [OPTIONS] NOTIFICATION...
Options
- --enable, --disable
Enable (DEFAULT) or Disable selected notification
Arguments
- NOTIFICATION
Required argument(s)
user edit-permissions
Enable or Disable specific permissions.
user edit-permissions [OPTIONS] IDENTIFIER
Options
- --enable, --disable
Enable (DEFAULT) or Disable selected permissions
- -p, --permission <permission>
Permission keyName to set, multiple instances allowed. Use keyword ALL to select ALL permisssions
- -u, --from-user <from_user>
Set permissions to match this user’s permissions. Will add then remove the appropriate permissions
Arguments
- IDENTIFIER
Required argument
user edit-details
Edit a Users details
JSON strings should be enclosed in ‘’ and each item should be enclosed in “”
Example:
slcli user edit-details testUser -t '{"firstName": "Test", "lastName": "Testerson"}'
user edit-details [OPTIONS] USER
Options
- -t, --template <template>
Required A json string describing https://softlayer.github.io/reference/datatypes/SoftLayer_User_Customer/
Arguments
- USER
Required argument
user create
Creates a user Users.
Remember to set the permissions and access for this new user.
Example:
slcli user create my@email.com -e my@email.com -p generate -a
-t '{"firstName": "Test", "lastName": "Testerson"}'
user create [OPTIONS] USERNAME
Options
- -e, --email <email>
Required Email address for this user. Required for creation.
- -p, --password <password>
Password to set for this user. If no password is provided, user will be sent an email to generate one, which expires in 24 hours. ‘-p generate’ will create a password for you (Requires Python 3.6+). Passwords require 8+ characters, upper and lowercase, a number and a symbol.
- -u, --from-user <from_user>
Base user to use as a template for creating this user. Will default to the user running this command. Information provided in –template supersedes this template.
- -t, --template <template>
A json string describing https://softlayer.github.io/reference/datatypes/SoftLayer_User_Customer/
Arguments
- USERNAME
Required argument
user delete
Sets a user’s status to CANCEL_PENDING, which will immediately disable the account,
and will eventually be fully removed from the account by an automated internal process.
Example: slcli user delete userId
user delete [OPTIONS] IDENTIFIER
Arguments
- IDENTIFIER
Required argument
user device-access
User Device access.
user device-access [OPTIONS] IDENTIFIER
Arguments
- IDENTIFIER
Required argument
user vpn-manual
Enable or disable user vpn subnets manual config
user vpn-manual [OPTIONS] USER
Options
- --enable, --disable
Enable or disable vpn subnets manual config.
Arguments
- USER
Required argument
user vpn-subnet
Add or remove subnets access for a user.
user vpn-subnet [OPTIONS] USER SUBNET...
Options
- --add, --remove
Add or remove access to subnets.
Arguments
- USER
Required argument
- SUBNET
Required argument(s)
user remove-access
Removes a user access to a given device.
Example: slcli user remove-access 123456 –hardware 123456789
user remove-access [OPTIONS] IDENTIFIER
Options
- --hardware <hardware>
Hardware ID
- --virtual <virtual>
Virtual Guest ID
- --dedicated <dedicated>
Dedicated host ID
Arguments
- IDENTIFIER
Required argument
user grant-access
Grants a user access to a given device.
Example: slcli user grant-access 123456 –hardware 123456789
user grant-access [OPTIONS] IDENTIFIER
Options
- --hardware <hardware>
Hardware ID
- --virtual <virtual>
Virtual Guest ID
- --dedicated <dedicated>
dedicated host ID
Arguments
- IDENTIFIER
Required argument
user vpn-password
Set the user VPN password.
Example: slcli user vpn-password 123456 –password=Mypassword1.
user vpn-password [OPTIONS] IDENTIFIER
Options
- --password <password>
Required Your new VPN password
Arguments
- IDENTIFIER
Required argument
user vpn-enable
Enable vpn for a user.
- Example::
slcli user vpn-enable 1234567
user vpn-enable [OPTIONS] USER
Arguments
- USER
Required argument
user vpn-disable
Disable vpn for a user.
- Example::
slcli user vpn-disable 1234567
user vpn-disable [OPTIONS] USER
Arguments
- USER
Required argument
user apikey
Allows to create, remove or refresh user’s API authentication key.
Each user can only have a single API key.
user apikey [OPTIONS] IDENTIFIER
Options
- --add
Create an user’s API authentication key.
- --remove
Remove an user’s API authentication key.
- --refresh
Refresh an user’s API authentication key.
Arguments
- IDENTIFIER
Required argument