Chapter 35. group

This chapter describes the commands under the group command.

35.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 35.1. Positional arguments

ValueSummary

<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 35.2. Command arguments

ValueSummary

-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.

35.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 35.3. Positional arguments

ValueSummary

<group>

Group to check (name or id)

<user>

User to check (name or id)

Table 35.4. Command arguments

ValueSummary

-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.

35.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 35.5. Positional arguments

ValueSummary

<group-name>

New group name

Table 35.6. Command arguments

ValueSummary

-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 35.7. Output formatter options

ValueSummary

-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

Table 35.8. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 35.9. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 35.10. Table formatter options

ValueSummary

--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.

35.4. group delete

Delete group(s)

Usage:

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

Table 35.11. Positional arguments

ValueSummary

<group>

Group(s) to delete (name or id)

Table 35.12. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--domain <domain>

Domain containing group(s) (name or id)

35.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]
                            [--domain <domain>] [--user <user>]
                            [--user-domain <user-domain>] [--long]

Table 35.13. Command arguments

ValueSummary

-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 35.14. Output formatter options

ValueSummary

-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

--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

Table 35.15. CSV formatter options

ValueSummary

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

Table 35.16. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 35.17. Table formatter options

ValueSummary

--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.

35.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 35.18. Positional arguments

ValueSummary

<group>

Group containing <user> (name or id)

<user>

User(s) to remove from <group> (name or id) (repeat option to remove multiple users)

Table 35.19. Command arguments

ValueSummary

-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.

35.7. group set

Set group properties

Usage:

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

Table 35.20. Positional arguments

ValueSummary

<group>

Group to modify (name or id)

Table 35.21. Command arguments

ValueSummary

-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

35.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 35.22. Positional arguments

ValueSummary

<group>

Group to display (name or id)

Table 35.23. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--domain <domain>

Domain containing <group> (name or id)

Table 35.24. Output formatter options

ValueSummary

-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

Table 35.25. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 35.26. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 35.27. Table formatter options

ValueSummary

--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.