From f9bfb72a1c0c0aff48ce20fc60ec37a92361db4b Mon Sep 17 00:00:00 2001 From: Matt Riedemann Date: Thu, 29 Dec 2016 16:44:22 -0500 Subject: [PATCH] api-ref: add notes about POST/DELETE errors for os-tenant-networks After microversion 2.35 all of the os-tenant-networks methods will return a 404 response. However, before that, if using neutron: - POST will return a 503 error because the NotImplementedError is caught and translated to the 503. - DELETE will return a 500 error because the NotImplementedError is NOT caught so results in a 500. The API reference only noted that the API is deprecated since the 2.36 microversion but doesn't note that POST and DELETE are not implemented, so this adds those details for unsuspecting victims. Change-Id: I7f256a4c1a6e4247698fcb5ee7c56128c517e29b Closes-Bug: #1652252 --- api-ref/source/os-tenant-network.inc | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/api-ref/source/os-tenant-network.inc b/api-ref/source/os-tenant-network.inc index a9883bb000ce..eb296e6cc2c8 100644 --- a/api-ref/source/os-tenant-network.inc +++ b/api-ref/source/os-tenant-network.inc @@ -45,6 +45,11 @@ Create Project Network .. rest_method:: POST /os-tenant-networks +.. note:: + This API is only implemented for the nova-network service and will result + in a 503 error response if the cloud is using the Neutron networking + service. Use the Neutron ``networks`` API to create a new network. + Creates a project network. Policy defaults enable only users with the administrative role to @@ -104,6 +109,11 @@ Delete Project Network .. rest_method:: DELETE /os-tenant-networks/{network_id} +.. note:: + This API is only implemented for the nova-network service and will result + in a 500 error response if the cloud is using the Neutron networking + service. Use the Neutron ``networks`` API to delete an existing network. + Deletes a project network. Policy defaults enable only users with the administrative role or