Public bug reported:

While exploring the newer microversions (here 1.4) of the placement API
I found this part of the API reference unclear to me
(https://developer.openstack.org/api-ref/placement/#list-resource-
providers, 'resources' parameter):

"A comma-separated list of strings indicating an amount of resource of a
specified class that a provider must have the capacity to serve:"

Based on the reference I cannot tell if the capacity is meant to be
total or current (ie. total - current allocations).

Running a few queries it seems to me the actual behavior is to filter on
total capacity. If that was the intended behavior then this report is
just a tiny documentation bug I guess.

https://github.com/openstack/nova/blob/17.0.0.0rc1/placement-api-
ref/source/parameters.yaml#L105

** Affects: nova
     Importance: Undecided
         Status: New


** Tags: doc placement

-- 
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/1749410

Title:
  placement api-ref unclear if capacity is meant to be total or current

Status in OpenStack Compute (nova):
  New

Bug description:
  While exploring the newer microversions (here 1.4) of the placement
  API I found this part of the API reference unclear to me
  (https://developer.openstack.org/api-ref/placement/#list-resource-
  providers, 'resources' parameter):

  "A comma-separated list of strings indicating an amount of resource of
  a specified class that a provider must have the capacity to serve:"

  Based on the reference I cannot tell if the capacity is meant to be
  total or current (ie. total - current allocations).

  Running a few queries it seems to me the actual behavior is to filter
  on total capacity. If that was the intended behavior then this report
  is just a tiny documentation bug I guess.

  https://github.com/openstack/nova/blob/17.0.0.0rc1/placement-api-
  ref/source/parameters.yaml#L105

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

-- 
Mailing list: https://launchpad.net/~yahoo-eng-team
Post to     : yahoo-eng-team@lists.launchpad.net
Unsubscribe : https://launchpad.net/~yahoo-eng-team
More help   : https://help.launchpad.net/ListHelp

Reply via email to