Documentation for bandwidth support

blueprint: bandwidth-resource-provider
Depends-On: https://review.openstack.org/#/c/640390
Depends-On: https://review.openstack.org/#/c/621494

Change-Id: I166787e092e16857d20f89fba965be2a5509fb4b

api-guide/source/conf.py

@@ -286,4 +286,6 @@ pdf_documents = [
 
 openstack_projects = [
     'nova',
+    'neutron',
+    'placement',
 ]

api-guide/source/index.rst

@@ -86,6 +86,7 @@ Contents
     polling_changes
     request_and_response_formats
     down_cells
+    port_with_resource_request
 
 .. toctree::
     :hidden:

api-guide/source/port_with_resource_request.rst

@@ -0,0 +1,26 @@
+=================================
+Using ports with resource request
+=================================
+
+Starting from microversion 2.72 nova supports creating servers with neutron
+ports having resource request visible as a admin-only port attribute
+``resource_request``. For example a neutron port has resource request if it has
+a QoS minimum bandwidth rule attached. Deleting such servers or detaching such
+ports works since Stein version of nova without requiring any specific
+microversion.
+
+However the following API operations are still not supported in nova:
+
+* Creating servers with neutron networks having QoS minimum bandwidth rule is
+  not supported. The user needs to pre-create the port in that neutron network
+  and create the server with the pre-created port.
+
+* Attaching Neutron ports and networks having QoS minimum bandwidth rule is not
+  supported.
+
+* Moving (resizing, migrating, live-migrating, evacuating, unshelving after
+  shelve offload) servers with ports having resource request is not yet
+  supported.
+
+See :nova-doc:`the admin guide <admin/port_with_resource_request.html>` for
+administrative details.