Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

8.222. neutron subnet-create

usage: neutron subnet-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]
                             [--gateway GATEWAY_IP | --no-gateway]
                             [--allocation-pool start=IP_ADDR,end=IP_ADDR]
                             [--host-route destination=CIDR,nexthop=IP_ADDR]
                             [--dns-nameserver DNS_NAMESERVER]
                             [--disable-dhcp] [--enable-dhcp]
                             [--ip-version {4,6}]
                             [--ipv6-ra-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}]
                             [--ipv6-address-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}]
                             [--subnetpool SUBNETPOOL]
                             [--use-default-subnetpool]
                             [--prefixlen PREFIX_LENGTH] [--segment SEGMENT]
                             NETWORK [CIDR]
Copy to Clipboard Toggle word wrap
Create a subnet for a given tenant.

Positional arguments

NETWORK


        Network ID or name this subnet belongs to.

CIDR


        CIDR of subnet to create.

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

--description DESCRIPTION


      Description of this subnet.

--gateway GATEWAY_IP


        Gateway IP of this subnet.

--no-gateway


        Do not configure a gateway for this subnet.

--allocation-pool


        start=IP_ADDR,end=IP_ADDR
      Allocation pool IP addresses for this subnet (This
      option can be repeated).

--host-route


        destination=CIDR,nexthop=IP_ADDR
      Additional route (This option can be repeated).

--dns-nameserver DNS_NAMESERVER


      DNS name server for this subnet (This option can be
      repeated).

--disable-dhcp


        Disable DHCP for this subnet.

--enable-dhcp


        Enable DHCP for this subnet.

--ip-version {4,6} IP


        version to use, default is 4. Note that when
      subnetpool is specified, IP version is determined from
      the subnetpool and this option is ignored.

--ipv6-ra-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}


      IPv6 RA (Router Advertisement) mode.

--ipv6-address-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}


      IPv6 address mode.

--subnetpool SUBNETPOOL


      ID or name of subnetpool from which this subnet will
      obtain a CIDR.

--use-default-subnetpool


      Use default subnetpool for ip_version, if it exists.

--prefixlen PREFIX_LENGTH


      Prefix length for subnet allocation from subnetpool.

--segment SEGMENT ID


        of segment with which this subnet will be
      associated.

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 HatBack to top