Chapter 52. project


This chapter describes the commands under the project command.

52.1. project create

Usage:

openstack project create [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              [--description <description>]
                              [--enable | --disable]
                              [--property <key=value>] [--or-show]
                              <project-name>
Copy to Clipboard Toggle word wrap

Create new project

Expand
Table 52.1. Positional Arguments
ValueSummary

<project-name>

New project name

Expand
Table 52.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Project description

--enable

Enable project (default)

--disable

Disable project

--property <key=value>

Add a property to <name> (repeat option to set multiple properties)

--or-show

Return existing project

Expand
Table 52.3. Output Formatters
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

Expand
Table 52.4. Table Formatter
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.

Expand
Table 52.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 52.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

52.2. project delete

Usage:

openstack project delete [-h] <project> [<project> ...]
Copy to Clipboard Toggle word wrap

Delete project(s)

Expand
Table 52.7. Positional Arguments
ValueSummary

<project>

Project(s) to delete (name or id)

Expand
Table 52.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

52.3. project list

Usage:

openstack project list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--long]
                            [--sort <key>[:<direction>]]
Copy to Clipboard Toggle word wrap

List projects

Expand
Table 52.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--sort <key>[:<direction>]

Sort output by selected keys and directions (asc or desc) (default: asc), repeat this option to specify multiple keys and directions.

Expand
Table 52.10. Output Formatters
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

Expand
Table 52.11. Table Formatter
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.

Expand
Table 52.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 52.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

52.4. project purge

Usage:

openstack project purge [-h] [--dry-run] [--keep-project]

                             (--auth-project | --project <project>)
                             [--project-domain <project-domain>]
Copy to Clipboard Toggle word wrap

Clean resources associated with a project

Expand
Table 52.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--dry-run

List a project’s resources

--keep-project

Clean project resources, but don’t delete the project

--auth-project

Delete resources of the project used to authenticate

--project <project>

Project to clean (name or id)

--project-domain <project-domain>

Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.

52.5. project set

Usage:

openstack project set [-h] [--name <name>]

                           [--description <description>]
                           [--enable | --disable] [--property <key=value>]
                           <project>
Copy to Clipboard Toggle word wrap

Set project properties

Expand
Table 52.15. Positional Arguments
ValueSummary

<project>

Project to modify (name or id)

Expand
Table 52.16. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set project name

--description <description>

Set project description

--enable

Enable project

--disable

Disable project

--property <key=value>

Set a project property (repeat option to set multiple properties)

52.6. project show

Usage:

openstack project show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX]
                            <project>
Copy to Clipboard Toggle word wrap

Display project details

Expand
Table 52.17. Positional Arguments
ValueSummary

<project>

Project to display (name or id)

Expand
Table 52.18. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 52.19. Output Formatters
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

Expand
Table 52.20. Table Formatter
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.

Expand
Table 52.21. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 52.22. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

52.7. project unset

Usage:

openstack project unset [-h] [--property <key>] <project>
Copy to Clipboard Toggle word wrap

Unset project properties

Expand
Table 52.23. Positional Arguments
ValueSummary

<project>

Project to modify (name or id)

Expand
Table 52.24. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Unset a project property (repeat option to unset multiple properties)

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat