Chapter 52. network


This chapter describes the commands under the network command.

52.1. network agent add network

Add network to an agent

Usage:

openstack network agent add network [-h] [--dhcp] <agent-id> <network>

Table 52.1. Positional arguments
ValueSummary

<agent-id>

Agent to which a network is added (id only)

<network>

Network to be added to an agent (name or id)

Table 52.2. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--dhcp

Add network to a dhcp agent

52.2. network agent add router

Add router to an agent

Usage:

openstack network agent add router [-h] [--l3] <agent-id> <router>

Table 52.3. Positional arguments
ValueSummary

<agent-id>

Agent to which a router is added (id only)

<router>

Router to be added to an agent (name or id)

Table 52.4. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--l3

Add router to an l3 agent

52.3. network agent delete

Delete network agent(s)

Usage:

openstack network agent delete [-h]
                                      <network-agent> [<network-agent> ...]

Table 52.5. Positional arguments
ValueSummary

<network-agent>

Network agent(s) to delete (id only)

Table 52.6. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.4. network agent list

List network agents

Usage:

openstack network agent 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]
                                    [--agent-type <agent-type>]
                                    [--host <host>]
                                    [--network <network> | --router <router>]
                                    [--long]

Table 52.7. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--agent-type <agent-type>

List only agents with the specified agent type. the supported agent types are: dhcp, open-vswitch, linux-bridge, ofa, l3, loadbalancer, metering, metadata, macvtap, nic.

--host <host>

List only agents running on the specified host

--network <network>

List agents hosting a network (name or id)

--router <router>

List agents hosting this router (name or id)

--long

List additional fields in output

Table 52.8. 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 52.9. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.10. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.5. network agent remove network

Remove network from an agent.

Usage:

openstack network agent remove network [-h] [--dhcp]
                                              <agent-id> <network>

Table 52.12. Positional arguments
ValueSummary

<agent-id>

Agent to which a network is removed (id only)

<network>

Network to be removed from an agent (name or id)

Table 52.13. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--dhcp

Remove network from dhcp agent

52.6. network agent remove router

Remove router from an agent

Usage:

openstack network agent remove router [-h] [--l3] <agent-id> <router>

Table 52.14. Positional arguments
ValueSummary

<agent-id>

Agent from which router will be removed (id only)

<router>

Router to be removed from an agent (name or id)

Table 52.15. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--l3

Remove router from an l3 agent

52.7. network agent set

Set network agent properties

Usage:

openstack network agent set [-h] [--description <description>]
                                   [--enable | --disable]
                                   <network-agent>

Table 52.16. Positional arguments
ValueSummary

<network-agent>

Network agent to modify (id only)

Table 52.17. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Set network agent description

--enable

Enable network agent

--disable

Disable network agent

52.8. network agent show

Display network agent details

Usage:

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

Table 52.18. Positional arguments
ValueSummary

<network-agent>

Network agent to display (id only)

Table 52.19. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.20. 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 52.21. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.22. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.9. network auto allocated topology create

Create the auto allocated topology for project

Usage:

openstack network auto allocated topology create [-h]
                                                        [-f {json,shell,table,value,yaml}]
                                                        [-c COLUMN]
                                                        [--noindent]
                                                        [--prefix PREFIX]
                                                        [--max-width <integer>]
                                                        [--fit-width]
                                                        [--print-empty]
                                                        [--project <project>]
                                                        [--project-domain <project-domain>]
                                                        [--check-resources]
                                                        [--or-show]

Table 52.24. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Return the auto allocated topology for a given project. Default is current project

--project-domain <project-domain>

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

--check-resources

Validate the requirements for auto allocated topology. Does not return a topology.

--or-show

If topology exists returns the topology’s information (Default)

Table 52.25. 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 52.26. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.27. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.10. network auto allocated topology delete

Delete auto allocated topology for project

Usage:

openstack network auto allocated topology delete [-h]
                                                        [--project <project>]
                                                        [--project-domain <project-domain>]

Table 52.29. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Delete auto allocated topology for a given project. Default is the current project

--project-domain <project-domain>

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

52.11. network create

Create new network

Usage:

openstack network create [-h] [-f {json,shell,table,value,yaml}]
                                [-c COLUMN] [--noindent] [--prefix PREFIX]
                                [--max-width <integer>] [--fit-width]
                                [--print-empty] [--share | --no-share]
                                [--enable | --disable] [--project <project>]
                                [--description <description>] [--mtu <mtu>]
                                [--project-domain <project-domain>]
                                [--availability-zone-hint <availability-zone>]
                                [--enable-port-security | --disable-port-security]
                                [--external | --internal]
                                [--default | --no-default]
                                [--qos-policy <qos-policy>]
                                [--transparent-vlan | --no-transparent-vlan]
                                [--provider-network-type <provider-network-type>]
                                [--provider-physical-network <provider-physical-network>]
                                [--provider-segment <provider-segment>]
                                [--dns-domain <dns-domain>]
                                [--tag <tag> | --no-tag]
                                <name>

Table 52.30. Positional arguments
ValueSummary

<name>

New network name

Table 52.31. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--share

Share the network between projects

--no-share

Do not share the network between projects

--enable

Enable network (default)

--disable

Disable network

--project <project>

Owner’s project (name or id)

--description <description>

Set network description

--mtu <mtu>

Set network mtu

--project-domain <project-domain>

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

--availability-zone-hint <availability-zone>

Availability zone in which to create this network (Network Availability Zone extension required, repeat option to set multiple availability zones)

--enable-port-security

Enable port security by default for ports created on this network (default)

--disable-port-security

Disable port security by default for ports created on this network

--external

Set this network as an external network (external-net extension required)

--internal

Set this network as an internal network (default)

--default

Specify if this network should be used as the default external network

--no-default

Do not use the network as the default external network (default)

--qos-policy <qos-policy>

Qos policy to attach to this network (name or id)

--transparent-vlan

Make the network vlan transparent

--no-transparent-vlan

Do not make the network vlan transparent

--provider-network-type <provider-network-type>

The physical mechanism by which the virtual network is implemented. For example: flat, geneve, gre, local, vlan, vxlan.

--provider-physical-network <provider-physical-network>

Name of the physical network over which the virtual network is implemented

--provider-segment <provider-segment>

Vlan id for vlan networks or tunnel id for GENEVE/GRE/VXLAN networks

--dns-domain <dns-domain>

Set dns domain for this network (requires dns integration extension)

--tag <tag>

Tag to be added to the network (repeat option to set multiple tags)

--no-tag

No tags associated with the network

Table 52.32. 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 52.33. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.34. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.12. network delete

Delete network(s)

Usage:

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

Table 52.36. Positional arguments
ValueSummary

<network>

Network(s) to delete (name or id)

Table 52.37. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.13. network flavor add profile

Add a service profile to a network flavor

Usage:

openstack network flavor add profile [-h] <flavor> <service-profile>

Table 52.38. Positional arguments
ValueSummary

<flavor>

Network flavor (name or id)

<service-profile>

Service profile (id only)

Table 52.39. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.14. network flavor create

Create new network flavor

Usage:

openstack network flavor create [-h] [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--noindent]
                                       [--prefix PREFIX]
                                       [--max-width <integer>] [--fit-width]
                                       [--print-empty] --service-type
                                       <service-type>
                                       [--description DESCRIPTION]
                                       [--project <project>]
                                       [--project-domain <project-domain>]
                                       [--enable | --disable]
                                       <name>

Table 52.40. Positional arguments
ValueSummary

<name>

Name for the flavor

Table 52.41. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--service-type <service-type>

Service type to which the flavor applies to: e.g. vpn (See openstack network service provider list for loaded examples.)

--description DESCRIPTION

Description for the flavor

--project <project>

Owner’s project (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.

--enable

Enable the flavor (default)

--disable

Disable the flavor

Table 52.42. 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 52.43. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.44. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.15. network flavor delete

Delete network flavors

Usage:

openstack network flavor delete [-h] <flavor> [<flavor> ...]

Table 52.46. Positional arguments
ValueSummary

<flavor>

Flavor(s) to delete (name or id)

Table 52.47. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.16. network flavor list

List network flavors

Usage:

openstack network flavor 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]

Table 52.48. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.49. 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 52.50. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.51. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.17. network flavor profile create

Create new network flavor profile

Usage:

openstack network flavor profile create [-h]
                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN] [--noindent]
                                               [--prefix PREFIX]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--project <project>]
                                               [--project-domain <project-domain>]
                                               [--description <description>]
                                               [--enable | --disable]
                                               [--driver DRIVER]
                                               [--metainfo METAINFO]

Table 52.53. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Owner’s project (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.

--description <description>

Description for the flavor profile

--enable

Enable the flavor profile

--disable

Disable the flavor profile

--driver DRIVER

Python module path to driver. this becomes required if --metainfo is missing and vice versa

--metainfo METAINFO

Metainfo for the flavor profile. this becomes required if --driver is missing and vice versa

Table 52.54. 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 52.55. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.56. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.18. network flavor profile delete

Delete network flavor profile

Usage:

openstack network flavor profile delete [-h]
                                               <flavor-profile>
                                               [<flavor-profile> ...]

Table 52.58. Positional arguments
ValueSummary

<flavor-profile>

Flavor profile(s) to delete (id only)

Table 52.59. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.19. network flavor profile list

List network flavor profile(s)

Usage:

openstack network flavor profile 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]

Table 52.60. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.61. 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 52.62. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.63. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.20. network flavor profile set

Set network flavor profile properties

Usage:

openstack network flavor profile set [-h]
                                            [--project-domain <project-domain>]
                                            [--description <description>]
                                            [--enable | --disable]
                                            [--driver DRIVER]
                                            [--metainfo METAINFO]
                                            <flavor-profile>

Table 52.65. Positional arguments
ValueSummary

<flavor-profile>

Flavor profile to update (id only)

Table 52.66. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project-domain <project-domain>

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

--description <description>

Description for the flavor profile

--enable

Enable the flavor profile

--disable

Disable the flavor profile

--driver DRIVER

Python module path to driver. this becomes required if --metainfo is missing and vice versa

--metainfo METAINFO

Metainfo for the flavor profile. this becomes required if --driver is missing and vice versa

52.21. network flavor profile show

Display network flavor profile details

Usage:

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

Table 52.67. Positional arguments
ValueSummary

<flavor-profile>

Flavor profile to display (id only)

Table 52.68. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.69. 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 52.70. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.71. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.22. network flavor remove profile

Remove service profile from network flavor

Usage:

openstack network flavor remove profile [-h] <flavor> <service-profile>

Table 52.73. Positional arguments
ValueSummary

<flavor>

Network flavor (name or id)

<service-profile>

Service profile (id only)

Table 52.74. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.23. network flavor set

Set network flavor properties

Usage:

openstack network flavor set [-h] [--description DESCRIPTION]
                                    [--disable | --enable] [--name <name>]
                                    <flavor>

Table 52.75. Positional arguments
ValueSummary

<flavor>

Flavor to update (name or id)

Table 52.76. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description DESCRIPTION

Set network flavor description

--disable

Disable network flavor

--enable

Enable network flavor

--name <name>

Set flavor name

52.24. network flavor show

Display network flavor details

Usage:

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

Table 52.77. Positional arguments
ValueSummary

<flavor>

Flavor to display (name or id)

Table 52.78. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.79. 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 52.80. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.81. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.25. network list

List networks

Usage:

openstack network 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]
                              [--external | --internal] [--long]
                              [--name <name>] [--enable | --disable]
                              [--project <project>]
                              [--project-domain <project-domain>]
                              [--share | --no-share] [--status <status>]
                              [--provider-network-type <provider-network-type>]
                              [--provider-physical-network <provider-physical-network>]
                              [--provider-segment <provider-segment>]
                              [--agent <agent-id>] [--tags <tag>[,<tag>,...]]
                              [--any-tags <tag>[,<tag>,...]]
                              [--not-tags <tag>[,<tag>,...]]
                              [--not-any-tags <tag>[,<tag>,...]]

Table 52.83. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--external

List external networks

--internal

List internal networks

--long

List additional fields in output

--name <name>

List networks according to their name

--enable

List enabled networks

--disable

List disabled networks

--project <project>

List networks according to their project (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.

--share

List networks shared between projects

--no-share

List networks not shared between projects

--status <status>

List networks according to their status (active, BUILD, DOWN, ERROR)

--provider-network-type <provider-network-type>

List networks according to their physical mechanisms. The supported options are: flat, geneve, gre, local, vlan, vxlan.

--provider-physical-network <provider-physical-network>

List networks according to name of the physical network

--provider-segment <provider-segment>

List networks according to vlan id for vlan networks or Tunnel ID for GENEVE/GRE/VXLAN networks

--agent <agent-id>

List networks hosted by agent (id only)

--tags <tag>[,<tag>,…​]

List networks which have all given tag(s) (comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List networks which have any given tag(s) (comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude networks which have all given tag(s) (comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude networks which have any given tag(s) (comma- separated list of tags)

Table 52.84. 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 52.85. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.86. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.26. network log create

Create a new network log

Usage:

openstack network log create [-h] [-f {json,shell,table,value,yaml}]
                                    [-c COLUMN] [--noindent] [--prefix PREFIX]
                                    [--max-width <integer>] [--fit-width]
                                    [--print-empty]
                                    [--description <description>]
                                    [--enable | --disable]
                                    [--project <project>]
                                    [--project-domain <project-domain>]
                                    [--event {ALL,ACCEPT,DROP}]
                                    --resource-type <resource-type>
                                    [--resource <resource>]
                                    [--target <target>]
                                    <name>

Table 52.88. Positional arguments
ValueSummary

<name>

Name for the network log

Table 52.89. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the network log

--enable

Enable this log (default is disabled)

--disable

Disable this log

--project <project>

Owner’s project (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.

--event {ALL,ACCEPT,DROP}

An event to store with log

--resource-type <resource-type>

Network log type(s). you can see supported type(s) with following command: $ openstack network loggable resources list

--resource <resource>

Name or id of resource (security group or firewall group) that used for logging. You can control for logging target combination with --target option.

--target <target>

Port (name or id) for logging. you can control for logging target combination with --resource option.

Table 52.90. 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 52.91. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.92. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.27. network log delete

Delete network log(s)

Usage:

openstack network log delete [-h] <network-log> [<network-log> ...]

Table 52.94. Positional arguments
ValueSummary

<network-log>

Network log(s) to delete (name or id)

Table 52.95. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.28. network log list

List network logs

Usage:

openstack network log 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 52.96. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Table 52.97. 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 52.98. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.99. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.29. network log set

Set network log properties

Usage:

openstack network log set [-h] [--description <description>]
                                 [--enable | --disable] [--name <name>]
                                 <network-log>

Table 52.101. Positional arguments
ValueSummary

<network-log>

Network log to set (name or id)

Table 52.102. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the network log

--enable

Enable this log (default is disabled)

--disable

Disable this log

--name <name>

Name of the network log

52.30. network log show

Display network log details

Usage:

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

Table 52.103. Positional arguments
ValueSummary

<network-log>

Network log to show (name or id)

Table 52.104. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.105. 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 52.106. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.107. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.31. network loggable resources list

List supported loggable resources

Usage:

openstack network loggable resources 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 52.109. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Table 52.110. 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 52.111. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.112. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.32. network meter create

Create network meter

Usage:

openstack network meter create [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--noindent]
                                      [--prefix PREFIX]
                                      [--max-width <integer>] [--fit-width]
                                      [--print-empty]
                                      [--description <description>]
                                      [--project <project>]
                                      [--project-domain <project-domain>]
                                      [--share | --no-share]
                                      <name>

Table 52.114. Positional arguments
ValueSummary

<name>

Name of meter

Table 52.115. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Create description for meter

--project <project>

Owner’s project (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.

--share

Share meter between projects

--no-share

Do not share meter between projects

Table 52.116. 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 52.117. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.118. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.33. network meter delete

Delete network meter

Usage:

openstack network meter delete [-h] <meter> [<meter> ...]

Table 52.120. Positional arguments
ValueSummary

<meter>

Meter to delete (name or id)

Table 52.121. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.34. network meter list

List network meters

Usage:

openstack network meter 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]

Table 52.122. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.123. 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 52.124. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.125. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.35. network meter rule create

Create a new meter rule

Usage:

openstack network meter rule create [-h]
                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN] [--noindent]
                                           [--prefix PREFIX]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--project <project>]
                                           [--project-domain <project-domain>]
                                           [--exclude | --include]
                                           [--ingress | --egress]
                                           --remote-ip-prefix
                                           <remote-ip-prefix>
                                           <meter>

Table 52.127. Positional arguments
ValueSummary

<meter>

Label to associate with this metering rule (name or ID)

Table 52.128. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Owner’s project (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.

--exclude

Exclude remote ip prefix from traffic count

--include

Include remote ip prefix from traffic count (default)

--ingress

Apply rule to incoming network traffic (default)

--egress

Apply rule to outgoing network traffic

--remote-ip-prefix <remote-ip-prefix>

The remote ip prefix to associate with this rule

Table 52.129. 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 52.130. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.131. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.36. network meter rule delete

Delete meter rule(s)

Usage:

openstack network meter rule delete [-h]
                                           <meter-rule-id>
                                           [<meter-rule-id> ...]

Table 52.133. Positional arguments
ValueSummary

<meter-rule-id>

Meter rule to delete (id only)

Table 52.134. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.37. network meter rule list

List meter rules

Usage:

openstack network meter rule 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]

Table 52.135. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.136. 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 52.137. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.138. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.38. network meter rule show

Display meter rules details

Usage:

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

Table 52.140. Positional arguments
ValueSummary

<meter-rule-id>

Meter rule (id only)

Table 52.141. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.142. 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 52.143. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.144. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.39. network meter show

Show network meter

Usage:

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

Table 52.146. Positional arguments
ValueSummary

<meter>

Meter to display (name or id)

Table 52.147. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.148. 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 52.149. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.150. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.40. network onboard subnets

Onboard network subnets into a subnet pool

Usage:

openstack network onboard subnets [-h] <network> <subnetpool>

Table 52.152. Positional arguments
ValueSummary

<network>

Onboard all subnets associated with this network

<subnetpool>

Target subnet pool for onboarding subnets

Table 52.153. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.41. network qos policy create

Create a QoS policy

Usage:

openstack network qos policy create [-h]
                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN] [--noindent]
                                           [--prefix PREFIX]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--description <description>]
                                           [--share | --no-share]
                                           [--project <project>]
                                           [--project-domain <project-domain>]
                                           [--default | --no-default]
                                           <name>

Table 52.154. Positional arguments
ValueSummary

<name>

Name of qos policy to create

Table 52.155. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the qos policy

--share

Make the qos policy accessible by other projects

--no-share

Make the qos policy not accessible by other projects (default)

--project <project>

Owner’s project (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.

--default

Set this as a default network qos policy

--no-default

Set this as a non-default network qos policy

Table 52.156. 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 52.157. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.158. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.42. network qos policy delete

Delete Qos Policy(s)

Usage:

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

Table 52.160. Positional arguments
ValueSummary

<qos-policy>

Qos policy(s) to delete (name or id)

Table 52.161. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.43. network qos policy list

List QoS policies

Usage:

openstack network qos 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]
                                         [--project <project>]
                                         [--project-domain <project-domain>]
                                         [--share | --no-share]

Table 52.162. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

List qos policies according to their project (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.

--share

List qos policies shared between projects

--no-share

List qos policies not shared between projects

Table 52.163. 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 52.164. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.165. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.44. network qos policy set

Set QoS policy properties

Usage:

openstack network qos policy set [-h] [--name <name>]
                                        [--description <description>]
                                        [--share | --no-share]
                                        [--default | --no-default]
                                        <qos-policy>

Table 52.167. Positional arguments
ValueSummary

<qos-policy>

Qos policy to modify (name or id)

Table 52.168. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set qos policy name

--description <description>

Description of the qos policy

--share

Make the qos policy accessible by other projects

--no-share

Make the qos policy not accessible by other projects

--default

Set this as a default network qos policy

--no-default

Set this as a non-default network qos policy

52.45. network qos policy show

Display QoS policy details

Usage:

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

Table 52.169. Positional arguments
ValueSummary

<qos-policy>

Qos policy to display (name or id)

Table 52.170. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.171. 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 52.172. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.173. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.46. network qos rule create

Create new Network QoS rule

Usage:

openstack network qos rule create [-h]
                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--noindent]
                                         [--prefix PREFIX]
                                         [--max-width <integer>] [--fit-width]
                                         [--print-empty] [--type <type>]
                                         [--max-kbps <max-kbps>]
                                         [--max-burst-kbits <max-burst-kbits>]
                                         [--dscp-mark <dscp-mark>]
                                         [--min-kbps <min-kbps>]
                                         [--ingress | --egress]
                                         <qos-policy>

Table 52.175. Positional arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

Table 52.176. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--type <type>

Qos rule type (minimum-bandwidth, dscp-marking, bandwidth-limit)

--max-kbps <max-kbps>

Maximum bandwidth in kbps

--max-burst-kbits <max-burst-kbits>

Maximum burst in kilobits, 0 or not specified means automatic, which is 80% of the bandwidth limit, which works for typical TCP traffic. For details check the QoS user workflow.

--dscp-mark <dscp-mark>

Dscp mark: value can be 0, even numbers from 8-56, excluding 42, 44, 50, 52, and 54

--min-kbps <min-kbps>

Minimum guaranteed bandwidth in kbps

--ingress

Ingress traffic direction from the project point of view

--egress

Egress traffic direction from the project point of view

Table 52.177. 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 52.178. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.179. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.47. network qos rule delete

Delete Network QoS rule

Usage:

openstack network qos rule delete [-h] <qos-policy> <rule-id>

Table 52.181. Positional arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

<rule-id>

Network qos rule to delete (id)

Table 52.182. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.48. network qos rule list

List Network QoS rules

Usage:

openstack network qos rule 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]
                                       <qos-policy>

Table 52.183. Positional arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

Table 52.184. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.185. 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 52.186. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.187. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.49. network qos rule set

Set Network QoS rule properties

Usage:

openstack network qos rule set [-h] [--max-kbps <max-kbps>]
                                      [--max-burst-kbits <max-burst-kbits>]
                                      [--dscp-mark <dscp-mark>]
                                      [--min-kbps <min-kbps>]
                                      [--ingress | --egress]
                                      <qos-policy> <rule-id>

Table 52.189. Positional arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

<rule-id>

Network qos rule to delete (id)

Table 52.190. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--max-kbps <max-kbps>

Maximum bandwidth in kbps

--max-burst-kbits <max-burst-kbits>

Maximum burst in kilobits, 0 or not specified means automatic, which is 80% of the bandwidth limit, which works for typical TCP traffic. For details check the QoS user workflow.

--dscp-mark <dscp-mark>

Dscp mark: value can be 0, even numbers from 8-56, excluding 42, 44, 50, 52, and 54

--min-kbps <min-kbps>

Minimum guaranteed bandwidth in kbps

--ingress

Ingress traffic direction from the project point of view

--egress

Egress traffic direction from the project point of view

52.50. network qos rule show

Display Network QoS rule details

Usage:

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

Table 52.191. Positional arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

<rule-id>

Network qos rule to delete (id)

Table 52.192. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.193. 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 52.194. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.195. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.51. network qos rule type list

List QoS rule types

Usage:

openstack network qos rule type 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]

Table 52.197. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.198. 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 52.199. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.200. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.52. network qos rule type show

Show details about supported QoS rule type

Usage:

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

Table 52.202. Positional arguments
ValueSummary

<qos-rule-type-name>

Name of qos rule type

Table 52.203. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.204. 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 52.205. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.206. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.53. network rbac create

Create network RBAC policy

Usage:

openstack network rbac create [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty] --type
                                     <type> --action <action>
                                     (--target-project <target-project> | --target-all-projects)
                                     [--target-project-domain <target-project-domain>]
                                     [--project <project>]
                                     [--project-domain <project-domain>]
                                     <rbac-object>

Table 52.208. Positional arguments
ValueSummary

<rbac-object>

The object to which this rbac policy affects (name or ID)

Table 52.209. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--type <type>

Type of the object that rbac policy affects ("security_group", "qos_policy" or "network")

--action <action>

Action for the rbac policy ("access_as_external" or "access_as_shared")

--target-project <target-project>

The project to which the rbac policy will be enforced (name or ID)

--target-all-projects

Allow creating rbac policy for all projects.

--target-project-domain <target-project-domain>

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

--project <project>

The owner project (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.

Table 52.210. 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 52.211. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.212. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.54. network rbac delete

Delete network RBAC policy(s)

Usage:

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

Table 52.214. Positional arguments
ValueSummary

<rbac-policy>

Rbac policy(s) to delete (id only)

Table 52.215. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.55. network rbac list

List network RBAC policies

Usage:

openstack network rbac 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] [--type <type>]
                                   [--action <action>] [--long]

Table 52.216. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--type <type>

List network rbac policies according to given object type ("security_group", "qos_policy" or "network")

--action <action>

List network rbac policies according to given action ("access_as_external" or "access_as_shared")

--long

List additional fields in output

Table 52.217. 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 52.218. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.219. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.56. network rbac set

Set network RBAC policy properties

Usage:

openstack network rbac set [-h] [--target-project <target-project>]
                                  [--target-project-domain <target-project-domain>]
                                  <rbac-policy>

Table 52.221. Positional arguments
ValueSummary

<rbac-policy>

Rbac policy to be modified (id only)

Table 52.222. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--target-project <target-project>

The project to which the rbac policy will be enforced (name or ID)

--target-project-domain <target-project-domain>

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

52.57. network rbac show

Display network RBAC policy details

Usage:

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

Table 52.223. Positional arguments
ValueSummary

<rbac-policy>

Rbac policy (id only)

Table 52.224. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.225. 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 52.226. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.227. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.58. network segment create

Create new network segment

Usage:

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

Table 52.229. Positional arguments
ValueSummary

<name>

New network segment name

Table 52.230. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Network segment description

--physical-network <physical-network>

Physical network name of this network segment

--segment <segment>

Segment identifier for this network segment which is based on the network type, VLAN ID for vlan network type and tunnel ID for geneve, gre and vxlan network types

--network <network>

Network this network segment belongs to (name or id)

--network-type <network-type>

Network type of this network segment (flat, geneve, gre, local, vlan or vxlan)

Table 52.231. 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 52.232. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.233. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.59. network segment delete

Delete network segment(s)

Usage:

openstack network segment delete [-h]
                                        <network-segment>
                                        [<network-segment> ...]

Table 52.235. Positional arguments
ValueSummary

<network-segment>

Network segment(s) to delete (name or id)

Table 52.236. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.60. network segment list

List network segments

Usage:

openstack network segment 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]
                                      [--network <network>]

Table 52.237. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--network <network>

List network segments that belong to this network (name or ID)

Table 52.238. 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 52.239. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.240. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.61. network segment range create

Create new network segment range

Usage:

openstack network segment range create [-h]
                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN] [--noindent]
                                              [--prefix PREFIX]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--private | --shared]
                                              [--project <project>]
                                              [--project-domain <project-domain>]
                                              --network-type <network-type>
                                              [--physical-network <physical-network-name>]
                                              --minimum
                                              <minimum-segmentation-id>
                                              --maximum
                                              <maximum-segmentation-id>
                                              <name>

Table 52.242. Positional arguments
ValueSummary

<name>

Name of new network segment range

Table 52.243. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--private

Network segment range is assigned specifically to the project

--shared

Network segment range is shared with other projects

--project <project>

Network segment range owner (name or id). optional when the segment range is shared

--project-domain <project-domain>

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

--network-type <network-type>

Network type of this network segment range (geneve, gre, vlan or vxlan)

--physical-network <physical-network-name>

Physical network name of this network segment range

--minimum <minimum-segmentation-id>

Minimum segment identifier for this network segment range which is based on the network type, VLAN ID for vlan network type and tunnel ID for geneve, gre and vxlan network types

--maximum <maximum-segmentation-id>

Maximum segment identifier for this network segment range which is based on the network type, VLAN ID for vlan network type and tunnel ID for geneve, gre and vxlan network types

Table 52.244. 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 52.245. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.246. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.62. network segment range delete

Delete network segment range(s)

Usage:

openstack network segment range delete [-h]
                                              <network-segment-range>
                                              [<network-segment-range> ...]

Table 52.248. Positional arguments
ValueSummary

<network-segment-range>

Network segment range(s) to delete (name or id)

Table 52.249. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.63. network segment range list

List network segment ranges

Usage:

openstack network segment range 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] [--used | --unused]
                                            [--available | --unavailable]

Table 52.250. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--used

List network segment ranges that have segments in use

--unused

List network segment ranges that have segments not in use

--available

List network segment ranges that have available segments

--unavailable

List network segment ranges without available segments

Table 52.251. 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 52.252. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.253. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.64. network segment range set

Set network segment range properties

Usage:

openstack network segment range set [-h] [--name <name>]
                                           [--minimum <minimum-segmentation-id>]
                                           [--maximum <maximum-segmentation-id>]
                                           <network-segment-range>

Table 52.255. Positional arguments
ValueSummary

<network-segment-range>

Network segment range to modify (name or id)

Table 52.256. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set network segment name

--minimum <minimum-segmentation-id>

Set network segment range minimum segment identifier

--maximum <maximum-segmentation-id>

Set network segment range maximum segment identifier

52.65. network segment range show

Display network segment range details

Usage:

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

Table 52.257. Positional arguments
ValueSummary

<network-segment-range>

Network segment range to display (name or id)

Table 52.258. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.259. 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 52.260. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.261. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.66. network segment set

Set network segment properties

Usage:

openstack network segment set [-h] [--description <description>]
                                     [--name <name>]
                                     <network-segment>

Table 52.263. Positional arguments
ValueSummary

<network-segment>

Network segment to modify (name or id)

Table 52.264. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Set network segment description

--name <name>

Set network segment name

52.67. network segment show

Display network segment details

Usage:

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

Table 52.265. Positional arguments
ValueSummary

<network-segment>

Network segment to display (name or id)

Table 52.266. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.267. 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 52.268. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.269. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.68. network service provider list

List Service Providers

Usage:

openstack network service provider 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]

Table 52.271. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.272. 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 52.273. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.274. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.69. network set

Set network properties

Usage:

openstack network set [-h] [--name <name>] [--enable | --disable]
                             [--share | --no-share]
                             [--description <description] [--mtu <mtu]
                             [--enable-port-security | --disable-port-security]
                             [--external | --internal]
                             [--default | --no-default]
                             [--qos-policy <qos-policy> | --no-qos-policy]
                             [--tag <tag>] [--no-tag]
                             [--provider-network-type <provider-network-type>]
                             [--provider-physical-network <provider-physical-network>]
                             [--provider-segment <provider-segment>]
                             [--dns-domain <dns-domain>]
                             <network>

Table 52.276. Positional arguments
ValueSummary

<network>

Network to modify (name or id)

Table 52.277. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set network name

--enable

Enable network

--disable

Disable network

--share

Share the network between projects

--no-share

Do not share the network between projects

--description <description

Set network description

--mtu <mtu

Set network mtu

--enable-port-security

Enable port security by default for ports created on this network

--disable-port-security

Disable port security by default for ports created on this network

--external

Set this network as an external network (external-net extension required)

--internal

Set this network as an internal network

--default

Set the network as the default external network

--no-default

Do not use the network as the default external network

--qos-policy <qos-policy>

Qos policy to attach to this network (name or id)

--no-qos-policy

Remove the qos policy attached to this network

--tag <tag>

Tag to be added to the network (repeat option to set multiple tags)

--no-tag

Clear tags associated with the network. specify both --tag and --no-tag to overwrite current tags

--provider-network-type <provider-network-type>

The physical mechanism by which the virtual network is implemented. For example: flat, geneve, gre, local, vlan, vxlan.

--provider-physical-network <provider-physical-network>

Name of the physical network over which the virtual network is implemented

--provider-segment <provider-segment>

Vlan id for vlan networks or tunnel id for GENEVE/GRE/VXLAN networks

--dns-domain <dns-domain>

Set dns domain for this network (requires dns integration extension)

52.70. network show

Show network details

Usage:

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

Table 52.278. Positional arguments
ValueSummary

<network>

Network to display (name or id)

Table 52.279. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.280. 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 52.281. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.282. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.71. network subport list

List all subports for a given network trunk

Usage:

openstack network subport 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] --trunk
                                      <trunk>

Table 52.284. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--trunk <trunk>

List subports belonging to this trunk (name or id)

Table 52.285. 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 52.286. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.287. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.72. network trunk create

Create a network trunk for a given project

Usage:

openstack network trunk create [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--noindent]
                                      [--prefix PREFIX]
                                      [--max-width <integer>] [--fit-width]
                                      [--print-empty]
                                      [--description <description>]
                                      --parent-port <parent-port>
                                      [--subport <port=,segmentation-type=,segmentation-id=>]
                                      [--enable | --disable]
                                      [--project <project>]
                                      [--project-domain <project-domain>]
                                      <name>

Table 52.289. Positional arguments
ValueSummary

<name>

Name of the trunk to create

Table 52.290. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

A description of the trunk

--parent-port <parent-port>

Parent port belonging to this trunk (name or id)

--subport <port=,segmentation-type=,segmentation-id⇒

Subport to add. subport is of form port=<name or ID>,segmentation-type=,segmentation-ID= (--subport) option can be repeated

--enable

Enable trunk (default)

--disable

Disable trunk

--project <project>

Owner’s project (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.

Table 52.291. 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 52.292. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.293. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.73. network trunk delete

Delete a given network trunk

Usage:

openstack network trunk delete [-h] <trunk> [<trunk> ...]

Table 52.295. Positional arguments
ValueSummary

<trunk>

Trunk(s) to delete (name or id)

Table 52.296. Command arguments
ValueSummary

-h, --help

Show this help message and exit

52.74. network trunk list

List all network trunks

Usage:

openstack network trunk 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 52.297. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Table 52.298. 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 52.299. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 52.300. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

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

52.75. network trunk set

Set network trunk properties

Usage:

openstack network trunk set [-h] [--name <name>]
                                   [--description <description>]
                                   [--subport <port=,segmentation-type=,segmentation-id=>]
                                   [--enable | --disable]
                                   <trunk>

Table 52.302. Positional arguments
ValueSummary

<trunk>

Trunk to modify (name or id)

Table 52.303. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set trunk name

--description <description>

A description of the trunk

--subport <port=,segmentation-type=,segmentation-id⇒

Subport to add. subport is of form port=<name or ID>,segmentation-type=,segmentation-ID=(--subport) option can be repeated

--enable

Enable trunk

--disable

Disable trunk

52.76. network trunk show

Show information of a given network trunk

Usage:

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

Table 52.304. Positional arguments
ValueSummary

<trunk>

Trunk to display (name or id)

Table 52.305. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 52.306. 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 52.307. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 52.308. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

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

52.77. network trunk unset

Unset subports from a given network trunk

Usage:

openstack network trunk unset [-h] --subport <subport> <trunk>

Table 52.310. Positional arguments
ValueSummary

<trunk>

Unset subports from this trunk (name or id)

Table 52.311. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--subport <subport>

Subport to delete (name or id of the port) (--subport) option can be repeated

52.78. network unset

Unset network properties

Usage:

openstack network unset [-h] [--tag <tag> | --all-tag] <network>

Table 52.312. Positional arguments
ValueSummary

<network>

Network to modify (name or id)

Table 52.313. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--tag <tag>

Tag to be removed from the network (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the network

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.

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.

© 2024 Red Hat, Inc.