user

delete

Deletes a given username.

maas $PROFILE user delete [--help] [-d] [-k] username [data ...]

Positional arguments

Argument

Effect

username

The username parameter

Command-line options

Option

Effect

–help, -h

Show this help message and exit.

-d, –debug

Display more information about API responses.

-k, –insecure

Disable SSL certificate check.

Keywords

Keyword “transfer_resources_to”

Optional String. An optional username. If supplied, the allocated resources of the user being deleted will be transferred to this user. A user can’t be removed unless its resources (machines, IP addresses, …), are released or transferred to another user.

Note: This command accepts JSON.

read

Retrieve a user’s details.

maas $PROFILE user read [--help] [-d] [-k] username

Positional arguments

Argument

Effect

username

The username parameter

Command-line options

Option

Effect

–help, -h

Show this help message and exit.

-d, –debug

Display more information about API responses.

-k, –insecure

Disable SSL certificate check.

users create

Creates a MAAS user account. This is not safe: the password is sent in plaintext. Avoid it for production, unless you are confident that you can prevent eavesdroppers from observing the request.

maas $PROFILE users create [--help] [-d] [-k] [data ...]

Command-line options

Option

Effect

–help, -h

Show this help message and exit.

-d, –debug

Display more information about API responses.

-k, –insecure

Disable SSL certificate check.

Keywords

Keyword “username”

Optional String. Identifier-style username for the new user.

Keyword “email”

Optional String. Email address for the new user.

Keyword “password”

Optional String. Password for the new user.

Keyword “is_superuser”

Optional Boolean. Whether the new user is to be an administrator. (‘0’ == False, ‘1’ == True)

Note: This command accepts JSON.

users read

List users

maas $PROFILE users read [--help] [-d] [-k]

Command-line options

Option

Effect

–help, -h

Show this help message and exit.

-d, –debug

Display more information about API responses.

-k, –insecure

Disable SSL certificate check.

users whoami

Returns the currently logged-in user.

maas $PROFILE users whoami [--help] [-d] [-k]

Command-line options

Option

Effect

–help, -h

Show this help message and exit.

-d, –debug

Display more information about API responses.

-k, –insecure

Disable SSL certificate check.