juju permission levels should be documented in 'juju help grant'

Bug #1663033 reported by David Britton
This bug affects 2 people
Affects Status Importance Assigned to Milestone
Canonical Juju
Won't Fix

Bug Description

What I exepect at a minimum:

short description (one line) of what 'read, write, admin, login, add-model, superuser' grant me.

What would be nice:

longer description maybe under `juju help permissions` or something like that. Or even a pointer to online docs?

Current Display: (juju 2.1b5)

dpb@helo:charms[0]$ juju help grant
Usage: juju grant [options] <user name> <permission> [<model name> ...]

Grants access level to a Juju user for a model or controller.

-B, --no-browser-login (= false)
    Do not use web browser for authentication
-c, --controller (= "")
    Controller to operate in

By default, the controller is the current controller.

Users with read access are limited in what they can do with models:
`juju models`, `juju machines`, and `juju status`.

Valid access levels for models are:

Valid access levels for controllers are:

Grant user 'joe' 'read' access to model 'mymodel':

    juju grant joe read mymodel

Grant user 'jim' 'write' access to model 'mymodel':

    juju grant jim write mymodel

Grant user 'sam' 'read' access to models 'model1' and 'model2':

    juju grant sam read model1 model2

Grant user 'maria' 'add-model' access to the controller:

    juju grant maria add-model

See also:

tags: added: helpdocs usability
Changed in juju:
status: New → Triaged
importance: Undecided → Medium
milestone: none → 2.1.0
Changed in juju:
milestone: 2.1.0 → none
tags: added: helptext
removed: helpdocs
Revision history for this message
Paul Collins (pjdc) wrote :

The help text now (as of 2.9.4) includes examples, but the `add-model` controller permission is still not mentioned:

Valid access levels for controllers are:

Revision history for this message
Canonical Juju QA Bot (juju-qa-bot) wrote :

This Medium-priority bug has not been updated in 60 days, so we're marking it Low importance. If you believe this is incorrect, please update the importance.

Changed in juju:
importance: Medium → Low
tags: added: expirebugs-bot
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.