openstack/neutron
Code Issues Proposed changes

Add auto-allocated-topology delete example to docs

Browse Source 
There was not an example of how to delete an auto
allocated topology (get me a network), so add one.
Only a partial fix as it seems the api-ref doc in
neutron-lib is incorrect as there is only create and
delete operations on this resource, not show.

Change-Id: Iaa797b7e0c1c9bac25ff00659a74286173297206
Partial-bug: #1617548
This commit is contained in:
Brian Haley
2023-01-13 17:42:34 -05:00
parent e44a8e9ae4
commit d0e64c6617
1 changed files with 10 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
doc/source/admin/config-auto-allocation.rst
View File

@@ -131,7 +131,7 @@ Get Me A Network
---------------- ----------------
In a deployment where the operator has set up the resources as described above, In a deployment where the operator has set up the resources as described above,
they can get their auto-allocated network topology as follows: they can get or create their auto-allocated network topology as follows:
.. code-block:: console .. code-block:: console
@@ -140,17 +140,16 @@ they can get their auto-allocated network topology as follows:
| Field | Value | | Field | Value |
+------------+--------------------------------------+ +------------+--------------------------------------+
| id | a380c780-d6cd-4510-a4c0-1a6ec9b85a29 | | id | a380c780-d6cd-4510-a4c0-1a6ec9b85a29 |
| name | None |
| project_id | cfd1889ac7d64ad891d4f20aef9f8d7c | | project_id | cfd1889ac7d64ad891d4f20aef9f8d7c |
+------------+--------------------------------------+ +------------+--------------------------------------+
.. note:: .. note::
When the ``--or-show`` option is used the command returns the topology When the ``--or-show`` option is used the command returns the topology
information if it already exists. information if it already exists, or creates it if it does not.
Operators (and users with admin role) can get the auto-allocated topology for a Operators (and users with admin role) can get or create the auto-allocated
project by specifying the project ID: topology for a project by specifying the project ID:
.. code-block:: console .. code-block:: console
@@ -160,7 +159,6 @@ project by specifying the project ID:
| Field | Value | | Field | Value |
+------------+--------------------------------------+ +------------+--------------------------------------+
| id | a380c780-d6cd-4510-a4c0-1a6ec9b85a29 | | id | a380c780-d6cd-4510-a4c0-1a6ec9b85a29 |
| name | None |
| project_id | cfd1889ac7d64ad891d4f20aef9f8d7c | | project_id | cfd1889ac7d64ad891d4f20aef9f8d7c |
+------------+--------------------------------------+ +------------+--------------------------------------+
@@ -179,6 +177,12 @@ network available, the Compute service will invoke the API behind
``auto allocated topology create``, fetch the network UUID, and pass it on ``auto allocated topology create``, fetch the network UUID, and pass it on
during the boot process. during the boot process.
Alternately one can delete their auto-allocated network topology as follows:
.. code-block:: console
$ openstack network auto allocated topology delete
Validating the requirements for auto-allocation Validating the requirements for auto-allocation
----------------------------------------------- -----------------------------------------------