You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
71 lines
2.0 KiB
71 lines
2.0 KiB
.. -*- rst -*- |
|
|
|
======= |
|
Project |
|
======= |
|
|
|
These APIs are generic for any cloud as instance ID should be something that can |
|
be matched to virtual machines or containers regardless of the cloud underneath. |
|
|
|
Get project maintenance session |
|
=============================== |
|
|
|
.. rest_method:: GET /v1/maintenance/{session_id}/{project_id}/ |
|
|
|
Get project instances belonging to the current state of maintenance session. |
|
the Project-manager receives an AODH event alarm telling about different |
|
maintenance states. Event data field length is very limited, so instances cannot |
|
be given as a list in the event. Instead, there will be an URL given to below |
|
API to get a project-specific list of instances. |
|
|
|
Request |
|
------- |
|
|
|
.. rest_parameters:: parameters.yaml |
|
|
|
- session_id: uuid-path |
|
- project_id: uuid-path |
|
|
|
Response codes |
|
-------------- |
|
|
|
.. rest_status_code:: success status.yaml |
|
|
|
- 200: get-project-maintenance-session-post |
|
|
|
.. rest_status_code:: error status.yaml |
|
|
|
- 404 |
|
|
|
Input from project to maintenance session |
|
========================================= |
|
|
|
.. rest_method:: PUT /v1/maintenance/{session_id}/{project_id}/ |
|
|
|
Project having instances on top of the infrastructure handled by a maintenance |
|
session might need to make own action for its instances on top of a host going |
|
into maintenance next, or reply an admin action to be done. This is, as the host |
|
can go down or even be removed and the instances should be then running safely |
|
somewhere else. Project manager receives an AODH event alarm telling which |
|
instances are affected and when the project is ready, it makes its own action or |
|
replies back an action which needs the admin privileges. |
|
|
|
Request |
|
------- |
|
|
|
.. rest_parameters:: parameters.yaml |
|
|
|
- session_id: uuid-path |
|
- project_id: uuid-path |
|
- instance_actions: instance-actions |
|
- state: workflow-state-reply |
|
|
|
.. literalinclude:: samples/input-from-project-to-maintenance-session-put.json |
|
:language: javascript |
|
|
|
Response codes |
|
-------------- |
|
|
|
.. rest_status_code:: success status.yaml |
|
|
|
- 200
|
|
|