#############
SetAlarmState
#############

***********
Description
***********

Изменяет состояние аларма.

******************
Request Parameters
******************

Необходимые параметры
=====================

- *AlarmName* — Имя аларма.

  - Необходимо: Да
  - Тип: String
  - Ограничение длины: От 1 до 255 символов

- *StateReason* — Описание причины, по которой должно быть произведено переключение состояния аларма.

  - Необходимо: Да
  - Тип: String
  - Ограничение длины: От 1 до 1023 символов

- *StateValue* — Состояние, в которое должен переключиться аларм.

  - Необходимо: Да
  - Тип: String
  - Возможные значения: ``ok`` | ``alarm`` | ``insufficient_data``

Опциональные параметры
======================

- *StateReasonData* — Описание причины, по которой должно быть произведено переключение состояния аларма (в формате JSON).

  - Необходимо: Нет
  - Тип: String
  - Ограничение длины: От 0 до 4000 символов

********
Examples
********

.. code-block:: bash

   c2-cw SetAlarmState AlarmName <alarm_name> StateReason <state_reason> \
                       StateValue <state_value>

   c2-cw SetAlarmState AlarmName <alarm_name> StateReason <state_reason> \
                       StateValue <state_value> StateReasonData <state_reason_data>