placement/releasenotes/notes/placement-required-traits-on-list-resource-providers-fab11cdb36cd3502.yaml
Eric Fried 77341128a1 rp: GET /resource_providers?required=<traits>
Introduce placement microversion 1.18 with a new ?required=<trait list>
query parameter accepted on the GET /resource_providers API.  Results
are filtered by providers possessing *all* of the specified traits.
Empty/invalid traits result in 400 errors.

Change-Id: I8191c9a390cb02b2a38a3f1c6e29457435994981
blueprint: traits-on-list-resource-providers
2018-02-23 12:08:32 -06:00

13 lines
530 B
YAML

---
features:
- |
Placement API microversion 1.18 adds support for the `required` query
parameter to the `GET /resource_providers` API. It accepts a
comma-separated list of string trait names. When specified, the API
results will be filtered to include only resource providers marked with
all the specified traits. This is in addition to (logical AND) any
filtering based on other query parameters.
Trait names which are empty, do not exist, or are otherwise invalid will
result in a 400 error.