summaryrefslogtreecommitdiff
path: root/api-guide
diff options
context:
space:
mode:
authorBalazs Gibizer <balazs.gibizer@est.tech>2021-05-28 16:49:50 +0200
committerBalazs Gibizer <balazs.gibizer@est.tech>2021-08-21 09:49:54 +0200
commite357ad3c2354f1c22cd5b569a2f0ec23c9c06753 (patch)
tree9e0f4c6671fb9e22892fc43f6cda7dbfdd912c0b /api-guide
parent017b0a3d2332b1d3d20c2aa51ae9605f6c7676ee (diff)
downloadnova-e357ad3c2354f1c22cd5b569a2f0ec23c9c06753.tar.gz
Reject server create with extended resource req
To prepare for the unlikely event that Neutron merges and an operator enables the port-resource-request-groups neutron API extension before nova adds support for it, this patch rejects server creation if such extension is enabled in Neutron. Enabling that extension has zero benefits without nova support hence the harsh but simple rejection. A subsequent patch will reject server lifecycle operations in a more sophisticated way and as soon as we support some operations, like boot, the deployer might rightfully choose to enable the Neutron extension. Change-Id: I2c55d9da13a570efbc1c862116cea31aaa6aa02e blueprint: qos-minimum-guaranteed-packet-rate
Diffstat (limited to 'api-guide')
-rw-r--r--api-guide/source/port_with_resource_request.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/api-guide/source/port_with_resource_request.rst b/api-guide/source/port_with_resource_request.rst
index bab2962537..868ec33a97 100644
--- a/api-guide/source/port_with_resource_request.rst
+++ b/api-guide/source/port_with_resource_request.rst
@@ -39,5 +39,15 @@ servers with neutron ports having resource requests.
As of 23.0.0 (Wallaby), nova supports attaching neutron ports having QoS
minimum bandwidth rules.
+Extended resource request
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since neutron 19.0.0 (Xena), neutron implements an extended resource request
+format via the the ``port-resource-request-groups`` neutron API extension. As
+of nova 24.0.0 (Xena), nova does not support the new extension. If the
+extension is enabled in neutron, then nova will reject server create and move
+operations, as well as interface attach operation. Admins should not enable
+this API extension in neutron.
+
See :nova-doc:`the admin guide <admin/port_with_resource_request.html>` for
administrative details.