Managing classic infrastructure users (ibmcloud sl user)
Use the following commands from the IBM Cloud® Command Line Interface to manage IBM Cloud classic infrastructure users.
ibmcloud sl user apikey
Allows to create, remove or refresh user's API authentication key
Each user can only have a single API key.
ibmcloud sl user apikey IDENTIFIER [flags]
Command options:
- --add
- Create an user's API authentication key
- --refresh
- Refresh an user's API authentication key
- --remove
- Remove an user's API authentication key
ibmcloud sl user create
Creates a user
ibmcloud sl user create USERNAME [OPTIONS]
Examples:
ibmcloud sl user create my@email.com --email my@email.com --password generate --template '{"firstName": "Test", "lastName": "Testerson"}'
Remember to set the permissions and access for this new user.
ibmcloud sl user create USERNAME [flags]
Command options:
- Email address for this user. Required for creation
- --f, force
- Force operation without confirmation
- --from-user
- Base user to use as a template for creating this user. The default is to use the user that is running this command. Information provided in --template supersedes this template
- --password
- Password to set for this user. If no password is provided, the user is sent an email to generate one, which expires in 24 hours. Specify the '-p generate' option to generate a password for you. Passwords require 8+ characters, uppercase and lowercase, a number and a symbol
- --template
- A json string describing https://softlayer.github.io/reference/datatypes/SoftLayer_User_Customer/
- --vpn-password
- VPN password to set for this user.
ibmcloud sl 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
ibmcloud sl user delete USER_ID [flags]
Command options:
- --f, force
- Force operation without confirmation
ibmcloud sl user detail
User details
ibmcloud sl user detail USER_ID [flags]
Command options:
- --events
- Show audit log for this user
- --hardware
- Display hardware this user has access to
- --keys
- Show the users API key
- --logins
- Show login history of this user for the last 24 hours
- --permissions
- Display permissions assigned to this user. Master users do not show permissions
- --virtual
- Display virtual guests this user has access to
ibmcloud sl user detail-edit
Edit a user's details
ibmcloud sl user detail-edit IDENTIFIER [OPTIONS]
Examples:
ibmcloud sl user detail-edit USER_ID --template '{"firstName": "Test", "lastName": "Testerson"}'
This command edit a users details.
ibmcloud sl user detail-edit USER_ID [flags]
Command options:
- --template
- A json string describing https://softlayer.github.io/reference/datatypes/SoftLayer_User_Customer/
ibmcloud sl user device-access
List all devices the user has access and device access permissions.
ibmcloud sl user device-access IDENTIFIER
ibmcloud sl user edit-notifications
Enable or Disable specific notifications for the active user.
Notification names should be enclosed in quotation marks. Examples:
slcli user edit-notifications --enable 'Order Approved'
slcli user edit-notifications --enable 'Order Approved' --enable 'Reload Complete'
ibmcloud sl user edit-notifications [flags]
Command options:
- --disable
- Disable selected notifications
- --enable
- Enable (DEFAULT) selected notifications
ibmcloud sl user grant-access
Grant access from a user to an specific device
ibmcloud sl user grant-access IDENTIFIER [flags]
Command options:
- --dedicated
- Dedicated Host ID
- --hardware
- Hardware ID
- --virtual
- Virtual Guest ID
ibmcloud sl user list
List Users
ibmcloud sl user list [flags]
Command options:
- --column
- Column to display. options are: 2FA, classicAPIKey, displayName, email, hardwareCount, id, status, username, virtualGuestCount, vpn. This option can be specified multiple times
ibmcloud sl user notifications
List email subscription notifications
ibmcloud sl user notifications
ibmcloud sl user permission-edit
Enable or Disable specific permissions
ibmcloud sl user permission-edit IDENTIFIER [flags]
Command options:
- --enable
- Enable or Disable selected permissions. Accepted inputs are 'true' and 'false'. default is 'true'
- --from-user
- Set permissions to match this user's permissions. Adds and removes the appropriate permissions
- --permission
- Permission keyName to set. Use keyword ALL to select ALL permissions
ibmcloud sl user permissions
View user permissions
Some permissions here may also be managed by the IBM IAM service. See https://cloud.ibm.com/docs/account?topic=account-migrated_permissions for more details.
ibmcloud sl user permissions USER_ID
ibmcloud sl user remove-access
Remove access from a user to an specific device
ibmcloud sl user remove-access IDENTIFIER [flags]
Command options:
- --dedicated
- Dedicated Host ID
- --hardware
- Hardware ID
- --virtual
- Virtual Guest ID
ibmcloud sl user vpn-disable
Disable vpn for a user.
ibmcloud sl user vpn-disable USER_ID
ibmcloud sl user vpn-enable
Enable vpn for a user.
ibmcloud sl user vpn-enable USER_ID
ibmcloud sl user vpn-manual
Enable or disable user vpn subnets manual config.
ibmcloud sl user vpn-manual USER_ID [flags]
Command options:
- --disable
- Disable vpn subnets manual config.
- --enable
- Enable vpn subnets manual config.
ibmcloud sl user vpn-password
Set the user VPN password.
ibmcloud sl user vpn-password IDENTIFIER [flags]
Command options:
- --password
- Your new VPN password [required]
ibmcloud sl user vpn-subnet
Add or remove subnet access for a user.
ibmcloud sl user vpn-subnet USER_ID SUBNET_ID [flags]
Command options:
- --add
- Add access to subnet.
- --remove
- Remove access to subnet.