network

A network is an isolated Layer 2 networking segment. There are two types of networks, project and provider networks. Project networks are fully isolated and are not shared with other projects. Provider networks map to existing physical networks in the data center and provide external network access for servers and other resources. Only an OpenStack administrator can create provider networks. Networks can be connected via routers.

Compute v2, Network v2

network create

Create new network

os network create
    [--project <project> [--project-domain <project-domain>]]
    [--enable | --disable]
    [--share | --no-share]
    [--description <description>]
    [--availability-zone-hint <availability-zone>]
    [--enable-port-security | --disable-port-security]
    [--external [--default | --no-default] | --internal]
    [--provider-network-type <provider-network-type>]
    [--provider-physical-network <provider-physical-network>]
    [--provider-segment <provider-segment>]
    [--transparent-vlan | --no-transparent-vlan]
    <name>
--project <project>

Owner’s project (name or ID)

Network version 2 only

--project-domain <project-domain>

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

Network version 2 only

--enable

Enable network (default)

Network version 2 only

--disable

Disable network

Network version 2 only

--share

Share the network between projects

--no-share

Do not share the network between projects

--description <description>

Set network description

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

Network version 2 only

--enable-port-security

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

Network version 2 only

--disable-port-security

Disable port security by default for ports created on this network

Network version 2 only

--subnet <subnet>

IPv4 subnet for fixed IPs (in CIDR notation)

Compute version 2 only

--external

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

Network version 2 only

--internal

Set this network as an internal network (default)

Network version 2 only

--default

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

Network version 2 only

--no-default

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

Network version 2 only

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

The physical mechanism by which the virtual network is implemented. The supported options are: flat, geneve, gre, local, vlan, vxlan.

Network version 2 only

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

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

Network version 2 only

--provider-segment <provider-segment>

VLAN ID for VLAN networks or Tunnel ID for GENEVE/GRE/VXLAN networks

Network version 2 only

--transparent-vlan

Make the network VLAN transparent

Network version 2 only

--no-transparent-vlan

Do not make the network VLAN transparent

Network version 2 only

<name>

New network name

network delete

Delete network(s)

os network delete
    <network> [<network> ...]
<network>

Network(s) to delete (name or ID)

network list

List networks

os network list
    [--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>]
--external

List external networks

Network version 2 only

--internal

List internal networks

Network version 2 only

--long

List additional fields in output

Network version 2 only

--name <name>

List networks according to their name

Network version 2 only

--enable

List enabled networks

Network version 2 only

--disable

List disabled networks

Network version 2 only

--project <project>

List networks according to their project (name or ID)

Network version 2 only

--project-domain <project-domain>

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

Network version 2 only

--share

List networks shared between projects

Network version 2 only

--no-share

List networks not shared between projects

Network version 2 only

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

Network version 2 only

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

List networks according to name of the physical network

Network version 2 only

--provider-segment <provider-segment>

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

Network version 2 only

network set

Set network properties

Network version 2 only

os network set
    [--name <name>]
    [--enable | --disable]
    [--share | --no-share]
    [--description <description>]
    [--enable-port-security | --disable-port-security]
    [--external [--default | --no-default] | --internal]
    [--provider-network-type <provider-network-type>]
    [--provider-physical-network <provider-physical-network>]
    [--provider-segment <provider-segment>]
    [--transparent-vlan | --no-transparent-vlan]
    <network>
--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

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

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

The physical mechanism by which the virtual network is implemented. The supported options are: flat, 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 GRE/VXLAN networks

--transparent-vlan

Make the network VLAN transparent

--no-transparent-vlan

Do not make the network VLAN transparent

<network>

Network to modify (name or ID)

network show

Display network details

os network show
    <network>
<network>

Network to display (name or ID)