/domain/<DOMAIN>/sip/user/profile/ - команды настройки профиля абонентов SIP
В данном разделе приводится описание команд управления команды настройки профиля абонентов SIP.
Общее описание работы SIP-профилей приведено в разделе SIP-профили.
<DOMAIN> - имя виртуальной АТС.
clean
Команда предназначена для сброса параметров профиля абонента SIP в значение по умолчанию. При необходимости можно сбросить все параметры профиля. Сам профиль удален при этом не будет.
В команде допустим ключ --force
, при котором предупреждение будет пропущено. Актуально, например, при работе через скрипт. По "tab" не подставляется!
Путь команды:
/domain/<DOMAIN>/sip/user/profile/clean
Синтаксис:
clean PROFILE_ID [--force]
Параметры:
<PROFILE_ID> - существующий или новый ID профиля;
[--force] - удаление без дополнительного подтверждения.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/user/profile/clean vp12 [clean] Set parameters to default value continue: yes/no ?> domain/biysk.local/sip/user/profile/clean vp12 Executed on the sip1@ecss2 ┌──────────┬──────────────────────────────┐ │Profile ID│ Profile set │ ├──────────┼──────────────────────────────┤ │vp12 │auto-answer-version = default │ │ │concurency_blf = false │ │ │direct_early_update = false │ │ │extended_blf = false │ │ │force_fork_release = false │ │ │node_control = false │ │ │remote_party_id_enable = false│ │ │templates = - │ └──────────┴──────────────────────────────┘ [exec at: 12.03.2021 15:33:44, exec time: 12s 473ms, nodes: sip1@ecss2 v.3.14.8.26]
del
Команда предназначена для удаления профиля абонента SIP.
В команде допустим ключ --force
, при котором предупреждение будет пропущено. Актуально, например, при работе через скрипт. По "tab" не подставляется!
Путь команды:
/domain/<DOMAIN>/sip/user/profile/del
Синтаксис:
del PROFILE_ID [--force]
Параметры:
<PROFILE_ID> - существующий или новый ID профиля;
[--force] - удаление без дополнительного подтверждения.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/user/profile/del vp12 [del] Remove profiles. Undo will be impossible continue: yes/no ?> yes Executed on the sip1@ecss1 ok [exec at: 12.03.2021 15:33:57, exec time: 1s 858ms, nodes: sip1@ecss1 v.3.14.8.26]
info
Команда предназначена для просмотра информации о профиле абонента SIP.
Путь команды:
/domain/<DOMAIN>/sip/user/profile/info
Синтаксис:
info PROFILE_ID
Параметры:
<PROFILE_ID> - существующий или новый ID профиля.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/user/profile/info vp12 Executed on the sip1@ecss1 ┌──────────┬──────────────────────────────────────────────┐ │Profile ID│ Profile set │ ├──────────┼──────────────────────────────────────────────┤ │vp12 │auto-answer-version = Alert-Info: Auto Answer │ │ │concurency_blf = false │ │ │direct_early_update = false │ │ │extended_blf = false │ │ │force_fork_release = false │ │ │node_control = false │ │ │remote_party_id_enable = false │ │ │templates = - │ └──────────┴──────────────────────────────────────────────┘ [exec at: 12.03.2021 15:32:49, exec time: 5ms, nodes: sip1@ecss1 v.3.14.8.26]
list
Команда предназначена для просмотра списка профилей абонента SIP. Возвращает список имеющихся профилей, включая шаблон авто определения.
Путь команды:
/domain/<DOMAIN>/sip/user/profile/list
Синтаксис:
list
Параметры:
Команда не содержит аргументов.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/user/profile/list Executed on the sip1@ecss2 ┌──────────┬───────────────────┐ │Profile ID│User-Agent template│ ├──────────┼───────────────────┤ │vp12 │ │ └──────────┴───────────────────┘ [exec at: 12.03.2021 15:33:17, exec time: 13ms, nodes: sip1@ecss2 v.3.14.8.26]
preset
Команда предназначена для активации заранее сконфигурированного профиля.
Путь команды:
/domain/<DOMAIN>/sip/user/profile/preset
Синтаксис:
preset PROFILE_ID
Параметры:
PROFILE_ID - идентификатор существующего профиля.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/user/profile/preset coral Executed on the sip1@ecss1 New profile 'coral' was created [exec at: 15.03.2021 15:32:38, exec time: 10ms, nodes: sip1@ecss1 v.3.14.8.34]
set
Команда позволяет задать параметры профиля SIP-клиента. Если ID не существует, то команда задает новый профиль.
При первой настройке профиль с указанным именем будет создан автоматически. Указывать одновременно можно один и более параметров через запятую. Шаблон агента вводится в кавычках, если содержит пробелы.
Внимание! Вхождение шаблона проверяется без учета регистра, но с учетом количества указанных пробелов!
Результат команды:
new - создан новый профиль с указанными именем и параметрами (неуказанные параметры принимают значения "по умолчанию");
exists - указаны уже установленные параметры существующему профилю;
change - параметр (параметры) существующего профиля изменены.
Путь команды:
/domain/<DOMAIN>/sip/user/profile/set
Синтаксис:
set PROFILE_ID KEY = VALUE[, ...]
Параметры:
<PROFILE_ID> - существующий или новый ID профиля; <KEY> - название параметра, который разрешен:
- auto_answer_version - реализация авто ответа.;
- concurency_blf - нотификации о параллельных диалогах. Значения true|false (по умолчанию - false);
- node_control - ограничение исходящих вызовов нодой-регистратором. Значения true|false (по умолчанию - false);
- templates - шаблон имени, содержащийся в заголовке User-Agent запроса регистрации;
- blf_xml_pretty_print - возможность форматирования xml в NOTIFY BLF. Значения true|false (по умолчанию - false).
- remote_party_id_enable - Включение/выключение передачи заголовка Remote-Party-ID (используется в сервисе pickup) true|false (по умолчанию - false).
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/user/profile/set vp12 auto-answer-version alert-info template: "Auto Answer" Executed on the sip1@ecss1 New profile 'vp12' was created [exec at: 12.03.2021 15:32:30, exec time: 11ms, nodes: sip1@ecss1 v.3.14.8.26]