Chapter 56. policy

This chapter describes the commands under the policy command.

56.1. policy create

Create new policy

Usage:

openstack policy create [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--noindent] [--prefix PREFIX]
                               [--max-width <integer>] [--fit-width]
                               [--print-empty] [--type <type>]
                               <filename>

Table 56.1. Positional arguments

ValueSummary

<filename>

New serialized policy rules file

Table 56.2. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--type <type>

New mime type of the policy rules file (defaults to application/json)

Table 56.3. 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 56.4. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 56.5. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

56.2. policy delete

Delete policy(s)

Usage:

openstack policy delete [-h] <policy> [<policy> ...]

Table 56.7. Positional arguments

ValueSummary

<policy>

Policy(s) to delete

Table 56.8. Command arguments

ValueSummary

-h, --help

Show this help message and exit

56.3. policy list

List policies

Usage:

openstack policy 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] [--long]

Table 56.9. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Table 56.10. 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 56.11. CSV formatter options

ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 56.12. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

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

56.4. policy set

Set policy properties

Usage:

openstack policy set [-h] [--type <type>] [--rules <filename>] <policy>

Table 56.14. Positional arguments

ValueSummary

<policy>

Policy to modify

Table 56.15. Command arguments

ValueSummary

-h, --help

Show this help message and exit

--type <type>

New mime type of the policy rules file

--rules <filename>

New serialized policy rules file

56.5. policy show

Display policy details

Usage:

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

Table 56.16. Positional arguments

ValueSummary

<policy>

Policy to display

Table 56.17. Command arguments

ValueSummary

-h, --help

Show this help message and exit

Table 56.18. 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 56.19. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 56.20. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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