Chapter 59. port
This chapter describes the commands under the port
command.
59.1. port create
Create a new port
Usage:
openstack port create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --network <network> [--description <description>] [--device <device-id>] [--mac-address <mac-address>] [--device-owner <device-owner>] [--vnic-type <vnic-type>] [--host <host-id>] [--dns-domain dns-domain] [--dns-name <dns-name>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address> | --no-fixed-ip] [--binding-profile <binding-profile>] [--enable | --disable] [--enable-uplink-status-propagation | --disable-uplink-status-propagation] [--project <project>] [--project-domain <project-domain>] [--extra-dhcp-option name=<name>[,value=<value>,ip-version={4,6}]] [--security-group <security-group> | --no-security-group] [--qos-policy <qos-policy>] [--enable-port-security | --disable-port-security] [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]] [--tag <tag> | --no-tag] <name>
Value | Summary |
---|---|
<name> | Name of this port |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--network <network> | Network this port belongs to (name or id) |
--description <description> | Description of this port |
--device <device-id> | Port device id |
--mac-address <mac-address> | Mac address of this port (admin only) |
--device-owner <device-owner> | Device owner of this port. this is the entity that uses the port (for example, network:dhcp). |
--vnic-type <vnic-type> | Vnic type for this port (direct |
direct-physical | macvtap |
normal | baremetal |
virtio-forwarder, default: normal) | --host <host-id> |
Allocate port on host <host-id> (id only) | --dns-domain dns-domain |
Set dns domain to this port (requires dns_domain extension for ports) | --dns-name <dns-name> |
Set dns name for this port (requires dns integration extension) | --fixed-ip subnet=<subnet>,ip-address=<ip-address> |
Desired ip and/or subnet for this port (name or id): subnet=<subnet>,ip-address=<ip-address> (repeat option to set multiple fixed IP addresses) | --no-fixed-ip |
No ip or subnet for this port. | --binding-profile <binding-profile> |
Custom data to be passed as binding:profile. data may be passed as <key>=<value> or JSON. (repeat option to set multiple binding:profile data) | --enable |
Enable port (default) | --disable |
Disable port | --enable-uplink-status-propagation |
Enable uplink status propagate | --disable-uplink-status-propagation |
Disable uplink status propagate (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. | --extra-dhcp-option name=<name>[,value=<value>,ip-version={4,6}] |
Extra dhcp options to be assigned to this port: name=<name>[,value=<value>,ip-version={4,6}] (repeat option to set multiple extra DHCP options) | --security-group <security-group> |
Security group to associate with this port (name or ID) (repeat option to set multiple security groups) | --no-security-group |
Associate no security groups with this port | --qos-policy <qos-policy> |
Attach qos policy to this port (name or id) | --enable-port-security |
Enable port security for this port (default) | --disable-port-security |
Disable port security for this port | --allowed-address ip-address=<ip-address>[,mac-address=<mac-address>] |
Add allowed-address pair associated with this port: ip-address=<ip-address>[,mac-address=<mac-address>] (repeat option to set multiple allowed-address pairs) | --tag <tag> |
Tag to be added to the port (repeat option to set multiple tags) | --no-tag |
Value | Summary |
---|---|
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
59.2. port delete
Delete port(s)
Usage:
openstack port delete [-h] <port> [<port> ...]
Value | Summary |
---|---|
<port> | Port(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
59.3. port list
List ports
Usage:
openstack port 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] [--device-owner <device-owner>] [--network <network>] [--router <router> | --server <server> | --device-id <device-id>] [--mac-address <mac-address>] [--long] [--project <project>] [--project-domain <project-domain>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>] [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--device-owner <device-owner> | List only ports with the specified device owner. this is the entity that uses the port (for example, network:dhcp). |
--network <network> | List only ports connected to this network (name or id) |
--router <router> | List only ports attached to this router (name or id) |
--server <server> | List only ports attached to this server (name or id) |
--device-id <device-id> | List only ports with the specified device id |
--mac-address <mac-address> | List only ports with this mac address |
--long | List additional fields in output |
--project <project> | List ports 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. |
--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring> | Desired ip and/or subnet for filtering ports (name or ID): subnet=<subnet>,ip-address=<ip-address>,ip- substring=<ip-substring> (repeat option to set multiple fixed IP addresses) |
--tags <tag>[,<tag>,…] | List ports which have all given tag(s) (comma- separated list of tags) |
--any-tags <tag>[,<tag>,…] | List ports which have any given tag(s) (comma- separated list of tags) |
--not-tags <tag>[,<tag>,…] | Exclude ports which have all given tag(s) (comma- separated list of tags) |
--not-any-tags <tag>[,<tag>,…] | Exclude ports which have any given tag(s) (comma- separated list of tags) |
Value | Summary |
---|---|
-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
59.4. port set
Set port properties
Usage:
openstack port set [-h] [--description <description>] [--device <device-id>] [--mac-address <mac-address>] [--device-owner <device-owner>] [--vnic-type <vnic-type>] [--host <host-id>] [--dns-domain dns-domain] [--dns-name <dns-name>] [--enable | --disable] [--name <name>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>] [--no-fixed-ip] [--binding-profile <binding-profile>] [--no-binding-profile] [--qos-policy <qos-policy>] [--security-group <security-group>] [--no-security-group] [--enable-port-security | --disable-port-security] [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]] [--no-allowed-address] [--data-plane-status <status>] [--tag <tag>] [--no-tag] <port>
Value | Summary |
---|---|
<port> | Port to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of this port |
--device <device-id> | Port device id |
--mac-address <mac-address> | Mac address of this port (admin only) |
--device-owner <device-owner> | Device owner of this port. this is the entity that uses the port (for example, network:dhcp). |
--vnic-type <vnic-type> | Vnic type for this port (direct |
direct-physical | macvtap |
normal | baremetal |
virtio-forwarder, default: normal) | --host <host-id> |
Allocate port on host <host-id> (id only) | --dns-domain dns-domain |
Set dns domain to this port (requires dns_domain extension for ports) | --dns-name <dns-name> |
Set dns name for this port (requires dns integration extension) | --enable |
Enable port | --disable |
Disable port | --name <name> |
Set port name | --fixed-ip subnet=<subnet>,ip-address=<ip-address> |
Desired ip and/or subnet for this port (name or id): subnet=<subnet>,ip-address=<ip-address> (repeat option to set multiple fixed IP addresses) | --no-fixed-ip |
Clear existing information of fixed ip addresses.Specify both --fixed-ip and --no-fixed-ip to overwrite the current fixed IP addresses. | --binding-profile <binding-profile> |
Custom data to be passed as binding:profile. data may be passed as <key>=<value> or JSON. (repeat option to set multiple binding:profile data) | --no-binding-profile |
Clear existing information of binding:profile. specify both --binding-profile and --no-binding-profile to overwrite the current binding:profile information. | --qos-policy <qos-policy> |
Attach qos policy to this port (name or id) | --security-group <security-group> |
Security group to associate with this port (name or ID) (repeat option to set multiple security groups) | --no-security-group |
Clear existing security groups associated with this port | --enable-port-security |
Enable port security for this port | --disable-port-security |
Disable port security for this port | --allowed-address ip-address=<ip-address>[,mac-address=<mac-address>] |
Add allowed-address pair associated with this port: ip-address=<ip-address>[,mac-address=<mac-address>] (repeat option to set multiple allowed-address pairs) | --no-allowed-address |
Clear existing allowed-address pairs associated with this port. (Specify both --allowed-address and --no- allowed-address to overwrite the current allowed- address pairs) | --data-plane-status <status> |
Set data plane status of this port (active | down). Unset it to None with the port unset command (requires data plane status extension) |
--tag <tag> | Tag to be added to the port (repeat option to set multiple tags) |
--no-tag | Clear tags associated with the port. specify both --tag and --no-tag to overwrite current tags |
59.5. port show
Display port details
Usage:
openstack port show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <port>
Value | Summary |
---|---|
<port> | Port to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
59.6. port unset
Unset port properties
Usage:
openstack port unset [-h] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>] [--binding-profile <binding-profile-key>] [--security-group <security-group>] [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]] [--qos-policy] [--data-plane-status] [--tag <tag> | --all-tag] <port>
Value | Summary |
---|---|
<port> | Port to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fixed-ip subnet=<subnet>,ip-address=<ip-address> | Desired ip and/or subnet which should be removed from this port (name or ID): subnet=<subnet>,ip- address=<ip-address> (repeat option to unset multiple fixed IP addresses) |
--binding-profile <binding-profile-key> | Desired key which should be removed from binding:profile (repeat option to unset multiple binding:profile data) |
--security-group <security-group> | Security group which should be removed this port (name or ID) (repeat option to unset multiple security groups) |
--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>] | Desired allowed-address pair which should be removed from this port: ip-address=<ip-address>[,mac- address=<mac-address>] (repeat option to unset multiple allowed-address pairs) |
--qos-policy | Remove the qos policy attached to the port |
--data-plane-status | Clear existing information of data plane status |
--tag <tag> | Tag to be removed from the port (repeat option to remove multiple tags) |
--all-tag | Clear all tags associated with the port |