Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

8.164. neutron port-create

usage: neutron port-create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
                           [--max-width <integer>] [--noindent]
                           [--prefix PREFIX] [--request-format {json}]
                           [--tenant-id TENANT_ID] [--name NAME]
                           [--description DESCRIPTION]
                           [--fixed-ip subnet_id=SUBNET,ip_address=IP_ADDR]
                           [--device-id DEVICE_ID]
                           [--device-owner DEVICE_OWNER] [--admin-state-down]
                           [--mac-address MAC_ADDRESS]
                           [--vnic-type <direct | direct-physical | macvtap | normal | baremetal>]
                           [--binding-profile BINDING_PROFILE]
                           [--security-group SECURITY_GROUP | --no-security-groups]
                           [--extra-dhcp-opt EXTRA_DHCP_OPTS]
                           [--qos-policy QOS_POLICY]
                           [--allowed-address-pair ip_address=IP_ADDR[,mac_address=MAC_ADDR]
                           | --no-allowed-address-pairs] [--dns-name DNS_NAME]
                           NETWORK
Copy to Clipboard Toggle word wrap
Create a port for a given tenant.

Positional arguments

NETWORK


        ID or name of the network this port belongs to.

Optional arguments

-h, --help


        show this help message and exit

--request-format {json}


      DEPRECATED! Only JSON request format is supported.

--tenant-id TENANT_ID


      The owner tenant ID.

--name NAME


        Name of this port.

--description DESCRIPTION


      Description of this port.

--fixed-ip


        subnet_id=SUBNET,ip_address=IP_ADDR
      Desired IP and/or subnet for this port:
      subnet_id=<name_or_id>,ip_address=<ip>. You can repeat
      this option.

--device-id DEVICE_ID


      Device ID of this port.

--device-owner DEVICE_OWNER


      Device owner of this port.

--admin-state-down


        Set admin state up to false.

--mac-address MAC_ADDRESS


      MAC address of this port.

--vnic-type <direct | direct-physical | macvtap | normal | baremetal>


      VNIC type for this port.

--binding-profile BINDING_PROFILE


      Custom data to be passed as binding:profile.

--security-group SECURITY_GROUP


      Security group associated with the port. You can
      repeat this option.

--no-security-groups


        Associate no security groups with the port.

--extra-dhcp-opt EXTRA_DHCP_OPTS


      Extra dhcp options to be assigned to this port: opt_na
      me=<dhcp_option_name>,opt_value=<value>,ip_version={4,
      6}. You can repeat this option.

--qos-policy QOS_POLICY


      ID or name of the QoS policy that shouldbe attached to
      the resource.

--allowed-address-pair


        ip_address=IP_ADDR[,mac_address=MAC_ADDR]
      Allowed address pair associated with the port. You can
      repeat this option.

--no-allowed-address-pairs


      Associate no allowed address pairs with the port.

--dns-name DNS_NAME


        Assign DNS name to the port (requires DNS integration
      extension)

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

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

Making open source more inclusive

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

About Red Hat

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

Theme

© 2026 Red Hat