senlin/api-ref/source/actions.inc
liyi 0cbd575aa0 Update events and actions API doc
Change-Id: I598de366a1cc411c40f9f03f740bca6b6dbe4aeb
2017-07-20 18:01:51 +08:00

145 lines
2.6 KiB
PHP

=======
Actions
=======
Lists all actions and shows details for an action.
List actions
============
.. rest_method:: GET /v1/actions
Lists all actions.
Response codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
- 503
Request Parameters
------------------
.. rest_parameters:: parameters.yaml
- OpenStack-API-Version: microversion
- limit: limit
- marker: marker
- sort: sort
- global_project: global_project
- name: name_query
- target: target_query
- action: action_action_query
- status: action_status_query
The sorting keys include ``name``, ``target``, ``action``, ``created_at``
and ``status``.
Response Parameters
-------------------
.. rest_parameters:: parameters.yaml
- X-OpenStack-Request-ID: request_id
- actions: actions
- action: action_action
- cause: cause
- created_at: created_at
- data: action_data
- depended_by: depended_by
- depends_on: depends_on
- start_time: start_time
- end_time: end_time
- id: action_id
- inputs: inputs
- interval: interval
- name: name
- outputs: outputs
- owner: action_owner
- project: project
- status: action_status
- status_reason: status_reason
- target: action_target
- timeout: action_timeout
- updated_at: updated_at
- user: user
Response Example
----------------
.. literalinclude:: samples/actions-list-response.json
:language: javascript
Show action details
===================
.. rest_method:: GET /v1/actions/{action_id}
Shows details for an action.
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
- 404
- 503
Request Parameters
------------------
.. rest_parameters:: parameters.yaml
- OpenStack-API-Version: microversion
- action_id: action_id_url
Response Parameters:
.. rest_parameters:: parameters.yaml
- X-OpenStack-Request-ID: request_id
- action: action_action
- cause: cause
- created_at: created_at
- data: action_data
- depended_by: depended_by
- depends_on: depends_on
- start_time: start_time
- end_time: end_time
- id: action_id
- inputs: inputs
- interval: interval
- name: name
- outputs: outputs
- owner: action_owner
- project: project
- status: action_status
- status_reason: status_reason
- target: action_target
- timeout: action_timeout
- updated_at: updated_at
- user: user
Response Example
----------------
.. literalinclude:: samples/action-get-response.json
:language: javascript