GetInitStatus – Получить статус инициализации устройства по MAC-адресу

Общая информация

  1. Команда актуальна, начиная с версии 1.5

Входные параметры

Параметр Значение Формат значения Расшифровка формата Ссылка

mac

MAC-адрес точки доступа.

^([0-9a-fA-F]{2}[:-]){5}([0-9a-fA-F]{2})$

6 двузначных шестнадцатеричных чисел, разделенных ':'.

Выходные параметры

Параметр Значение Формат значения

code

Код ответа

Целое неотрицательное число.

detail

Пояснение к ответу

Текст английскими буквами с пробелами и спецсимволами.

response

Статус инициализации устройства.

Одно из следующих состояний:
«NEVER» - устройство находится в песочнице, но инициализации не производилось;
«IN_PROGRESS» - инициализация в процессе выполнения;
«SUCCESSFUL» - инициализация успешно завершена;
«FAILED» - инициализация завершена с неуспехом;
«INTERRUPTED» - инициализация прервана;
«MAC_ALREADY_EXIST» - при инициализации обнаружено, что устройство с данным маком уже есть в системе EMS;
«UPDATE_IN_PROGRESS» - обновление уже существующего устройства;
«UPDATE_FAILED» - обновление уже существующего устройства завершено с неуспехом ;
«NO_IN_SANDBOX» - устройства нет в песочнице.

Примеры команд и кодов

Код Описание ошибки

63

MAC-адрес не задан или имеет некорректный формат
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:GetInitStatus>
            <xsd:mac>a8:f9:4b:1f:f3:e</xsd:mac>
        </xsd:GetInitStatus>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:GetInitStatusResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>63</ns:code>
                <ns:detail>Incorrect field 'mac'</ns:detail>
                <ns:response/>
            </ns:return>
        </ns:GetInitStatusResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

0

Успешно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:GetInitStatus>
            <xsd:mac>a8:f9:4b:1f:f3:e0</xsd:mac>
        </xsd:GetInitStatus>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:GetInitStatusResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail/>
                <ns:response>SUCCESSFUL</ns:response>
            </ns:return>
        </ns:GetInitStatusResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.29-3315
Дата публикации 01-02-2024 12:35:34