← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1352950] Re: os-interface create API docs are wrong

 

** No longer affects: nova

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Compute (nova).
https://bugs.launchpad.net/bugs/1352950

Title:
  os-interface create API docs are wrong

Status in OpenStack API documentation site:
  Confirmed

Bug description:
  Was looking at bug 1338551 and the API docs for the attach_interface
  create method:

  http://docs.openstack.org/api/openstack-compute/2/content/POST_os-
  interface-
  v2_createAttachInterface__v2__tenant_id__servers__server_id__os-
  interface_ext-os-interface.html

  The API docs say that port_id is required in the request but it's
  actually optional:

  http://git.openstack.org/cgit/openstack/nova/tree/nova/api/openstack/compute/contrib/attach_interfaces.py#n80

  You can send in port_id/net_id/fixed_ips, net_id and port_id are
  mutually exclusive, and requesting a specific fixed_ip without a
  net_id is a 400 BadRequest also.

  If the port_id isn't provided, the network API will allocate one on
  the given network.  If net_id isn't provided, the network associated
  with the instance in the network info cache will be used.

  The API docs also don't list any error codes, of which there are 400,
  404, 409, 500, and 501 (because nova-network doesn't implement this
  API).

To manage notifications about this bug go to:
https://bugs.launchpad.net/openstack-api-site/+bug/1352950/+subscriptions


References