2016-05-07 17:18:15 +02:00
|
|
|
.. -*- rst -*-
|
|
|
|
|
|
|
|
========
|
|
|
|
Services
|
|
|
|
========
|
|
|
|
|
|
|
|
These APIs help in interacting with the Shared File Systems services,
|
|
|
|
``manila-scheduler``, ``manila-share`` and ``manila-data``.
|
|
|
|
|
|
|
|
.. important::
|
|
|
|
|
2017-01-04 13:40:52 +07:00
|
|
|
For API versions 2.6 and prior, replace ``services`` in the URLs
|
2016-05-07 17:18:15 +02:00
|
|
|
with ``os-services``.
|
|
|
|
|
|
|
|
|
|
|
|
List services
|
|
|
|
=============
|
|
|
|
|
2021-02-03 11:16:51 -08:00
|
|
|
.. rest_method:: GET /v2/services?host={host}&binary={binary}&zone={zone}&state={state}&status={status}
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Lists all services optionally filtered with the specified search options.
|
|
|
|
|
2018-08-15 17:02:01 +08:00
|
|
|
Response codes
|
|
|
|
--------------
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2018-12-07 19:55:30 +01:00
|
|
|
- project_id: project_id_path
|
2016-09-12 14:56:55 +07:00
|
|
|
- host: service_host_query
|
|
|
|
- binary: service_binary_query
|
|
|
|
- zone: service_zone_query
|
|
|
|
- state: service_state_query
|
|
|
|
- status: service_status_query
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Response parameters
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- services: services
|
2016-09-12 14:56:55 +07:00
|
|
|
- id: service_id_response
|
|
|
|
- status: service_status_response
|
|
|
|
- binary: service_binary_response
|
|
|
|
- zone: service_zone_response
|
|
|
|
- host: service_host_response
|
|
|
|
- state: service_state_response
|
2019-03-28 14:56:08 -07:00
|
|
|
- updated_at: updated_at
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Response example
|
|
|
|
----------------
|
|
|
|
|
|
|
|
.. literalinclude:: samples/services-list-response.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
|
|
Enable service
|
|
|
|
==============
|
|
|
|
|
2021-02-03 11:16:51 -08:00
|
|
|
.. rest_method:: PUT /v2/services/enable
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Enables a service.
|
|
|
|
|
2018-08-15 17:02:01 +08:00
|
|
|
Response codes
|
|
|
|
--------------
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2018-12-07 19:55:30 +01:00
|
|
|
- project_id: project_id_path
|
2016-09-12 14:56:55 +07:00
|
|
|
- binary: service_enable_binary_request
|
|
|
|
- host: service_enable_host_request
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Request example
|
|
|
|
---------------
|
|
|
|
|
|
|
|
.. literalinclude:: samples/service-enable-request.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response parameters
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-12 14:56:55 +07:00
|
|
|
- host: service_enable_host_response
|
|
|
|
- binary: service_binary_response
|
|
|
|
- disabled: service_disabled_response
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Response example
|
|
|
|
----------------
|
|
|
|
|
|
|
|
.. literalinclude:: samples/service-enable-response.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
|
|
Disable service
|
|
|
|
===============
|
|
|
|
|
2021-02-03 11:16:51 -08:00
|
|
|
.. rest_method:: PUT /v2/services/disable
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Disables a service.
|
|
|
|
|
2018-08-15 17:02:01 +08:00
|
|
|
Response codes
|
|
|
|
--------------
|
|
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
|
|
|
|
- 200
|
|
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
|
|
|
|
- 400
|
|
|
|
- 401
|
|
|
|
- 403
|
|
|
|
- 404
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2018-12-07 19:55:30 +01:00
|
|
|
- project_id: project_id_path
|
2016-09-12 14:56:55 +07:00
|
|
|
- binary: service_disable_binary_request
|
|
|
|
- host: service_disable_host_request
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Request example
|
|
|
|
---------------
|
|
|
|
|
|
|
|
.. literalinclude:: samples/service-disable-request.json
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
Response parameters
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-09-12 14:56:55 +07:00
|
|
|
- host: service_disable_host_response
|
|
|
|
- binary: service_disable_binary_response
|
|
|
|
- disabled: service_disabled_response
|
2016-05-07 17:18:15 +02:00
|
|
|
|
|
|
|
Response example
|
|
|
|
----------------
|
|
|
|
|
|
|
|
.. literalinclude:: samples/service-disable-response.json
|
|
|
|
:language: javascript
|