Chapter 37. group

37.1. group add user

Add user to group

Usage:

openstack group add user [-h] [--group-domain <group-domain>]
                                [--user-domain <user-domain>]
                                <group> <user> [<user> ...]

Table 37.1. Positional arguments
Value	Summary
<group>	Group to contain <user> (name or id)
<user>	User(s) to add to <group> (name or id) (repeat option to add multiple users)

Table 37.2. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--group-domain <group-domain>	Domain the group belongs to (name or id). this can be used in case collisions between group names exist.
--user-domain <user-domain>	Domain the user belongs to (name or id). this can be used in case collisions between user names exist.

37.2. group contains user

Check user membership in group

Usage:

openstack group contains user [-h] [--group-domain <group-domain>]
                                     [--user-domain <user-domain>]
                                     <group> <user>

Table 37.3. Positional arguments
Value	Summary
<group>	Group to check (name or id)
<user>	User to check (name or id)

Table 37.4. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--group-domain <group-domain>	Domain the group belongs to (name or id). this can be used in case collisions between group names exist.
--user-domain <user-domain>	Domain the user belongs to (name or id). this can be used in case collisions between user names exist.

37.3. group create

Create new group

Usage:

openstack group create [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--noindent] [--prefix PREFIX]
                              [--max-width <integer>] [--fit-width]
                              [--print-empty] [--domain <domain>]
                              [--description <description>] [--or-show]
                              <group-name>

Table 37.5. Positional arguments
Value	Summary
<group-name>	New group name

Table 37.6. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--domain <domain>	Domain to contain new group (name or id)
--description <description>	New group description
--or-show	Return existing group

Table 37.7. Output formatter options
Value	Summary
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns

Table 37.8. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 37.9. Shell formatter options
Value	Summary
--prefix PREFIX	Add a prefix to all variable names

Table 37.10. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

37.4. group delete

Delete group(s)

Usage:

openstack group delete [-h] [--domain <domain>] <group> [<group> ...]

Table 37.11. Positional arguments
Value	Summary
<group>	Group(s) to delete (name or id)

Table 37.12. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--domain <domain>	Domain containing group(s) (name or id)

37.5. group list

List groups

Usage:

openstack group list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--noindent] [--max-width <integer>] [--fit-width]
                            [--print-empty] [--sort-column SORT_COLUMN]
                            [--sort-ascending | --sort-descending]
                            [--domain <domain>] [--user <user>]
                            [--user-domain <user-domain>] [--long]

Table 37.13. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--domain <domain>	Filter group list by <domain> (name or id)
--user <user>	Filter group list by <user> (name or id)
--user-domain <user-domain>	Domain the user belongs to (name or id). this can be used in case collisions between user names exist.
--long	List additional fields in output

Table 37.14. Output formatter options
Value	Summary
-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns
--sort-column SORT_COLUMN	Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated
--sort-ascending	Sort the column(s) in ascending order
--sort-descending	Sort the column(s) in descending order

Table 37.15. CSV formatter options
Value	Summary
--quote {all,minimal,none,nonnumeric}	When to include quotes, defaults to nonnumeric

Table 37.16. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 37.17. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

37.6. group remove user

Remove user from group

Usage:

openstack group remove user [-h] [--group-domain <group-domain>]
                                   [--user-domain <user-domain>]
                                   <group> <user> [<user> ...]

Table 37.18. Positional arguments
Value	Summary
<group>	Group containing <user> (name or id)
<user>	User(s) to remove from <group> (name or id) (repeat option to remove multiple users)

Table 37.19. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--group-domain <group-domain>	Domain the group belongs to (name or id). this can be used in case collisions between group names exist.
--user-domain <user-domain>	Domain the user belongs to (name or id). this can be used in case collisions between user names exist.

37.7. group set

Set group properties

Usage:

openstack group set [-h] [--domain <domain>] [--name <name>]
                           [--description <description>]
                           <group>

Table 37.20. Positional arguments
Value	Summary
<group>	Group to modify (name or id)

Table 37.21. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--domain <domain>	Domain containing <group> (name or id)
--name <name>	New group name
--description <description>	New group description

37.8. group show

Display group details

Usage:

openstack group show [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--noindent] [--prefix PREFIX]
                            [--max-width <integer>] [--fit-width]
                            [--print-empty] [--domain <domain>]
                            <group>

Table 37.22. Positional arguments
Value	Summary
<group>	Group to display (name or id)

Table 37.23. Command arguments
Value	Summary
-h, --help	Show this help message and exit
--domain <domain>	Domain containing <group> (name or id)

Table 37.24. Output formatter options
Value	Summary
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}	The output format, defaults to table
-c COLUMN, --column COLUMN	Specify the column(s) to include, can be repeated to show multiple columns

Table 37.25. JSON formatter options
Value	Summary
--noindent	Whether to disable indenting the json

Table 37.26. Shell formatter options
Value	Summary
--prefix PREFIX	Add a prefix to all variable names

Table 37.27. Table formatter options
Value	Summary
--max-width <integer>	Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.
--fit-width	Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable
--print-empty	Print empty table if there is no data to show.

37.1. group add user

37.2. group contains user

37.3. group create

37.4. group delete

37.5. group list

37.6. group remove user

37.7. group set

37.8. group show

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

Making open source more inclusive

About Red Hat

Red Hat legal and privacy links

Red Hat legal and privacy links