f1eb10f4e4
Since we were introduced microversion in Ussuri [1], that if we need to add a microversion for an API we should mark it as min_version and/or max_version, so we should maintain these parameters with a list in the docs, it will be clearer and friendly for users. [1]https://specs.openstack.org/openstack/cyborg-specs/specs/ussuri/implemented/api-microversion.html Co-Authored-By: Brin Zhang <zhangbailin@inspur.com> Closes-Bug: #1927057 Change-Id: I25b3de9b37e1b8769f8f34783b62bb56d176c931
73 lines
1.6 KiB
ReStructuredText
73 lines
1.6 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:body_verification
|
|
|
|
Devices
|
|
+++++++
|
|
|
|
Lists, shows details for devices.
|
|
|
|
A `device` represent a physical card like FPGA card or GPU card.
|
|
|
|
List Devices
|
|
------------
|
|
|
|
.. rest_method:: GET /v2/devices
|
|
|
|
Lists UUIDs, names, type and more informations for all devices.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
=======
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- type: device_type
|
|
- vendor: device_vendor
|
|
- hostname: hostname
|
|
- filters: device_filters
|
|
|
|
Response
|
|
========
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- devices: devices
|
|
- uuid: device_uuid_resp
|
|
- type: device_type_resp
|
|
- vendor: device_vendor_resp
|
|
- model: device_model_resp
|
|
- std_board_info: device_std_board_info_resp
|
|
- vendor_board_info: device_vendor_board_info_resp
|
|
- hostname: hostname_resp
|
|
- created_at: created
|
|
- updated_at: updated
|
|
- links: links
|
|
|
|
**Example response: list all devices**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/devices/devices-list-resp.json
|
|
:language: javascript
|
|
|
|
Get One Device
|
|
--------------
|
|
|
|
.. rest_method:: GET /v2/devices/{device_uuid}
|
|
|
|
Gets the UUID, name, type and more informations for one device with the specified UUID.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
=======
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- device_uuid: device_uuid
|
|
|
|
**Example response: show details of a specific device**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/devices/devices-getone-resp.json
|
|
:language: javascript
|