senlin/api-ref/source/actions.inc
tengqm 0456a0a1c1 Add status code tables to api-ref doc
This patch leverages the new status code table feature in os-api-ref
version 0.4.0 and above.

Change-Id: I102bb1bdab03acb19b5317c1fdf51c275630bba0
2016-08-10 23:01:09 -04:00

136 lines
2.3 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
Reponse Parameters
------------------
.. rest_parameters:: parameters.yaml
- actions: actions
- action: action_action
- cause: cause
- context: action_context
- created_at: created_at
- 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
- status: action_status
- status_reason: status_reason
- target: action_target
- timeout: action_timeout
- updated_at: updated_at
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
- action: action_action
- cause: cause
- context: action_context
- created_at: created_at
- 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
- status: action_status
- status_reason: status_reason
- target: action_target
- timeout: action_timeout
- updated_at: updated_at
Response Example
----------------
.. literalinclude:: samples/action-get-response.json
:language: javascript