Mention that list of e.g. IDs is supported in GET requests

Change-Id: Ia275a8068aad110ff4225d6ac2cbdfa1a877b3e5
Closes-Bug: #1837553
This commit is contained in:
chenxing 2019-07-29 15:30:32 +08:00
parent 60ca196817
commit aaae83acaa

View File

@ -145,6 +145,15 @@ admin_state_up=True and shared=True and named ``foobar`` or ``bizbaz``:
GET /v2.0/networks?name=foobar&name=bizbaz&admin_state_up=True&shared=True GET /v2.0/networks?name=foobar&name=bizbaz&admin_state_up=True&shared=True
List of resources is supported in GET requests. For example, if you want the
information of two specific ports that ``id`` is ``port_id_A`` or ``port_id_B``:
.. code::
GET /v2.0/ports?id=port_id_A&id=port_id_B
It treats ID filters as list and return ports with those 2 IDs.
Starting from Rocky release, the Networking API might support filtering Starting from Rocky release, the Networking API might support filtering
attributes with empty value. For example, the request below lists all ports attributes with empty value. For example, the request below lists all ports
that have ``device_id`` attribute with empty value (which are unbound ports). that have ``device_id`` attribute with empty value (which are unbound ports).