Hc_ap_speaker_off

Команда выключает динамик на блоке аварийной сигнализации (БАС).

Аналог команды в CoCon:

cluster/mediator/<CLUSTER>/ap/speaker-off

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/ap_speaker_off

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

202 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос:
http://192.168.23.34:9999/commands/ap_speaker_off

<?xml version="1.0"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ap_speaker_off.xsd">
        <request mediator="md1"/>
</in>

Ответ:

202

Hc_ap_status

Команда возвращает состояние блока аварийной сигнализации (БАС).

Аналог команды в CoCon:

cluster/mediator/<CLUSTER>/ap/status

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/ap_status

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

202 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <!-- errorType-->
    <xs:complexType name="errorType">
        <xs:attribute name="reason" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- basType-->
    <xs:complexType name="basType">
        <xs:attribute name="ip" type="xs:string" use="required"/>
        <xs:attribute name="port" type="xs:integer" use="required"/>
        <xs:attribute name="speaker" type="xs:boolean" use="required"/>
        <xs:attribute name="led_0" type="xs:boolean" use="required"/>
        <xs:attribute name="led_1" type="xs:boolean" use="required"/>
        <xs:attribute name="led_2" type="xs:boolean" use="required"/>
        <xs:attribute name="led_3" type="xs:boolean" use="required"/>
        <xs:attribute name="led_4" type="xs:boolean" use="required"/>
    </xs:complexType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- out-->
    <xs:element name="out">
        <xs:complexType>
            <xs:choice>
                <xs:element name="error" type="errorType" minOccurs="0" />
                <xs:element name="bas" type="basType" minOccurs="0" />
            </xs:choice>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос: http://192.168.1.21:9999/commands/ap_status

<?xml version="1.0"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ap_speaker_off.xsd">
        <request mediator="md1"/>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ap_status.xsd">
    <bas ip="" port="0" speaker="true" led_0="true" led_1="false" led_2="false" led_3="false" led_4="false"/>
</out>

В случае ошибки:

<?xml version="1.0"?>
<out xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ap_status.xsd">
    <error reason="Not connection to the alarm panel."/>
</out>

Hc_alarms_list

Команда возвращает список аварий в системе.

Аналог команды в CoCon:

cluster/mediator/<CLUSTER>/alarms/list

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_list

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

200 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema
    xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <xs:include schemaLocation="rps.xsd"/>
    <!-- stringType -->
    <xs:complexType name="stringType">
        <xs:attribute name="value" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- pstrArgType -->
    <xs:complexType name="pstrArgType">
        <xs:attribute name="value" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- pstrType -->
    <xs:complexType name="pstrType">
        <xs:sequence minOccurs="0" maxOccurs="unbounded">
            <xs:element name="arg" type="pstrArgType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
        <xs:attribute name="value" type="xs:string" use="required"/>
        <xs:attribute name="id" type="xs:string" use="optional"/>
        <xs:attribute name="template" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- requestType -->
    <xs:simpleType name="requestType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="active"/>
            <xs:enumeration value="cleared"/>
            <xs:enumeration value="all"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- operType -->
    <xs:simpleType name="operType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="equal"/>
            <xs:enumeration value="not_equal"/>
            <xs:enumeration value="more"/>
            <xs:enumeration value="less"/>
            <xs:enumeration value="more_or_equal"/>
            <xs:enumeration value="less_or_equal"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- sortType -->
    <xs:simpleType name="sortType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="asc"/>
            <xs:enumeration value="desc"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- columnType -->
    <xs:complexType name="columnType">
        <xs:attribute name="name" type="columnNameType" use="required"/>
        <xs:attribute name="sort" type="sortType" use="optional"/>
    </xs:complexType>
    <!-- filterType -->
    <xs:complexType name="filterType">
        <xs:choice>
            <xs:element name="id" type="stringType"/>
            <xs:element name="managedObjectClass" type="stringType"/>
            <xs:element name="managedObjectInstance" type="stringType"/>
            <xs:element name="location" type="stringType"/>
            <xs:element name="domain" type="stringType"/>
            <xs:element name="user_id" type="stringType"/>
            <xs:element name="eventTime" type="eventTimeType"/>
            <!-- datetime or undefined -->
            <xs:element name="cleared" type="eventTimeType"/>
            <xs:element name="probableCause">
                <xs:complexType>
                    <xs:attribute name="value" type="alarmCauseType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="eventType">
                <xs:complexType>
                    <xs:attribute name="value" type="alarmEventTypeType" use="required"/>
                </xs:complexType>
            </xs:element>
            <!-- term -->
            <xs:element name="specificProblems" type="stringType"/>
            <xs:element name="perceivedSeverity">
                <xs:complexType>
                    <xs:attribute name="value" type="severityType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="originalSeverity">
                <xs:complexType>
                    <xs:attribute name="value" type="severityType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="backedupStatus">
                <xs:complexType>
                    <xs:attribute name="value" type="backedupStatusType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="backupObject" type="stringType"/>
            <xs:element name="trendIndication">
                <xs:complexType>
                    <xs:attribute name="value" type="trendIndicationType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="thresholdInformation" type="stringType"/>
            <xs:element name="notificationIdentifier" type="stringType"/>
            <xs:element name="correlatedNotifications" type="stringType"/>
            <xs:element name="stateChangeDefinition" type="stringType"/>
            <xs:element name="monitoredAttributes" type="stringType"/>
            <xs:element name="proposedRepairActions" type="stringType"/>
            <xs:element name="additionalText" type="stringType"/>
            <xs:element name="additionalInformation" type="stringType"/>
        </xs:choice>
        <xs:attribute name="oper" type="operType" use="required"/>
    </xs:complexType>
    <!-- columnsType -->
    <xs:complexType name="columnsType">
        <xs:sequence>
            <xs:element name="column" type="columnType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>
    <!-- filtersType -->
    <xs:complexType name="filtersType">
        <xs:sequence>
            <xs:element name="filter" type="filterType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>
    <!-- rowType -->
    <xs:complexType name="rowType">
        <xs:all>
            <xs:element name="id" type="stringType" minOccurs="0"/>
            <xs:element name="managedObjectClass" type="stringType" minOccurs="0"/>
            <xs:element name="managedObjectInstance" type="stringType" minOccurs="0"/>
            <xs:element name="location" type="stringType" minOccurs="0"/>
            <xs:element name="domain" type="stringType" minOccurs="0"/>
            <xs:element name="user_id" type="stringType" minOccurs="0"/>
            <xs:element name="eventTime" type="eventTimeType" minOccurs="0"/>
            <!-- datetime or undefined -->
            <xs:element name="cleared" type="eventTimeType" minOccurs="0"/>
            <xs:element name="probableCause" minOccurs="0">
                <xs:complexType>
                    <xs:attribute name="value" type="alarmCauseType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="eventType" minOccurs="0">
                <xs:complexType>
                    <xs:attribute name="value" type="alarmEventTypeType" use="required"/>
                </xs:complexType>
            </xs:element>
            <!-- term -->
            <xs:element name="specificProblems" type="stringType" minOccurs="0"/>
            <xs:element name="perceivedSeverity" minOccurs="0">
                <xs:complexType>
                    <xs:attribute name="value" type="severityType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="originalSeverity" minOccurs="0">
                <xs:complexType>
                    <xs:attribute name="value" type="severityType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="backedupStatus" minOccurs="0">
                <xs:complexType>
                    <xs:attribute name="value" type="backedupStatusType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="backupObject" type="stringType" minOccurs="0"/>
            <xs:element name="trendIndication" minOccurs="0">
                <xs:complexType>
                    <xs:attribute name="value" type="trendIndicationType" use="required"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="thresholdInformation" type="stringType" minOccurs="0"/>
            <xs:element name="notificationIdentifier" type="stringType" minOccurs="0"/>
            <xs:element name="correlatedNotifications" type="stringType" minOccurs="0"/>
            <xs:element name="stateChangeDefinition" type="stringType" minOccurs="0"/>
            <xs:element name="monitoredAttributes" type="stringType" minOccurs="0"/>
            <xs:element name="proposedRepairActions" type="stringType" minOccurs="0"/>
            <xs:element name="additionalText" type="pstrType" minOccurs="0"/>
            <xs:element name="additionalInformation" type="stringType" minOccurs="0"/>
        </xs:all>
    </xs:complexType>
    <!-- rowsType -->
    <xs:complexType name="rowsType">
        <xs:sequence>
            <xs:element name="row" type="rowType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>
    <!-- in -->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="columns" type="columnsType"/>
                            <xs:element name="filters" type="filtersType"/>
                        </xs:sequence>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                        <xs:attribute name="type" type="requestType" use="required"/>
                        <xs:attribute name="count" type="xs:integer" use="optional"/>
                        <xs:attribute name="offset" type="xs:integer" use="optional"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="out">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="response">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="time" type="eventTimeType"/>
                            <xs:element name="columns" type="columnsType"/>
                            <xs:element name="rows" type="rowsType"/>
                        </xs:sequence>
                        <xs:attribute name="type" type="requestType" use="required"/>
                        <xs:attribute name="total" type="xs:integer" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

rps.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <!-- columnNameType -->
    <xs:simpleType name="columnNameType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="id"/>
            <xs:enumeration value="managedObjectClass"/>
            <xs:enumeration value="managedObjectInstance"/>
            <xs:enumeration value="location"/>
            <xs:enumeration value="domain"/>
            <xs:enumeration value="user_id"/>
            <xs:enumeration value="eventTime"/>
            <xs:enumeration value="cleared"/>
            <xs:enumeration value="probableCause"/>
            <xs:enumeration value="eventType"/>
            <xs:enumeration value="specificProblems"/>
            <xs:enumeration value="perceivedSeverity"/>
            <xs:enumeration value="originalSeverity"/>
            <xs:enumeration value="backedupStatus"/>
            <xs:enumeration value="backupObject"/>
            <xs:enumeration value="trendIndication"/>
            <xs:enumeration value="thresholdInformation"/>
            <xs:enumeration value="notificationIdentifier"/>
            <xs:enumeration value="correlatedNotifications"/>
            <xs:enumeration value="stateChangeDefinition"/>
            <xs:enumeration value="monitoredAttributes"/>
            <xs:enumeration value="proposedRepairActions"/>
            <xs:enumeration value="additionalText"/>
            <xs:enumeration value="additionalInformation"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- trendIndicationType -->
    <xs:simpleType name="trendIndicationType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="moreSevere"/>
            <xs:enumeration value="noChange"/>
            <xs:enumeration value="lessSevere"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- backedupStatusType -->
    <xs:simpleType name="backedupStatusType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="true"/>
            <xs:enumeration value="false"/>
            <xs:enumeration value="undefined"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- severityType -->
    <xs:simpleType name="severityType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="cleared"/>
            <xs:enumeration value="indeterminate"/>
            <xs:enumeration value="critical"/>
            <xs:enumeration value="major"/>
            <xs:enumeration value="minor"/>
            <xs:enumeration value="warning"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- alarmEventTypeType -->
    <xs:simpleType name="alarmEventTypeType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="other"/>
            <xs:enumeration value="communicationsAlarm"/>
            <xs:enumeration value="qualityOfServiceAlarm"/>
            <xs:enumeration value="processingErrorAlarm"/>
            <xs:enumeration value="equipmentAlarm"/>
            <xs:enumeration value="environmentalAlarm"/>
            <xs:enumeration value="integrityViolation"/>
            <xs:enumeration value="operationalViolation"/>
            <xs:enumeration value="physicalViolation"/>
            <xs:enumeration value="securityServiceOrMechanismViolation"/>
            <xs:enumeration value="timeDomainViolation"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- alarmCauseType -->
    <xs:simpleType name="alarmCauseType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="other"/>
            <xs:enumeration value="unexpectedInformation"/>
            <xs:enumeration value="unauthorizedAccessAttempt"/>
            <xs:enumeration value="proceduralError"/>
            <xs:enumeration value="outOfService"/>
            <xs:enumeration value="outOfHoursActivity"/>
            <xs:enumeration value="nonRepudiationFailure"/>
            <xs:enumeration value="keyExpired"/>
            <xs:enumeration value="informationOutOfSequence"/>
            <xs:enumeration value="informationModificationDetected"/>
            <xs:enumeration value="informationMissing"/>
            <xs:enumeration value="duplicateInformation"/>
            <xs:enumeration value="denialOfService"/>
            <xs:enumeration value="delayedInformation"/>
            <xs:enumeration value="cableTamper"/>
            <xs:enumeration value="breachOfConfidentiality"/>
            <xs:enumeration value="authenticationFailure"/>
            <xs:enumeration value="versionMismatchX733"/>
            <xs:enumeration value="underlyingResourceUnavailable"/>
            <xs:enumeration value="transmiterFailure"/>
            <xs:enumeration value="transmitFailureX733"/>
            <xs:enumeration value="toxicLeakDetected"/>
            <xs:enumeration value="timingProblemX733"/>
            <xs:enumeration value="thresholdCrossed"/>
            <xs:enumeration value="temperatureUnacceptable"/>
            <xs:enumeration value="storageCapacityProblemX733"/>
            <xs:enumeration value="softwareProgramError"/>
            <xs:enumeration value="softwareProgramAbnormallyTerminated"/>
            <xs:enumeration value="softwareErrorX733"/>
            <xs:enumeration value="retransmissionRateExcessive"/>
            <xs:enumeration value="responseTimeExecessive"/>
            <xs:enumeration value="resourceAtOrNearingCapacity"/>
            <xs:enumeration value="remoteNodeTransmissionErrorX733"/>
            <xs:enumeration value="receiverFailureX733"/>
            <xs:enumeration value="receiveFailureX733"/>
            <xs:enumeration value="queueSizeExceeded"/>
            <xs:enumeration value="pumpFailureX733"/>
            <xs:enumeration value="processorProblems"/>
            <xs:enumeration value="pressureUnacceptable"/>
            <xs:enumeration value="powerProblems"/>
            <xs:enumeration value="performanceDegraded"/>
            <xs:enumeration value="ouputDeviceError"/>
            <xs:enumeration value="outOfMemoryX733"/>
            <xs:enumeration value="multiplexerProblemX733"/>
            <xs:enumeration value="materialSupplyExhausted"/>
            <xs:enumeration value="lossOfSignalX733"/>
            <xs:enumeration value="lossOfFrameX733"/>
            <xs:enumeration value="localNodeTransmissionErrorX733"/>
            <xs:enumeration value="leakDetected"/>
            <xs:enumeration value="lanError"/>
            <xs:enumeration value="inputDeviceError"/>
            <xs:enumeration value="inputOutputDeviceError"/>
            <xs:enumeration value="humidityUnacceptable"/>
            <xs:enumeration value="heatingVentCoolingSystemProblem"/>
            <xs:enumeration value="framingErrorX733"/>
            <xs:enumeration value="fireDetected"/>
            <xs:enumeration value="fileErrorX733"/>
            <xs:enumeration value="excessiveVibration"/>
            <xs:enumeration value="equipmentMalfunction"/>
            <xs:enumeration value="enclosureDoorOpenX733"/>
            <xs:enumeration value="dteDceInterfaceError"/>
            <xs:enumeration value="degradedSignalX733"/>
            <xs:enumeration value="dataSetOrModemError"/>
            <xs:enumeration value="cpuCyclesLimitExceeded"/>
            <xs:enumeration value="coruptData"/>
            <xs:enumeration value="congestionX733"/>
            <xs:enumeration value="configurationOrCustomizationError"/>
            <xs:enumeration value="communicationsSubsystemFailure"/>
            <xs:enumeration value="communicationsProtocolError"/>
            <xs:enumeration value="callEstablishmentError"/>
            <xs:enumeration value="bandwidthReducedX733"/>
            <xs:enumeration value="applicationSubsystemFailture"/>
            <xs:enumeration value="adapterError"/>
            <xs:enumeration value="systemResourcesOverload"/>
            <xs:enumeration value="reducedLoggingCapability"/>
            <xs:enumeration value="excessiveRetransmissionRate"/>
            <xs:enumeration value="excessiveResponseTime"/>
            <xs:enumeration value="excessiveErrorRate"/>
            <xs:enumeration value="congestion"/>
            <xs:enumeration value="bandwidthReduced"/>
            <xs:enumeration value="versionMismatch"/>
            <xs:enumeration value="underlayingResourceUnavailable"/>
            <xs:enumeration value="timeoutExpired"/>
            <xs:enumeration value="softwareError"/>
            <xs:enumeration value="outOfMemory"/>
            <xs:enumeration value="fileError"/>
            <xs:enumeration value="databaseInconsistency"/>
            <xs:enumeration value="configurationOrCustomisationError"/>
            <xs:enumeration value="applicationSubsystemFailure"/>
            <xs:enumeration value="lossOfRealTimel"/>
            <xs:enumeration value="sfwrDownloadFailure"/>
            <xs:enumeration value="sfwrEnvironmentProblem"/>
            <xs:enumeration value="outOfCPUCycles"/>
            <xs:enumeration value="corruptData"/>
            <xs:enumeration value="memoryMismatch"/>
            <xs:enumeration value="storageCapacityProblem"/>
            <xs:enumeration value="externalPointFailure"/>
            <xs:enumeration value="externalEquipmentFailure"/>
            <xs:enumeration value="coolingSystemFailure"/>
            <xs:enumeration value="toxicGas"/>
            <xs:enumeration value="smoke"/>
            <xs:enumeration value="lowWater"/>
            <xs:enumeration value="lowTemperatue"/>
            <xs:enumeration value="lowCablePressure"/>
            <xs:enumeration value="lowHumidity"/>
            <xs:enumeration value="lowFuel"/>
            <xs:enumeration value="intrusionDetection"/>
            <xs:enumeration value="iceBuildUp"/>
            <xs:enumeration value="highWind"/>
            <xs:enumeration value="highTemperature"/>
            <xs:enumeration value="highHumidity"/>
            <xs:enumeration value="flood"/>
            <xs:enumeration value="fire"/>
            <xs:enumeration value="explosiveGas"/>
            <xs:enumeration value="enclosureDoorOpen"/>
            <xs:enumeration value="ventilationsSystemFailure"/>
            <xs:enumeration value="rectifierLowFVoltage"/>
            <xs:enumeration value="rectifierHighVoltage"/>
            <xs:enumeration value="rectifierFailure"/>
            <xs:enumeration value="pumpFailure"/>
            <xs:enumeration value="lowBatteryThreshold"/>
            <xs:enumeration value="generatorFailure"/>
            <xs:enumeration value="fuseFailure"/>
            <xs:enumeration value="fireDetectorFailure"/>
            <xs:enumeration value="engineFailure"/>
            <xs:enumeration value="coolingFanFailure"/>
            <xs:enumeration value="commercialPowerFailure"/>
            <xs:enumeration value="batteryFailure"/>
            <xs:enumeration value="batteryDischarging"/>
            <xs:enumeration value="airDryerFailure"/>
            <xs:enumeration value="airConditioningFailure"/>
            <xs:enumeration value="airCompressorFailure"/>
            <xs:enumeration value="protectingResourceFailure"/>
            <xs:enumeration value="protectionMechanismFailure"/>
            <xs:enumeration value="tranceiverFailure"/>
            <xs:enumeration value="signalQualityEvaluationFailure"/>
            <xs:enumeration value="powerSupplyFailure"/>
            <xs:enumeration value="lossOfRedundancy"/>
            <xs:enumeration value="lossOfSynchronisation"/>
            <xs:enumeration value="iODeviceError"/>
            <xs:enumeration value="frequencyHoppingFailure"/>
            <xs:enumeration value="diskFailure"/>
            <xs:enumeration value="batteryChargingFailure"/>
            <xs:enumeration value="antennaFailure"/>
            <xs:enumeration value="realTimeClockFailure"/>
            <xs:enumeration value="replaceableUnitProblem"/>
            <xs:enumeration value="trunkCardProblem"/>
            <xs:enumeration value="transmitterFailure"/>
            <xs:enumeration value="timingProblem"/>
            <xs:enumeration value="terminalProblem"/>
            <xs:enumeration value="synchronizationSourceMismatch"/>
            <xs:enumeration value="replaceableUnitTypeMismatch"/>
            <xs:enumeration value="replaceableUnitMissing"/>
            <xs:enumeration value="receiverFailure"/>
            <xs:enumeration value="protectionPathFailure"/>
            <xs:enumeration value="processorProblem"/>
            <xs:enumeration value="powerProblem"/>
            <xs:enumeration value="nEIdentifierDuplication"/>
            <xs:enumeration value="multiplexerProblem"/>
            <xs:enumeration value="lineCardProblem"/>
            <xs:enumeration value="externalIFDeviceProblem"/>
            <xs:enumeration value="equipmentIdentifierDuplication"/>
            <xs:enumeration value="dataSetProblem"/>
            <xs:enumeration value="backplaneFailure"/>
            <xs:enumeration value="routingFailure"/>
            <xs:enumeration value="remoteNodeTransmissionError"/>
            <xs:enumeration value="localNodeTransmissionError"/>
            <xs:enumeration value="invalidMessageReceived"/>
            <xs:enumeration value="connectionEstablishmentError"/>
            <xs:enumeration value="broadcastChannelFailure"/>
            <xs:enumeration value="demodulationFailure"/>
            <xs:enumeration value="modulationFailure"/>
            <xs:enumeration value="transmitFailure"/>
            <xs:enumeration value="receiveFailure"/>
            <xs:enumeration value="lossOfMultiFrame"/>
            <xs:enumeration value="signalLabelMismatch"/>
            <xs:enumeration value="unavailable"/>
            <xs:enumeration value="pathTraceMismatch"/>
            <xs:enumeration value="excessiveBER"/>
            <xs:enumeration value="remoteAlarmInterface"/>
            <xs:enumeration value="transmissionError"/>
            <xs:enumeration value="payloadTypeMismatch"/>
            <xs:enumeration value="lossOfSignal"/>
            <xs:enumeration value="lossOfPointer"/>
            <xs:enumeration value="lossOfFrame"/>
            <xs:enumeration value="framingError"/>
            <xs:enumeration value="farEndReceiverFailure"/>
            <xs:enumeration value="degradedSignal"/>
            <xs:enumeration value="callSetUpFailure"/>
            <xs:enumeration value="aIS"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- eventTimeType-->
    <xs:complexType name="eventTimeType">
        <xs:attribute name="year" type="xs:integer" use="required"/>
        <xs:attribute name="month" type="xs:integer" use="required"/>
        <xs:attribute name="day" type="xs:integer" use="required"/>
        <xs:attribute name="hour" type="xs:integer" use="required"/>
        <xs:attribute name="minute" type="xs:integer" use="required"/>
        <xs:attribute name="second" type="xs:integer" use="required"/>
    </xs:complexType>
    <!-- alarmEventType-->
    <xs:complexType name="alarmEventType">
        <xs:attribute name="cause" type="alarmCauseType" use="required"/>
        <xs:attribute name="type" type="alarmEventTypeType" use="required"/>
        <xs:attribute name="severity" type="severityType" use="required"/>
        <xs:attribute name="trend" type="trendIndicationType" use="required"/>
        <xs:attribute name="text" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- rpsEventType-->
    <xs:complexType name="rpsEventType">
        <xs:sequence>
            <xs:element name="time" type="eventTimeType"/>
            <xs:element name="info" type="alarmEventType"/>
        </xs:sequence>
        <xs:attribute name="id" type="xs:string" use="required"/>
        <xs:attribute name="class" type="xs:string" use="required"/>
        <xs:attribute name="location" type="xs:string" use="required"/>
        <xs:attribute name="instance" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- events -->
    <xs:element name="events">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="event" type="rpsEventType" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос: http://192.168.1.21:9999/commands/alarms_list

<?xml version="1.0" encoding="UTF-8"?>
<in
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_list.xsd">
    <request offset="0" mediator="md1" type="all" count="5">
        <columns>
            <column name="id"/>
            <column name="originalSeverity"/>
            <column name="perceivedSeverity"/>
            <column name="managedObjectClass"/>
            <column name="managedObjectInstance"/>
            <column name="location"/>
            <column name="user_id"/>
            <column sort="desc" name="eventTime"/>
            <column name="probableCause"/>
            <column name="eventType"/>
            <column name="additionalText"/>
        </columns>
        <filters>
            <filter oper="more_or_equal">
                <eventTime minute="0" second="0" day="17" month="09" year="2017" hour="0" />
            </filter>
            <filter oper="not_equal">
                <id value="65353061-3434-3734-6435-383562323062"/>
            </filter>
        </filters>
    </request>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarms_list.xsd">
    <response type="all" total="72">
        <time year="2017" month="9" day="17" hour="8" minute="25" second="45"/>
        <columns>
            <column name="id"/>
            <column name="originalSeverity"/>
            <column name="perceivedSeverity"/>
            <column name="managedObjectClass"/>
            <column name="managedObjectInstance"/>
            <column name="location"/>
            <column name="user_id"/>
            <column name="eventTime" sort="desc"/>
            <column name="probableCause"/>
            <column name="eventType"/>
            <column name="additionalText"/>
        </columns>
        <rows>
            <row>
                <id value="65353061-3433-3239-6366-333364616164"/>
                <originalSeverity value="critical"/>
                <perceivedSeverity value="cleared"/>
                <managedObjectClass value="ecss::system::log"/>
                <managedObjectInstance value="sip1@ecss2"/>
                <location value="sip1@ecss2"/>
                <user_id value="admin"/>
                <eventTime year="2017" month="9" day="17" hour="4" minute="2" second="6"/>
                <probableCause value="softwareError"/>
                <eventType value="securityServiceOrMechanismViolation"/>
                <additionalText id="chronica_rps_alarm_backend_log_data_updated" template="Error log data updated" value="Error log data updated"/>
            </row>
            <row>
                <id value="65353061-3431-3334-3563-396562313138"/>
                <originalSeverity value="critical"/>
                <perceivedSeverity value="cleared"/>
                <managedObjectClass value="hw::interfaces"/>
                <managedObjectInstance value="bond0"/>
                <location value="ecss2"/>
                <user_id value="admin"/>
                <eventTime year="2017" month="9" day="17" hour="4" minute="1" second="59"/>
                <probableCause value="lanError"/>
                <eventType value="equipmentAlarm"/>
                <additionalText id="rps_if_handler_network_interface_is_down" template="Network interface ~s is down" value="Network interface "bond0" is down">
                    <arg value=""bond0""/>
                </additionalText>
            </row>
            <row>
                <id value="65353061-3430-3663-3736-653733343835"/>
                <originalSeverity value="critical"/>
                <perceivedSeverity value="cleared"/>
                <managedObjectClass value="hw::interfaces"/>
                <managedObjectInstance value="bond1.2:2"/>
                <location value="ecss1"/>
                <user_id value="admin"/>
                <eventTime year="2017" month="9" day="17" hour="4" minute="1" second="58"/>
                <probableCause value="lanError"/>
                <eventType value="equipmentAlarm"/>
                <additionalText id="rps_if_handler_network_interface_is_down" template="Network interface ~s is down" value="Network interface "bond1.2:2" is down">
                    <arg value=""bond1.2:2""/>
                </additionalText>
            </row>
            <row>
                <id value="65353061-3366-6330-6362-396365383530"/>
                <originalSeverity value="critical"/>
                <perceivedSeverity value="cleared"/>
                <managedObjectClass value="ecss::system::log"/>
                <managedObjectInstance value="core1@ecss2"/>
                <location value="core1@ecss2"/>
                <user_id value="admin"/>
                <eventTime year="2017" month="9" day="17" hour="4" minute="1" second="57"/>
                <probableCause value="softwareError"/>
                <eventType value="securityServiceOrMechanismViolation"/>
                <additionalText id="chronica_rps_alarm_backend_log_data_updated" template="Error log data updated" value="Error log data updated"/>
            </row>
            <row>
                <id value="65353061-3363-6537-6335-653266313132"/>
                <originalSeverity value="critical"/>
                <perceivedSeverity value="cleared"/>
                <managedObjectClass value="ecss::system::log"/>
                <managedObjectInstance value="md1@ecss2"/>
                <location value="md1@ecss2"/>
                <user_id value="admin"/>
                <eventTime year="2017" month="9" day="17" hour="4" minute="1" second="46"/>
                <probableCause value="softwareError"/>
                <eventType value="securityServiceOrMechanismViolation"/>
                <additionalText id="chronica_rps_alarm_backend_log_data_updated" template="Error log data updated" value="Error log data updated"/>
            </row>
        </rows>
    </response>
</out>

Hc_alarms_mask_list

Команда возвращает список масок, используемых для маскирования алармов.

Аналог команды в CoCon:

cluster/mediator/<md>/alarms/masklist

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_mask_list

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

200 – в случае успеха;
404 – в случае ошибки.

hc_alarms_mask_common.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <!-- stringType-->
    <xs:complexType name="stringType">
        <xs:attribute name="value" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- stringArrayType-->
    <xs:complexType name="stringArrayType">
        <xs:sequence>
            <xs:element name="item" type="stringType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>
    <!-- alarmMaskType-->
    <xs:complexType name="alarmMaskType">
        <xs:sequence>
            <xs:choice>
                <xs:element name="location" type="stringType"/>
                <xs:element name="ignoreLocations" type="stringArrayType"/>
            </xs:choice>
            <xs:choice>
                <xs:element name="class" type="stringType"/>
                <xs:element name="ignoreClasses" type="stringArrayType"/>
            </xs:choice>
            <xs:choice>
                <xs:element name="instance" type="stringType"/>
                <xs:element name="ignoreInstances" type="stringArrayType"/>
            </xs:choice>
        </xs:sequence>
        <xs:attribute name="id" type="xs:string" use="optional"/>
        <xs:attribute name="enabled" type="xs:boolean" use="required"/>
        <xs:attribute name="date" type="xs:string" use="optional"/>
    </xs:complexType>
</xs:schema>

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <xs:include schemaLocation="hc_alarms_mask_common.xsd"/> 
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- out-->
    <xs:element name="out">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="masks">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="mask" type="alarmMaskType" minOccurs="0" maxOccurs="unbounded"/>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос: http://192.168.1.21:9999/commands/alarms_mask_list

<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_mask_list.xsd">
    <request mediator="md1"/>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarms_mask_list.xsd">
    <masks>
        <mask id="65353139-6135-6531-3935-333564323633" enabled="true" date="17.09.2017 15:44:10">
            <location value="ecss1"/>
            <ignoreClasses>
                <item value="hw::interfaces"/>
            </ignoreClasses>
            <ignoreInstances>
                <item value="bond1.2:2"/>
            </ignoreInstances>
        </mask>
    </masks>
</out>

Hc_node_rps_alarms

Команда позволяет включить/выключить систему мониторинга и вывода аварий.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/properties/rpss/set

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/node_rps_alarms

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

201 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:simpleType name = "stateType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="on"/>
            <xs:enumeration value="off"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="nodeType">
        <xs:attribute  name="name" type="xs:string" use="required"/>
        <xs:attribute  name="state" type="stateType" use="required"/>
    </xs:complexType>

    <xs:element name="in">
        <xs:complexType>
            <xs:all>
                <xs:element name="node" type="nodeType" minOccurs="1" maxOccurs="1"/>
            </xs:all>
    </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос: http://192.168.23.34:9999/commands/node_rps_alarms

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="node_rps_onoff.xsd">
    <node name="core@naomi" state="off" />
</in>

Hc_alarms_mask_add

Команда позволяет создать маску/маски для аварий.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/maskadd

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_mask_add

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

200 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

hc_alarms_mask_common.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xs:include schemaLocation="hc_alarms_mask_common.xsd"/>
    <!-- okType -->
    <xs:complexType name="okType">
        <xs:sequence>
            <xs:element name="mask" type="alarmMaskType" minOccurs="1" maxOccurs="1"/>
        </xs:sequence>
    </xs:complexType>
    <!-- errorReasonType -->
    <xs:simpleType name = "errorReasonType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="conflict" />
            <xs:enumeration value="notfound" />
        </xs:restriction>
    </xs:simpleType>
    <!-- errorType -->
    <xs:complexType name="errorType">
        <xs:sequence>
            <xs:element name="mask" type="alarmMaskType" minOccurs="1" maxOccurs="1"/>
            <xs:element name="conflictMask" type="alarmMaskType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
        <xs:attribute name="reason" type="errorReasonType" use="required"/>
    </xs:complexType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="masks">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="mask" type="alarmMaskType" minOccurs="0" maxOccurs="unbounded"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- out-->
    <xs:element name="out">
        <xs:complexType>
            <xs:all>
                <xs:element name="response">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="ok" type="okType" minOccurs="0" maxOccurs="unbounded"/>
                            <xs:element name="error" type="errorType" minOccurs="0" maxOccurs="unbounded"/>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:all>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос:
http://192.168.1.21:9999/commands/alarms_mask_add

<?xml version="1.0" encoding="UTF-8"?>
<in
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_mask_add.xsd">
    <request mediator="md1">
        <masks>
            <mask enabled="true">
                <location value="core1@ecss1"/>
                <class value="ecss::zmq::connection"/>
                <instance value="msr_2(192.168.2.22:5700)"/>
            </mask>
            <mask enabled="true">
                <location value="ecss1"/>
                <class value="hw::interfaces"/>
                <instance value="bond1.2:2"/>
            </mask>
        </masks>
    </request>
</in>

Ответ:

Код: 200

<?xml version="1.0"?>
<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarms_mask_add.xsd">
    <response>
        <ok>
            <mask id="65353163-6466-6334-3861-666566626238" enabled="true" date="17.09.2017 16:45:48">
                <location value="ecss1"/>
                <class value="hw::interfaces"/>
                <instance value="bond1.2:2"/>
            </mask>
        </ok>
        <ok>
            <mask id="65353163-3738-3161-3636-646462383537" enabled="true" date="17.09.2017 16:45:48">
                <location value="core1@ecss1"/>
                <class value="ecss::zmq::connection"/>
                <instance value="msr_2(192.168.2.22:5700)"/>
            </mask>
        </ok>
    </response>
</out>

Hc_alarms_mask_del

Команда позволяет удалить маску/маски для аварий.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/maskdel

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_mask_del

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить двумя сообщениями:

204 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <!-- alarmMaskType-->
    <xs:complexType name="alarmMaskType">
        <xs:attribute name="id" type="xs:string" use="required"/>
    </xs:complexType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="masks">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="mask" type="alarmMaskType" minOccurs="0" maxOccurs="unbounded"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Запрос:
http://192.168.1.21:9999/commands/alarms_mask_del

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_mask_del.xsd">
    <request mediator="md1">
        <masks>
            <mask id="65353163-6466-6334-3861-666566626238"/>
            <mask id="65353163-3738-3161-3636-646462383537"/>
        </masks>
    </request>
</in>

Ответ:

204

Hc_alarms_clear

Команда позволяет удалить аварии из системы по идентификатору.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/clear

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_clear

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

204 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла c запросом:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <!-- clearEventType -->
    <xs:complexType name="clearEventType">
        <xs:attribute name="id" type="xs:string" use="required"/>
    </xs:complexType>
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="events">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="event" type="clearEventType" maxOccurs="unbounded"/>
                        </xs:sequence>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                        <xs:attribute name="userId" type="xs:string" use="optional">
                            <xs:annotation>
                                <xs:documentation xml:lang="en">
                                    Deprecated attribute.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:attribute>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

rps.xsd:

См. схему запроса списка алармов в системе

Пример:

Запрос: http://192.168.1.21:9999/cluster/mediator/md/alarms_clear
Параметры:

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_clear.xsd">
    <events mediator="md1" userId="admin">
        <event id="65353164-3638-6234-6438-346364336565"/>
        <event id="65353164-3732-6634-3761-353230353337"/>
    </events>
</in>

Ответ: Пустой xml

Hc_alarms_delete

Команда позволяет удалить очищенные аварии из системы по следующим критериям:

последние N алармов;
алармы за определенный промежуток времени;
алармы с определенными идентификаторами;
все алармы.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/delete

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_delete

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

204 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла c запросом:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <!-- timeType-->
    <xs:complexType name="timeType">
        <xs:attribute name="year" type="xs:integer" use="required"/>
        <xs:attribute name="month" type="xs:integer" use="required"/>
        <xs:attribute name="day" type="xs:integer" use="required"/>
        <xs:attribute name="hour" type="xs:integer" use="required"/>
        <xs:attribute name="minute" type="xs:integer" use="required"/>
        <xs:attribute name="second" type="xs:integer" use="required"/>
    </xs:complexType>
    <!-- in -->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:choice>
                            <xs:element name="all">
                                <xs:complexType/>
                            </xs:element>
                            <xs:element name="last">
                                <xs:complexType>
                                    <xs:attribute name="count" type="xs:integer" use="required"/>
                                </xs:complexType>
                            </xs:element>
                            <xs:element name="between">
                                <xs:complexType>
                                    <xs:all>
                                        <xs:element name="from" type="timeType" minOccurs="0" maxOccurs="1"/>
                                        <xs:element name="to" type="timeType" minOccurs="0" maxOccurs="1"/>
                                    </xs:all>
                                </xs:complexType>
                            </xs:element>
                            <xs:element name="ids">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="id" minOccurs="0" maxOccurs="unbounded">
                                            <xs:complexType>
                                                <xs:attribute name="value" type="xs:string" use="required"/>
                                            </xs:complexType>
                                        </xs:element>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:choice>
                        <xs:attribute name="mediator" type="xs:string" use="required"/>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

Пример запроса удаления последних 10-ти алармов:

Запрос: http://192.168.1.21:9999/commands/alarms_delete
Параметры:

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_delete.xsd">
    <request mediator="md1">
        <last count="10" />
    </request>
</in>

Ответ: Пустой xml

Пример запроса удаления алармов, случившихся до 2017/09/15 12:00:00:

Запрос: http://192.168.1.21:9999/commands/alarms_delete
Параметры:

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_delete.xsd">
    <request mediator="md1">
        <between>
            <to day="15" month="9" year="2017" hour="12" minute="0" second="0" />
        </between>
    </request>
</in>

Ответ: Пустой xml

Пример запроса удаления алармов по идентификаторам:

Запрос: http://192.168.1.21:9999/commands/alarms_delete
Параметры:

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_delete.xsd">
    <request mediator="md1">
        <ids>
            <id value="65353164-3632-3436-6337-336565616266" />
            <id value="65353164-3632-3438-6532-663263303832" />
            <id value="65353164-3731-3361-6633-333566653135" />
        </ids>
    </request>
</in>

Ответ: Пустой xml

Пример запроса удаления всех алармов:

Запрос: http://192.168.1.21:9999/commands/alarms_delete
Параметры:

<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_delete.xsd">
    <request mediator="md1">
        <all/>
    </request>
</in>

Ответ: Пустой xml

Hc_alarm_notifiers_options_clean

Команда позволяет сбрасывать значения параметров службы уведомления по электронной почте или Jabber.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/clean
/domain/<DOMAIN>/alarms/notifiers/email/clean

/cluster/mediator/<CLUSTER>/alarms/notifiers/jabber/clean
/domain/<DOMAIN>/alarms/notifiers/jabber/clean

Шаблон HTTP-запроса:

http://host:port/commands/alarm_notifiers_options_clean

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

200 – в случае успеха;
404 – в случае ошибки.

XML-схема

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema
    xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xs:annotation>
        <xs:documentation xml:lang="en">
      Clean properties of alarm notifier service.
      Usage: http://server:9999/commands/alarm_notifiers_options_clean.
      Implementation: hc_alarm_notifiers_options_clean.erl.
      Git: git@git.eltex.loc:httpTerminal.git.
      Copyright (c) 2016, Eltex. All rights reserved.
    </xs:documentation>
    </xs:annotation>
    <xs:include schemaLocation="error.xsd"/>
    <xs:include schemaLocation="ecm_common.xsd"/>
    <!-- resultType-->
    <xs:complexType name="resultType">
        <xs:all>
            <xs:element name="domain_options" type="domainCleanOutType" minOccurs="1"/>
        </xs:all>
    </xs:complexType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:all>
                            <xs:element name="domain_options" type="domainCleanInType"/>
                        </xs:all>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- out -->
    <xs:element name="out">
        <xs:complexType>
            <xs:choice>
                <xs:element name="result" type="resultType"/>
                <xs:element name="error" type="errorType"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

http://192.168.1.21:9999/commands/alarm_notifiers_options_clean

Запрос:

<?xml version="1.0"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarm_notifiers_options_clean.xsd">
 <request>
    <domain_options>
        <system/>
        <domain name="biysk.local">
            <option name="email_body_limit"/>
            <option name="email_enabled"/>
            <option name="jabber_body_format"/>
            <option name="jabber_body_limit"/>
        </domain>
        <domain name="ct.office">
            <option name="email_body_limit"/>
            <option name="email_enabled"/>
            <option name="jabber_body_limit"/>
            <option name="jabber_enabled"/>
        </domain>
    </domain_options>
 </request>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarm_notifiers_options_clean.xsd">
    <result>
        <domain_options>
            <system/>
            <domain name="ct.office">
                <success option="email_body_limit"/>
                <success option="email_enabled"/>
                <success option="jabber_body_limit"/>
                <success option="jabber_enabled"/>
            </domain>
            <domain name="biysk.local">
                <success option="email_body_limit"/>
                <success option="email_enabled"/>
                <success option="jabber_body_format"/>
                <success option="jabber_body_limit"/>
            </domain>
        </domain_options>
    </result>
</out>

Hc_alarm_notifiers_options_info

Команда просмотра текущих настроек аварийных уведомлений, которые передаются через электронную почту или Jabber.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/info
/domain/<DOMAIN>/alarms/notifiers/email/info

/cluster/mediator/<CLUSTER>/alarms/notifiers/jabber/info
/domain/<DOMAIN>/alarms/notifiers/jabber/info

Шаблон HTTP-запроса:

http://host:port/commands/alarm_notifiers_options_info

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

200 – в случае успеха;
404 – в случае ошибки.

XML-схема

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema
    xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
           attributeFormDefault="unqualified">
    <xs:annotation>
        <xs:documentation xml:lang="en">
            Show properties of alarm notifier service.
            Usage: http://server:9999/commands/alarm_notifiers_options_info.
            Implementation: hc_alarm_notifiers_options_info.erl.
            Git: git@git.eltex.loc:httpTerminal.git.
            Copyright (c) 2016, Eltex. All rights reserved.
        </xs:documentation>
    </xs:annotation>
    <xs:include schemaLocation="error.xsd"/>
    <xs:include schemaLocation="ecm_common.xsd"/>
    <xs:complexType name="alarmNotifiersOptionsType">
        <xs:complexContent>
            <xs:extension base="baseOptionsType">
                <xs:attribute name="email_body_format" type="xs:string" use="optional"/>
                <xs:attribute name="email_body_limit" type="xs:string" use="optional"/>
                <xs:attribute name="email_enabled" type="booleanType" use="optional"/>
                <xs:attribute name="email_from_name" type="xs:string" use="optional"/>
                <xs:attribute name="email_subject_format" type="xs:string" use="optional"/>
                <xs:attribute name="email_subject_limit" type="xs:string" use="optional"/>
                <xs:attribute name="to_emails" type="xs:string" use="optional">
                    <xs:annotation>
                        <xs:documentation xml:lang="en">
                            The list of email addresses separated by ";".
                        </xs:documentation>
                    </xs:annotation>
                </xs:attribute>
                <xs:attribute name="email_to_name" type="xs:string" use="optional"/>
                <xs:attribute name="jabber_body_format" type="xs:string" use="optional"/>
                <xs:attribute name="jabber_body_limit" type="xs:string" use="optional"/>
                <xs:attribute name="jabber_enabled" type="booleanType" use="optional"/>
                <xs:attribute name="to_jids" type="xs:string" use="optional">
                    <xs:annotation>
                        <xs:documentation xml:lang="en">
                            The list of jabber addresses separated by ";".
                        </xs:documentation>
                    </xs:annotation>
                </xs:attribute>
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
    <!-- resultType-->
    <xs:complexType name="resultType">
        <xs:all>
            <xs:element name="domain_options" type="domainInfoOutType" minOccurs="1"/>
        </xs:all>
    </xs:complexType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:all>
                            <xs:element name="domain_options" type="domainInfoInType" minOccurs="1"/>
                        </xs:all>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- out -->
    <xs:element name="out">
        <xs:complexType>
            <xs:choice>
                <xs:element name="result" type="resultType"/>
                <xs:element name="error" type="errorType"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

http://192.168.1.21:9999/commands/alarm_notifiers_options_info

Запрос:

<?xml version="1.0"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarm_notifiers_options_info.xsd">
    <request>
         <domain_options domain="biysk.local"/>
    </request>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarm_notifiers_options_info.xsd">
    <result>
        <domain_options>
            <system>
                <options xs:type="alarmNotifiersOptionsType"/>
            </system>
            <domain name="biysk.local">
                <options xs:type="alarmNotifiersOptionsType" to_jids="" to_emails="" jabber_enabled="false" jabber_body_limit="1000" jabber_body_format="Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nTime: %TIME% ~nText: %TEXT%" email_to_name="ECSS-SUPPORT" email_subject_limit="50" email_subject_format="ALARM (%SEVERITY%)" email_from_name="ECSS-NO-REPLY" email_enabled="false" email_body_limit="1000" email_body_format="Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nTime: %TIME% ~nText: %TEXT%"/>
            </domain>
        </domain_options>
    </result>
</out>

Hc_alarm_notifiers_options_set

Команда настройки параметров уведомления, отправляемого по электронной почте или Jabber.

Аналог команды в CoCon:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set
/domain/<DOMAIN>/alarms/notifiers/email/set

/cluster/mediator/<CLUSTER>/alarms/notifiers/jabber/set
/domain/<DOMAIN>/alarms/notifiers/jabber/set

Шаблон HTTP-запроса:

http://host:port/commands/alarm_notifiers_options_set

Код HTTP-ответа:

При выполнении команды HTTP-терминал может ответить следующими сообщениями:

200 – в случае успеха;
404 – в случае ошибки.

XML-схема

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
           attributeFormDefault="unqualified">
    <xs:annotation>
        <xs:documentation xml:lang="en">
            Set properties of alarm notifier service.
            Usage: http://server:9999/commands/alarm_notifiers_options_set.
            Implementation: hc_alarm_notifiers_options_set.erl.
            Git: git@git.eltex.loc:httpTerminal.git.
            Copyright (c) 2016, Eltex. All rights reserved.
        </xs:documentation>
    </xs:annotation>
    <xs:include schemaLocation="error.xsd"/>
    <xs:include schemaLocation="ecm_common.xsd"/>

          
    <!-- Types -->
    <xs:complexType name="alarmNotifiersOptionsType">
        <xs:complexContent>
            <xs:extension base="baseOptionsType">
                <xs:attribute name="email_body_format" type="xs:string" use="optional"/>
                <xs:attribute name="email_body_limit" type="xs:string" use="optional"/>
                <xs:attribute name="email_enabled" type="booleanType" use="optional"/>
                <xs:attribute name="email_from_name" type="xs:string" use="optional"/>
                <xs:attribute name="email_subject_format" type="xs:string" use="optional"/>
                <xs:attribute name="email_subject_limit" type="xs:string" use="optional"/>
                <xs:attribute name="to_emails" type="xs:string" use="optional">
                    <xs:annotation>
                        <xs:documentation xml:lang="en">
                            The list of email addresses separated by ";".
                        </xs:documentation>
                    </xs:annotation>
                </xs:attribute>
                <xs:attribute name="email_to_name" type="xs:string" use="optional"/>
                <xs:attribute name="jabber_body_format" type="xs:string" use="optional"/>
                <xs:attribute name="jabber_body_limit" type="xs:string" use="optional"/>
                <xs:attribute name="jabber_enabled" type="booleanType" use="optional"/>
                <xs:attribute name="to_jids" type="xs:string" use="optional">
                    <xs:annotation>
                        <xs:documentation xml:lang="en">
                            The list of jabber addresses separated by ";".
                        </xs:documentation>
                    </xs:annotation>
                </xs:attribute>

          
            </xs:extension>
        </xs:complexContent>
    </xs:complexType>
    <!-- resultType-->
    <xs:complexType name="resultType">
        <xs:all>
            <xs:element name="domain_options" type="domainSetOutType" minOccurs="1"/>
        </xs:all>
    </xs:complexType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:all>
                            <xs:element name="domain_options" type="domainSetInType"/>
                        </xs:all>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- out -->
    <xs:element name="out">
        <xs:complexType>
            <xs:choice>
                <xs:element name="result" type="resultType" minOccurs="1" maxOccurs="1"/>
                <xs:element name="error" type="errorType" minOccurs="1" maxOccurs="1"/>
            </xs:choice>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример:

http://192.168.1.21:9999/commands/alarm_notifiers_options_set

Запрос:

<?xml version="1.0"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarm_notifiers_options_set.xsd">
  <request>
    <domain_options>
      <system>
        <options xs:type="alarmNotifiersOptionsType"/>
      </system>
      <domain name="biysk.local">
        <options xs:type="alarmNotifiersOptionsType" email_body_limit="1500" email_enabled="false" email_from_name="ECSS-NO-REPLY-ALARM-NOTIFICATOR" email_subject_limit="75"/>
      </domain>
      <domain name="ct.office">
        <options xs:type="alarmNotifiersOptionsType" email_body_limit="1300"/>
      </domain>
    </domain_options>
  </request>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarm_notifiers_options_set.xsd">
    <result>
        <domain_options>
            <system/>
            <domain name="ct.office">
                <success option="email_body_limit"/>
            </domain>
            <domain name="biysk.local">
                <success option="email_body_limit"/>
                <success option="email_enabled"/>
                <success option="email_from_name"/>
                <success option="email_subject_limit"/>
            </domain>
        </domain_options>
    </result>
</out>

Hc_alarms_notifiers_send_test_msg

Команда позволяет послать тестовое сообщение об аварии на ECSS-10 по почте/jabber.

Аналог команды в CoCon:

cluster/mediator/<CLUSTER>/alarms/notifiers/email/send_test_email
domain/<DOMAIN>/alarms/notifiers/email/send_test_email

cluster/mediator/<CLUSTER>/alarms/notifiers/jabber/send_test_email
domain/<DOMAIN>/alarms/notifiers/jabber/send_test_email

Метод HTTP-запроса:

POST

Шаблон HTTP-запроса:

http://host:port/commands/alarms_notifiers_send_test_msg

Код HTTP-ответа:

200 – в случае успеха;
404 – в случае ошибки.

XSD-схема XML-файла запроса/ответа:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xs:include schemaLocation="error.xsd" />
    <xs:simpleType name="typeType">
        <xs:restriction base="xs:string">
            <xs:enumeration value="email"/>
            <xs:enumeration value="jabber"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- in-->
    <xs:element name="in">
        <xs:complexType>
            <xs:all>
                <xs:element name="request">
                    <xs:complexType>
                        <xs:attribute name="domain" type="xs:string" use="required"/>
                        <xs:attribute name="type" type="typeType" use="required"/>
                        <xs:attribute name="msg" type="xs:string" use="optional"/>
                    </xs:complexType>
                </xs:element>
            </xs:all>
        </xs:complexType>
    </xs:element>

          
    <!-- out-->
    <xs:element name="out">
        <xs:complexType>
            <xs:choice>
                <!--Positive case-->
                <xs:element name="response">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="ok"/>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
                <!--Or error-->
                <xs:element name="error" type="errorType"/>
          </xs:choice>
        </xs:complexType>
    </xs:element>
</xs:schema>

Пример

Запрос: http://192.168.1.21:9999/commands/alarms_notifiers_send_test_msg

<?xml version="1.0"?>
<in xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="hc_alarms_notifiers_send_test.xsd">
  <request domain="biysk.local" type="email" msg="Test1 message"/>
</in>

Ответ:

<?xml version="1.0"?>
<out
    xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="hc_alarms_notifiers_send_test.xsd">
    <response>
        <ok/>
    </response>
</out>

Быстрые ссылки

Дерево страниц

Hc_ap_speaker_off

Hc_ap_status

Hc_alarms_list

Hc_alarms_mask_list

Hc_node_rps_alarms

Hc_alarms_mask_add

Hc_alarms_mask_del

Hc_alarms_clear

Hc_alarms_delete

Hc_alarm_notifiers_options_clean

Hc_alarm_notifiers_options_info

Hc_alarm_notifiers_options_set

Hc_alarms_notifiers_send_test_msg

Быстрые ссылки

Дерево страниц

Hc_alarms - Управление системой мониторинга и вывода аварий

Hc_ap_speaker_off

Hc_ap_status

Hc_alarms_list

Hc_alarms_mask_list

Hc_node_rps_alarms

Hc_alarms_mask_add

Hc_alarms_mask_del

Hc_alarms_clear

Hc_alarms_delete

Hc_alarm_notifiers_options_clean

Hc_alarm_notifiers_options_info

Hc_alarm_notifiers_options_set

Hc_alarms_notifiers_send_test_msg