50657a87df
This change adds missing POST request parameters and makes other minor corrections to the REST API documentation. Its possible that some of the parameters for /v1/nodes were never intended to be available for the POST call, but this docs change is to document what has been implemented, not the original intention. Change-Id: I1e35586d20bd3eda4d727931235340dd408c7508
244 lines
4.2 KiB
ReStructuredText
244 lines
4.2 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
=================
|
|
Chassis (chassis)
|
|
=================
|
|
|
|
The Chassis resource type was originally conceived as a means to group Node
|
|
resources. Support for this continues to exist in the REST API, however, it is
|
|
very minimal. The Chassis object does not provide any functionality today
|
|
aside from a means to list a group of Nodes.
|
|
|
|
Use of this resource is discouraged, and may be deprecated and removed in a
|
|
future release.
|
|
|
|
|
|
List chassis with details
|
|
=========================
|
|
|
|
.. rest_method:: GET /v1/chassis/detail
|
|
|
|
Lists all chassis with details.
|
|
|
|
Normal response codes: 200
|
|
|
|
.. TODO: add error codes
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- limit: limit
|
|
- marker: marker
|
|
- sort_dir: sort_dir
|
|
- sort_key: sort_key
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- uuid: uuid
|
|
- chassis: chassis
|
|
- description: description
|
|
- extra: extra
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/chassis-list-details-response.json
|
|
:language: javascript
|
|
|
|
|
|
Show chassis details
|
|
====================
|
|
|
|
.. rest_method:: GET /v1/chassis/{chassis_id}
|
|
|
|
Shows details for a chassis.
|
|
|
|
Normal response codes: 200
|
|
|
|
.. TODO: add error codes
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- fields: fields
|
|
- chassis_id: chassis_ident
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- uuid: uuid
|
|
- chassis: chassis
|
|
- description: description
|
|
- extra: extra
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/chassis-show-response.json
|
|
:language: javascript
|
|
|
|
|
|
Update chassis
|
|
==============
|
|
|
|
.. rest_method:: PATCH /v1/chassis/{chassis_id}
|
|
|
|
Updates a chassis.
|
|
|
|
Normal response codes: 200
|
|
|
|
.. TODO: add error codes
|
|
|
|
Request
|
|
-------
|
|
|
|
The BODY of the PATCH request must be a JSON PATCH document, adhering to
|
|
`RFC 6902 <https://tools.ietf.org/html/rfc6902>`_.
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- chassis_id: chassis_ident
|
|
- description: req_description
|
|
- extra: req_extra
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/chassis-update-request.json
|
|
:language: javascript
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- links: links
|
|
- extra: extra
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- chassis: chassis
|
|
- nodes: nodes
|
|
- uuid: uuid
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/chassis-update-response.json
|
|
:language: javascript
|
|
|
|
|
|
Delete chassis
|
|
==============
|
|
|
|
.. rest_method:: DELETE /v1/chassis/{chassis_id}
|
|
|
|
Deletes a chassis.
|
|
|
|
.. TODO: add error codes
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- chassis_id: chassis_ident
|
|
|
|
Create chassis
|
|
==============
|
|
|
|
.. rest_method:: POST /v1/chassis
|
|
|
|
Creates a chassis.
|
|
|
|
Error response codes:201,413,415,405,404,403,401,400,503,409,
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- uuid: req_uuid
|
|
- description: req_description
|
|
- extra: req_extra
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/chassis-create-request.json
|
|
:language: javascript
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- links: links
|
|
- extra: extra
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- nodes: nodes
|
|
- uuid: uuid
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/chassis-show-response.json
|
|
:language: javascript
|
|
|
|
List chassis
|
|
============
|
|
|
|
.. rest_method:: GET /v1/chassis
|
|
|
|
Lists all chassis.
|
|
|
|
.. versionadded:: 1.43
|
|
Added the ``detail`` boolean request parameter. When specified ``True`` this
|
|
causes the response to include complete details about each chassis.
|
|
|
|
Normal response codes: 200
|
|
|
|
.. TODO: add error codes
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- limit: limit
|
|
- marker: marker
|
|
- sort_dir: sort_dir
|
|
- sort_key: sort_key
|
|
- fields: fields
|
|
- detail: detail
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- description: description
|
|
- links: links
|
|
- extra: extra
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- nodes: nodes
|
|
- uuid: uuid
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/chassis-list-response.json
|
|
:language: javascript
|