2e5a91da72
Rather than our freeform way of listing response codes in our api-ref, we should be using the os-api-ref extension option to get nicely formatted response code listings. https://docs.openstack.org/os-api-ref/latest/usage.html#rest-status-code Change-Id: Iee21f54fe7cf0ea28258966e2d0f8fa2849c83f2
54 lines
1.2 KiB
ReStructuredText
54 lines
1.2 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
Capabilities for storage back ends (capabilities)
|
|
=================================================
|
|
|
|
Shows capabilities for a storage back end.
|
|
|
|
|
|
Show back-end capabilities
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. rest_method:: GET /v2/{project_id}/capabilities/{hostname}
|
|
|
|
Shows capabilities for a storage back end on the host.
|
|
The ``hostname`` takes the form of ``hostname@volume_backend_name``.
|
|
|
|
Response codes
|
|
~~~~~~~~~~~~~~
|
|
|
|
.. rest_status_code:: success ../status.yaml
|
|
|
|
- 200
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id_path
|
|
- hostname: hostname
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- pool_name: pool_name
|
|
- description: description
|
|
- volume_backend_name: volume_backend_name
|
|
- namespace: namespace
|
|
- visibility: visibility
|
|
- driver_version: driver_version
|
|
- vendor_name: vendor_name
|
|
- properties: properties
|
|
- storage_protocol: storage_protocol
|
|
- replication_targets: replication_targets
|
|
- display_name: display_name
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ./samples/backend-capabilities-response.json
|
|
:language: javascript
|