Справочный центр Wialon
Wialon для разработчиков Руководство пользователя Документация API core create_retranslator

create_retranslator

Чтобы создать новый ретранслятор, используйте метод core/create_retranslator.

Copied!
svc=core/create_retranslator&params={
  "creatorId": <long>,
  "name": "<text>",
  "config": {
    "protocol": "<text>",
    "server": "<text>",
    "port": <ushort>,
    "auth": "<text>",
    "ssl": <int>,
    "debug": <int>,
    "v6type": <int>
  },
  "dataFlags": <uint>
}

Параметры

Параметр Описание
creatorId ID пользователя, который должен быть создателем ретранслятора.
name Имя ретранслятора (4–50 символов).
config Конфигурация ретранслятора.
protocol ID протокола (см. update_config).
server Сервер ретрансляции.
port Порт (для всех протоколов, кроме NIS).
auth Авторизация (только для протоколов NIS и Wialon IPS).
ssl Использование SSL (для NIS):
  • 0: нет;
  • 1: да.
debug Использование режима отладки:
  • 0: нет;
  • 1: да.
v6type Использование протокола версии 6 (только для Granit Navigator):
  • 0: нет;
  • 1: да.
dataFlags Флаги со свойствами ретранслятора для ответа (см. Ретрансляторы).

Ответ

В случае успешного выполнения запроса возвращается ответ следующего формата:

Copied!
{
  "item": {         /* Созданный ретранслятор. */
    ...
  },
  "flags": <uint>   /* Примененные флаги со свойствами. */
}

Формат параметра item описан на странице Ретрансляторы.

В случае неудачного выполнения запроса возвращается код ошибки.

Коды ошибок

Код ошибки Описание
4 Одна из следующих ошибок:
  • Неверные входные параметры.
  • Не удалось проверить конфигурацию.
  • Не удалось создать ретранслятор с указанным протоколом (подробности см. в поле reason).
6 Одна из следующих ошибок:
  • Не удалось получить создателя, или у вас нет права доступа Выполнение действий от имени пользователя на создателя.
  • У текущего пользователя нет флага Может создавать элементы (0x04).
  • Не удалось создать ретранслятор.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.