← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1596153] [NEW] Optional argument '--router:external' is absent in the help msg of 'net-create' command.

 

Public bug reported:

In Mitaka,
Optional argument '--router:external' is absent in the help msg of 'net-create' command.

However,'--router:external' argument can be specified when executing
net-create command,it seems that '--router:external' argument is
forgetten in Mitaka release.

[root@localhost devstack]# neutron help net-create
usage: neutron net-create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
                          [--max-width <integer>] [--noindent]
                          [--prefix PREFIX] [--request-format {json}]
                          [--tenant-id TENANT_ID] [--admin-state-down]
                          [--shared] [--provider:network_type <network_type>]
                          [--provider:physical_network <physical_network_name>]
                          [--provider:segmentation_id <segmentation_id>]
                          [--vlan-transparent {True,False}]
                          [--description DESCRIPTION]
                          [--qos-policy QOS_POLICY]
                          [--availability-zone-hint AVAILABILITY_ZONE]
                          [--dns-domain DNS_DOMAIN]
                          NAME

Create a network for a given tenant.

positional arguments:
  NAME                  Name of network 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.
  --admin-state-down    Set admin state up to false.
  --shared              Set the network as shared.
  --provider:network_type <network_type>
                        The physical mechanism by which the virtual network is
                        implemented.
  --provider:physical_network <physical_network_name>
                        Name of the physical network over which the virtual
                        network is implemented.
  --provider:segmentation_id <segmentation_id>
                        VLAN ID for VLAN networks or tunnel-id for GRE/VXLAN
                        networks.
  --vlan-transparent {True,False}
                        Create a vlan transparent network.
  --description DESCRIPTION
                        Description of network.
  --qos-policy QOS_POLICY
                        Attach QoS policy ID or name to the resource.
  --availability-zone-hint AVAILABILITY_ZONE
                        Availability Zone for the network (requires
                        availability zone extension, this option can be
                        repeated).
  --dns-domain DNS_DOMAIN
                        Assign DNS domain to the network (requires DNS
                        integration extension)

output formatters:
  output formatter options

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

json formatter:
  --noindent            whether to disable indenting the JSON

shell formatter:
  a format a UNIX shell can parse (variable="value")

  --prefix PREFIX       add a prefix to all variable names
[root@localhost devstack]#

[root@localhost devstack]# neutron net-create public --shared --router:external
Created a new network:
+---------------------------+--------------------------------------+
| Field                     | Value                                |
+---------------------------+--------------------------------------+
| admin_state_up            | True                                 |
| availability_zone_hints   |                                      |
| availability_zones        |                                      |
| created_at                | 2016-06-24T02:08:06                  |
| description               |                                      |
| id                        | 8fc03cba-36f9-4efa-b40c-d9a478bebea7 |
| ipv4_address_scope        |                                      |
| ipv6_address_scope        |                                      |
| is_default                | False                                |
| mtu                       | 1450                                 |
| name                      | public                               |
| port_security_enabled     | True                                 |
| provider:network_type     | vxlan                                |
| provider:physical_network |                                      |
| provider:segmentation_id  | 1096                                 |
| router:external           | True                                 |
| shared                    | True                                 |
| status                    | ACTIVE                               |
| subnets                   |                                      |
| tags                      |                                      |
| tenant_id                 | 09750873df064238b21cda6ddc7935f4     |
| updated_at                | 2016-06-24T02:08:06                  |
+---------------------------+--------------------------------------+
[root@localhost devstack]#

In Kilo Realese,'--router:external' argument is in the help msg of net-create command.
[root@SBCRRack3Shelf1Slot11 ~(keystone_admin)]# neutron help net-create
usage: neutron net-create [-h] [-f {shell,table,value}] [-c COLUMN]
                          [--max-width <integer>] [--prefix PREFIX]
                          [--request-format {json,xml}]
                          [--tenant-id TENANT_ID] [--admin-state-down]
                          [--shared] [--mtu MTU]
                          [--router:external]
                          [--provider:network_type <network_type>]
                          [--provider:physical_network <physical_network_name>]
                          [--provider:segmentation_id <segmentation_id>]
                          [--vlan-transparent {True,False}]
                          NAME

Create a network for a given tenant.

positional arguments:
  NAME                  Name of network to create.

optional arguments:
  -h, --help            show this help message and exit
  --request-format {json,xml}
                        The XML or JSON request format.
  --tenant-id TENANT_ID
                        The owner tenant ID.
  --admin-state-down    Set admin state up to false.
  --shared              Set the network as shared.
  --mtu MTU             Set the network mtu
  --router:external     Set network as external, it is only available for
                        admin
  --provider:network_type <network_type>
                        The physical mechanism by which the virtual network is
                        implemented.
  --provider:physical_network <physical_network_name>
                        Name of the physical network over which the virtual
                        network is implemented.
  --provider:segmentation_id <segmentation_id>
                        VLAN ID for VLAN networks or tunnel-id for GRE/VXLAN
                        networks.
  --vlan-transparent {True,False}
                        Create a vlan transparent network.

output formatters:
  output formatter options

  -f {shell,table,value}, --format {shell,table,value}
                        the output format, defaults to table
  -c COLUMN, --column COLUMN
                        specify the column(s) to include, can be repeated

table formatter:
  --max-width <integer>
                        Maximum display width, 0 to disable

shell formatter:
  a format a UNIX shell can parse (variable="value")

  --prefix PREFIX       add a prefix to all variable names
[root@SBCRRack3Shelf1Slot11 ~(keystone_admin)]#

** Affects: neutron
     Importance: Undecided
     Assignee: dongwenshuai (dong-wenshuai)
         Status: New

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to neutron.
https://bugs.launchpad.net/bugs/1596153

Title:
  Optional argument '--router:external' is absent in the help msg of
  'net-create' command.

Status in neutron:
  New

Bug description:
  In Mitaka,
  Optional argument '--router:external' is absent in the help msg of 'net-create' command.

  However,'--router:external' argument can be specified when executing
  net-create command,it seems that '--router:external' argument is
  forgetten in Mitaka release.

  [root@localhost devstack]# neutron help net-create
  usage: neutron net-create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
                            [--max-width <integer>] [--noindent]
                            [--prefix PREFIX] [--request-format {json}]
                            [--tenant-id TENANT_ID] [--admin-state-down]
                            [--shared] [--provider:network_type <network_type>]
                            [--provider:physical_network <physical_network_name>]
                            [--provider:segmentation_id <segmentation_id>]
                            [--vlan-transparent {True,False}]
                            [--description DESCRIPTION]
                            [--qos-policy QOS_POLICY]
                            [--availability-zone-hint AVAILABILITY_ZONE]
                            [--dns-domain DNS_DOMAIN]
                            NAME

  Create a network for a given tenant.

  positional arguments:
    NAME                  Name of network 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.
    --admin-state-down    Set admin state up to false.
    --shared              Set the network as shared.
    --provider:network_type <network_type>
                          The physical mechanism by which the virtual network is
                          implemented.
    --provider:physical_network <physical_network_name>
                          Name of the physical network over which the virtual
                          network is implemented.
    --provider:segmentation_id <segmentation_id>
                          VLAN ID for VLAN networks or tunnel-id for GRE/VXLAN
                          networks.
    --vlan-transparent {True,False}
                          Create a vlan transparent network.
    --description DESCRIPTION
                          Description of network.
    --qos-policy QOS_POLICY
                          Attach QoS policy ID or name to the resource.
    --availability-zone-hint AVAILABILITY_ZONE
                          Availability Zone for the network (requires
                          availability zone extension, this option can be
                          repeated).
    --dns-domain DNS_DOMAIN
                          Assign DNS domain to the network (requires DNS
                          integration extension)

  output formatters:
    output formatter options

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

  json formatter:
    --noindent            whether to disable indenting the JSON

  shell formatter:
    a format a UNIX shell can parse (variable="value")

    --prefix PREFIX       add a prefix to all variable names
  [root@localhost devstack]#

  [root@localhost devstack]# neutron net-create public --shared --router:external
  Created a new network:
  +---------------------------+--------------------------------------+
  | Field                     | Value                                |
  +---------------------------+--------------------------------------+
  | admin_state_up            | True                                 |
  | availability_zone_hints   |                                      |
  | availability_zones        |                                      |
  | created_at                | 2016-06-24T02:08:06                  |
  | description               |                                      |
  | id                        | 8fc03cba-36f9-4efa-b40c-d9a478bebea7 |
  | ipv4_address_scope        |                                      |
  | ipv6_address_scope        |                                      |
  | is_default                | False                                |
  | mtu                       | 1450                                 |
  | name                      | public                               |
  | port_security_enabled     | True                                 |
  | provider:network_type     | vxlan                                |
  | provider:physical_network |                                      |
  | provider:segmentation_id  | 1096                                 |
  | router:external           | True                                 |
  | shared                    | True                                 |
  | status                    | ACTIVE                               |
  | subnets                   |                                      |
  | tags                      |                                      |
  | tenant_id                 | 09750873df064238b21cda6ddc7935f4     |
  | updated_at                | 2016-06-24T02:08:06                  |
  +---------------------------+--------------------------------------+
  [root@localhost devstack]#

  In Kilo Realese,'--router:external' argument is in the help msg of net-create command.
  [root@SBCRRack3Shelf1Slot11 ~(keystone_admin)]# neutron help net-create
  usage: neutron net-create [-h] [-f {shell,table,value}] [-c COLUMN]
                            [--max-width <integer>] [--prefix PREFIX]
                            [--request-format {json,xml}]
                            [--tenant-id TENANT_ID] [--admin-state-down]
                            [--shared] [--mtu MTU]
                            [--router:external]
                            [--provider:network_type <network_type>]
                            [--provider:physical_network <physical_network_name>]
                            [--provider:segmentation_id <segmentation_id>]
                            [--vlan-transparent {True,False}]
                            NAME

  Create a network for a given tenant.

  positional arguments:
    NAME                  Name of network to create.

  optional arguments:
    -h, --help            show this help message and exit
    --request-format {json,xml}
                          The XML or JSON request format.
    --tenant-id TENANT_ID
                          The owner tenant ID.
    --admin-state-down    Set admin state up to false.
    --shared              Set the network as shared.
    --mtu MTU             Set the network mtu
    --router:external     Set network as external, it is only available for
                          admin
    --provider:network_type <network_type>
                          The physical mechanism by which the virtual network is
                          implemented.
    --provider:physical_network <physical_network_name>
                          Name of the physical network over which the virtual
                          network is implemented.
    --provider:segmentation_id <segmentation_id>
                          VLAN ID for VLAN networks or tunnel-id for GRE/VXLAN
                          networks.
    --vlan-transparent {True,False}
                          Create a vlan transparent network.

  output formatters:
    output formatter options

    -f {shell,table,value}, --format {shell,table,value}
                          the output format, defaults to table
    -c COLUMN, --column COLUMN
                          specify the column(s) to include, can be repeated

  table formatter:
    --max-width <integer>
                          Maximum display width, 0 to disable

  shell formatter:
    a format a UNIX shell can parse (variable="value")

    --prefix PREFIX       add a prefix to all variable names
  [root@SBCRRack3Shelf1Slot11 ~(keystone_admin)]#

To manage notifications about this bug go to:
https://bugs.launchpad.net/neutron/+bug/1596153/+subscriptions