cdd34ec059
Change-Id: I3a2f021f5d9e104539fc1550713553f6c86df553
233 lines
4.1 KiB
PHP
233 lines
4.1 KiB
PHP
=================
|
|
Actions (actions)
|
|
=================
|
|
|
|
Actions allow users to execute backups and restore operations on one node
|
|
or more. Actions are stored through the api in the database. It is included
|
|
in the job, every job contains set of actions that carry out the backup/restore
|
|
job.
|
|
|
|
Lists Actions
|
|
=============
|
|
|
|
.. rest_method:: GET /v1/actions
|
|
|
|
Lists actions.
|
|
|
|
This operation lists actions.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes:
|
|
|
|
- Unauthorized (401)
|
|
- Forbidden (403)
|
|
|
|
Query Parameters
|
|
-----------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- limit: limit
|
|
- offset: marker
|
|
- search: search_option
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- actions: actions
|
|
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/actions-list-request.json
|
|
:language: javascript
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/actions-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
Creates action
|
|
==============
|
|
|
|
.. rest_method:: POST /v1/actions
|
|
|
|
Creates an action.
|
|
|
|
This operation creates a new action.
|
|
|
|
The ``body`` attribute specifies contains a set of actions that gets created
|
|
one the job is submitted.
|
|
|
|
The ``description`` is the name that you give to the job. The name must not
|
|
exceed 64 bytes in length.
|
|
|
|
The ``job_schedule`` is very important to schedule the job or it will run only
|
|
once. also you can provide ``event`` which can automatically start/stop the
|
|
job.
|
|
|
|
The ``freezer_action`` holds the actual action parameters. ``freezer_action``
|
|
differs from action to another as it depends what this action is doing (backup,
|
|
restore, admin, info)
|
|
|
|
Normal response codes: 201
|
|
|
|
Error response codes:
|
|
|
|
- Syntax Error (753)
|
|
- BadRequest (400)
|
|
- Unauthorized (401)
|
|
- ServiceUnavailable (503)
|
|
|
|
|
|
Request Parameters
|
|
------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- freezer_action: freezer_action
|
|
- max_retries: max_retries
|
|
- max_retries_interval: max_retries_interval
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/actions-create-request.json
|
|
:language: javascript
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- action_id: action_id
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/actions-create-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
Show actions
|
|
============
|
|
|
|
.. rest_method:: GET /v1/actions/{action_id}
|
|
|
|
Shows actions.
|
|
|
|
This operation shows a certain action. The action details.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes:
|
|
|
|
- Unauthorized (401)
|
|
- Forbidden (403)
|
|
|
|
Query Parameters
|
|
-----------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- action_id: action_id_path
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- freezer_action: freezer_action
|
|
- max_retries: max_retries
|
|
- max_retries_interval: max_retries_interval
|
|
- user_id: user_id
|
|
- action_id: action_id
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/actions-get-response.json
|
|
:language: javascript
|
|
|
|
|
|
Updates actions
|
|
===============
|
|
|
|
.. rest_method:: POST /v1/actions/{action_id}
|
|
|
|
Updates an action.
|
|
|
|
This operation updates or replaces an existing action.
|
|
|
|
Normal response codes: 201
|
|
|
|
Error response codes:
|
|
|
|
- Syntax Error (753)
|
|
- BadRequest (400)
|
|
- Unauthorized (401)
|
|
- ServiceUnavailable (503)
|
|
|
|
|
|
Query Parameters
|
|
-----------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- action_id: action_id_path
|
|
|
|
Request Parameters
|
|
------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- freezer_action: freezer_action
|
|
- max_retries: max_retries
|
|
- max_retries_interval: max_retries_interval
|
|
- action_id: action_id
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/actions-update-request.json
|
|
:language: javascript
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/actions-update-response.json
|
|
:language: javascript
|
|
|
|
|
|
Delete actions
|
|
==============
|
|
|
|
.. rest_method:: DELETE /v1/actions/{action_id}
|
|
|
|
Delete actions.
|
|
|
|
This operation deletes a certain action.
|
|
|
|
Normal response codes: 204
|
|
|
|
Error response codes:
|
|
|
|
- Unauthorized (401)
|
|
- Forbidden (403)
|
|
|
|
Query Parameters
|
|
-----------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- action_id: action_id_path
|
|
|
|
There is no response for this operation.
|