Authorization Commands

The ml auth command group provides facilities for authorization.

The following commands can be used together with ml auth:

• init
• resource
• whoami

init

Authenticates the CLI.

When you run the command, a browser opens for you to log in. After a successful login, you will see a message confirming success. For example, "User authenticated. Close this tab and go back to the console."

Flags

The following flags are available with the ml auth init command:

• --webserver/--disable-webserver

  Enables or disables a Web server. A Web server runs by default.

  When running ml auth init on machines without browsers, it is recommended to use the --disable-webserver flag. Instead of opening a browser, you will be given a URL and be prompted to enter a token. Using the URL on a different machine with a browser will provide the token that you need to enter.

resource

The following flags are available with the ml auth resource command:

• --org TEXT

  Organization to use.

whoami

Displays the Id, email address, and user name of the current user.

Example

In this example, the ml auth whoami command is used with the global -o option to print the output as a JSON structure:

ml -o json auth whoami

The output looks something like this:

{"user_id": "bd748656-6815-4ae5-bcf4-3b09c911f43f", "name": "Joe Smith", "email": "[email protected]"}