3ba8311f6f
As part of an effort to scrub the nova docs of cells v1 references [1] this moves the os-cells API reference to be grouped with the other deprecated APIs. A section title is added, similar to the "Obsolete APIs" section, for organizational purposes. It should be noted that the os-cells APIs have not been formally deprecated by capping them at some maximum microversion like the other deprecated proxy APIs or for the nova-network APIs, but cells v1 was deprecated in Pike [2] and since the os-cells APIs are admin-only, they can be considered effectively deprecated with the cells v1 deprecation itself, and when we delete the cells v1 service code the APIs will also be gone like the other Obsolete APIs. [1] http://lists.openstack.org/pipermail/openstack-discuss/2019-February/002569.html [2] I1a173f7ce0715e684850e030c358e8175fa8724c Change-Id: I833d2e8d8857448c2922df488ae9d9b425050ddc
180 lines
3.4 KiB
ReStructuredText
180 lines
3.4 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:parameter_verification
|
|
.. needs:example_verification
|
|
.. needs:body_verification
|
|
|
|
|
|
==============================
|
|
Cells (os-cells, capacities)
|
|
==============================
|
|
|
|
Adds neighbor cells, lists neighbor cells, and shows the capabilities of
|
|
the local cell. By default, only administrators can manage cells.
|
|
|
|
.. warning:: These APIs refer to a Cells v1 deployment which was deprecated
|
|
in the 16.0.0 Pike release. These are not used with Cells v2
|
|
which is required beginning with the 15.0.0 Ocata release where all Nova
|
|
deployments consist of at least one Cells v2 cell.
|
|
|
|
List Cells
|
|
==========
|
|
|
|
.. rest_method:: GET /os-cells
|
|
|
|
Lists cells.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
NotImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- tenant_id: tenant_id
|
|
- limit: limit_simple
|
|
- offset: offset_simple
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example List Cells: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-cells/cells-list-resp.json
|
|
:language: javascript
|
|
|
|
Create Cell
|
|
===========
|
|
|
|
.. rest_method:: POST /os-cells
|
|
|
|
Create a new cell.
|
|
|
|
Normal response code: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
NotImplemented(501)
|
|
|
|
Capacities
|
|
==========
|
|
|
|
.. rest_method:: GET /os-cells/capacities
|
|
|
|
Retrieve capacities.
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
NotImplemented(501)
|
|
|
|
List Cells With Details
|
|
=======================
|
|
|
|
.. rest_method:: GET /os-cells/detail
|
|
|
|
Lists cells with details of capabilities.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
NotImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- limit: limit_simple
|
|
- offset: offset_simple
|
|
|
|
Info For This Cell
|
|
==================
|
|
|
|
.. rest_method:: GET /os-cells/info
|
|
|
|
Retrieve info about the current cell.
|
|
|
|
Normal response code: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
NotImplemented(501)
|
|
|
|
Show Cell Data
|
|
==============
|
|
|
|
.. rest_method:: GET /os-cells/{cell_id}
|
|
|
|
Shows data for a cell.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
itemNotFound(404), NotImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- cell_id: cell_id
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example Show Cell Data: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-cells/cells-get-resp.json
|
|
:language: javascript
|
|
|
|
Update a Cell
|
|
=============
|
|
|
|
.. rest_method:: PUT /os-cells/{cell_od}
|
|
|
|
|
|
Update an existing cell.
|
|
|
|
Normal response code: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
itemNotFound(404), NotImplemented(501)
|
|
|
|
Delete a Cell
|
|
=============
|
|
|
|
.. rest_method:: DELETE /os-cells/{cell_id}
|
|
|
|
Remove a cell.
|
|
|
|
Normal response code: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
itemNotFound(404), NotImplemented(501)
|
|
|
|
Show Cell Capacities
|
|
====================
|
|
|
|
.. rest_method:: GET /os-cells/{cell_id}/capacities
|
|
|
|
Shows capacities for a cell.
|
|
|
|
Normal response codes: 200,501
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
itemNotFound(404), NotImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- cell_id: cell_id
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example Show Cell Capacities: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-cells/cells-capacities-resp.json
|
|
:language: javascript
|