8837801ba6
This brings in RST plus YAML files, migrated from the source for [0]. The migration explanation is found on the openstack-dev mailing list [1]. Project instruction is in the OpenStack Documentation Contributor Guide [2]. [0]https://github.com/openstack/api-site/tree/master/api-ref/source/telemetry/v2 [1]http://lists.openstack.org/pipermail/openstack-dev/2016-May/093765.html [2]http://docs.openstack.org/contributor-guide/api-guides.html Change-Id: I21d559f3abea502a0ed237d693ab24a5110d42c5
334 lines
4.9 KiB
ReStructuredText
Executable File
334 lines
4.9 KiB
ReStructuredText
Executable File
.. -*- rst -*-
|
|
|
|
======
|
|
Alarms
|
|
======
|
|
|
|
Lists, creates, gets details for, updates, and deletes alarms.
|
|
|
|
|
|
Show alarm details
|
|
==================
|
|
|
|
.. rest_method:: GET /v2/alarms/{alarm_id}
|
|
|
|
Shows details for an alarm, by alarm ID.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_id: alarm_id
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_actions: alarm_actions
|
|
- alarm_id: alarm_id
|
|
- combination_rule: combination_rule
|
|
- description: description
|
|
- enabled: enabled
|
|
- insufficient_data_actions: insufficient_data_actions
|
|
- timestamp: timestamp
|
|
- name: name
|
|
- ok_actions: ok_actions
|
|
- project_id: project_id
|
|
- state_timestamp: state_timestamp
|
|
- threshold_rule: threshold_rule
|
|
- repeat_actions: repeat_actions
|
|
- state: state
|
|
- type: type
|
|
- user_id: user_id
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/alarm-show-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Update alarm
|
|
============
|
|
|
|
.. rest_method:: PUT /v2/alarms/{alarm_id}
|
|
|
|
Updates an alarm.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_id: alarm_id
|
|
- data: data
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_actions: alarm_actions
|
|
- ok_actions: ok_actions
|
|
- description: description
|
|
- timestamp: timestamp
|
|
- enabled: enabled
|
|
- combination_rule: combination_rule
|
|
- state_timestamp: state_timestamp
|
|
- threshold_rule: threshold_rule
|
|
- alarm_id: alarm_id
|
|
- state: state
|
|
- insufficient_data_actions: insufficient_data_actions
|
|
- repeat_actions: repeat_actions
|
|
- user_id: user_id
|
|
- project_id: project_id
|
|
- type: type
|
|
- name: name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/alarm-show-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Delete alarm
|
|
============
|
|
|
|
.. rest_method:: DELETE /v2/alarms/{alarm_id}
|
|
|
|
Deletes an alarm, by alarm ID.
|
|
|
|
Error response codes:204
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_id: alarm_id
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Update alarm state
|
|
==================
|
|
|
|
.. rest_method:: PUT /v2/alarms/{alarm_id}/state
|
|
|
|
Sets the state of an alarm.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_id: alarm_id
|
|
- state: state
|
|
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude::
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Show alarm state
|
|
================
|
|
|
|
.. rest_method:: GET /v2/alarms/{alarm_id}/state
|
|
|
|
Shows the state for an alarm, by alarm ID.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_id: alarm_id
|
|
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude::
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
List alarms
|
|
===========
|
|
|
|
.. rest_method:: GET /v2/alarms
|
|
|
|
Lists alarms, based on a query.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- q: q
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_actions: alarm_actions
|
|
- ok_actions: ok_actions
|
|
- description: description
|
|
- timestamp: timestamp
|
|
- enabled: enabled
|
|
- combination_rule: combination_rule
|
|
- state_timestamp: state_timestamp
|
|
- threshold_rule: threshold_rule
|
|
- alarm_id: alarm_id
|
|
- state: state
|
|
- insufficient_data_actions: insufficient_data_actions
|
|
- repeat_actions: repeat_actions
|
|
- user_id: user_id
|
|
- project_id: project_id
|
|
- type: type
|
|
- name: name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/alarms-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Create alarm
|
|
============
|
|
|
|
.. rest_method:: POST /v2/alarms
|
|
|
|
Creates an alarm.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- data: data
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_actions: alarm_actions
|
|
- ok_actions: ok_actions
|
|
- description: description
|
|
- timestamp: timestamp
|
|
- enabled: enabled
|
|
- combination_rule: combination_rule
|
|
- state_timestamp: state_timestamp
|
|
- threshold_rule: threshold_rule
|
|
- alarm_id: alarm_id
|
|
- state: state
|
|
- insufficient_data_actions: insufficient_data_actions
|
|
- repeat_actions: repeat_actions
|
|
- user_id: user_id
|
|
- project_id: project_id
|
|
- type: type
|
|
- name: name
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/alarm-show-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Show alarm history
|
|
==================
|
|
|
|
.. rest_method:: GET /v2/alarms/{alarm_id}/history
|
|
|
|
Assembles and shows the history for an alarm, by alarm ID.
|
|
|
|
|
|
Normal response codes: 200
|
|
Error response codes:
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- alarm_id: alarm_id
|
|
- q: q
|
|
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude::
|
|
:language: javascript
|