neutron port-update <subnet-uuid>

[Xav Paice]

in http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html#section_allowed_address_pairs

neutron port-update <subnet-uuid> --allowed-address-pairs type=dict list=true mac_address=<mac_address>,ip_address=<ip_cidr>

should read

neutron port-update <port-uuid> --allowed-address-pairs type=dict list=true mac_address=<mac_address>,ip_address=<ip_cidr>

-----------------------------------
Built: 2014-01-22T22:16:36 00:00
git SHA: 9a330eb0c2b14e7737f2b8484c39466d13e63aea
URL: http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/68542

[ZhiQiang Fan (aji-zqfan)]

It is strange that master branch of python-neutronclient doesn't have --allowed-address-pairs parameter in both port-create and port-update

(py27)zqfan@openstack-dev:~/openstack/python-neutronclient$ neutron help port-update
usage: neutron port-update [-h] [--request-format {json,xml}]
                           [--security-group SECURITY_GROUP | --no-security-groups]
                           [--extra-dhcp-opt EXTRA_DHCP_OPTS]
                           PORT

Update port's information.

positional arguments:
  PORT ID or name of port to update

optional arguments:
  -h, --help show this help message and exit
  --request-format {json,xml}
                        The xml or json request format
  --security-group SECURITY_GROUP
                        Security group associated with the port (This option
                        can be repeated)
  --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_name=<dhcp_option_name>,opt_value=<value>, (This
                        option can be repeated.)
(py27)zqfan@openstack-dev:~/openstack/python-neutronclient$ neutron help port-create
usage: neutron port-create [-h] [-f {html,json,shell,table,yaml}] [-c COLUMN]
                           [--variable VARIABLE] [--prefix PREFIX]
                           [--request-format {json,xml}]
                           [--tenant-id TENANT_ID] [--name NAME]
                           [--admin-state-down] [--mac-address MAC_ADDRESS]
                           [--device-id DEVICE_ID]
                           [--fixed-ip ip_address=IP_ADDR]
                           [--security-group SECURITY_GROUP | --no-security-groups]
                           [--extra-dhcp-opt EXTRA_DHCP_OPTS]
                           NETWORK

Create a port for a given tenant.

positional arguments:
  NETWORK Network id or name this port belongs to

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
  --name NAME Name of this port
  --admin-state-down Set admin state up to false
  --mac-address MAC_ADDRESS
                        MAC address of this port
  --device-id DEVICE_ID
                        Device id of this port
  --fixed-ip ip_address=IP_ADDR
                        Desired IP for this port:
                        subnet_id=<name_or_id>,ip_address=<ip>, (This option
                        can be repeated.)
  --security-group SECURITY_GROUP
                        Security group associated with the port (This option
                        can be repeated)
  --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_name=<dhcp_option_name>,opt_value=<value>, (This
                        option can be repeated.)

output formatters:
  output formatter options

  ...

[Xav Paice (xavpaice)]

agreed it's missing from the help also - that would be a python-neutronclient code fix rather than a quick fix to the manual - should I do that on this bug or open a separate one?

The code is merged https://review.openstack.org/#/c/38230/ from blueprint https://blueprints.launchpad.net/neutron/+spec/allowed-address-pairs but I can't immediately see where the client got edited.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/68542
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=a3c476b365fee4e6a345e2e66bc56d1906d1e04c
Submitter: Jenkins
Branch: master

commit a3c476b365fee4e6a345e2e66bc56d1906d1e04c
Author: Xav Paice <email address hidden>
Date: Thu Jan 23 15:26:07 2014 +1300

    Fix incorrect sample of neutron port-update

    neutron port-update requires positional argument <port-uuid>
    instead of <subnet-uuid>

    Change-Id: Ibf7f37ee88ff218958a39da804deee0ec0f195b3
    Closes-Bug: 1271788

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.