Джим Меггелен - Asterisk™: будущее телефонии Второе издание
Возвращает запись AstDB
Эта команда извлекает значение из базы данных AstDB.
Параметры
Family
[обязательный] Семейство ключей AstDB, из которого извлекается значение.
Key
[обязательный] Имя ключа AstDB.
ActionID
Привилегии
system,all
Пример
Action: DBGet Family: testfamily Key: mykey
ActionID: 01234-astdb-43210
Response: Success Message: Result will follow ActionID: 01234-astdb-43210
Event: DBGetResponse Family: testfamily Key: mykey Val: 42
ActionID: 01234-astdb-43210
DBPut
Сохраняет запись в базе данных
Задает значение ключа в базе данных AstDB.
Параметры
Family
[обязательный] Семейство ключей AstDB, для которого задается значение.
Key
[обязательный] Имя ключа AstDB.
Val
[обязательный] Значение, которое должно быть присвоено ключу.
ActionID
[необязательный] Идентификатор, который может использоваться для опознавания ответа на эту команду.
Привилегии
system, all
Пример
Action: DBPut Family: testfamily Key: mykey Val: 42
ActionID: testing123
Response: Success
Message: Updated database successfully ActionID: testing123
Events
Управляет потоком событий
Активирует или отключает отправку событий на это соединение интерфейса Manager.
Параметры
EventMask
[обязательный] Задайте значение on, если должны отправляться все события, off, если события не должны передаваться, или system, call, log, чтобы выбрать тип событий, который должен отправляться на это соединение интерфейса Manager.
ActionID
[необязательный] Идентификатор, который может использоваться для опознавания ответа на эту команду.
Привилегии
none
Пример
Action: Events EventMask: off ActionID: 2938416
Response: Events Off ActionID: 2938416
Action: Events EventMask: log,call ActionID: blah1234
Response: Events On ActionID: blah1234
ExtensionState
Проверяет состояние добавочного номера
Exten
[обязательный] Имя проверяемого добавочного номера.
Context
[обязательный] Имя контекста, в котором находится заданный добавочный номер.
ActionId
[необязательный] Идентификатор команды, который может использоваться для опознавания этой транзакции интерфейса Manager.
Привилегии
call, all
Пример
Action: ExtensionState Exten: 200 Context: lab ActionID: 54321
Response: Success
ActionID: 54321
Message: Extension Status
Exten: 200
Context: lab
Hint: SIP/testphone
Status: 0
Примечания
Вот возможные состояния добавочного номера: Добавочный номер удален. Подсказка добавочного номера не обнаружена.
0
Свободен. Используется.
GetConfig
Возвращает конфигурацию
Извлекает данные из конфигурационного файла Asterisk.
Параметры
Filename
[обязательный] Имя конфигурационного файла, из которого должны извлекаться данные.
ActionID
[необязательный] Идентификатор, который может использоваться для опознавания ответа на эту команду.
Привилегии
config, all
Пример
Action: GetConfig Filename: musiconhold.conf ActionID: 09235012
Response: Success ActionID: 09235012 Category-000000: default Line-000000-000000: mode=files
Line-000000-000001: directory=/var/lib/asterisk/moh Line-000000-000002: random=yes
GetVar
Возвращает значение переменной
Возвращает значение локальной переменной канала или глобальной переменной.
Параметры
Channel
[необязательный] Имя канала, значение переменной которого должно быть возвращено.
Variable
[обязательный] Имя переменной.
ActionID
Привилегии
call, all
Пример
Action: GetVar
Channel: SIP/linksys2-1020e2b0 Variable: SIPUSERAGENT ActionID: abcd1234
Response: Success Variable: SIPUSERAGENT Value: Linksys/SPA962-5.1.5 ActionID: abcd1234
Action: GetVar Variable: TRUNKMSD
Response: Success Variable: TRUNKMSD Value: 1
Hangup
Выполняет разъединение канала
Выполняет разрыв соединения по заданному каналу.
Параметры
Channel
[необязательный] Имя канала, разъединение которого должно быть выполнено.
ActionID
[необязательный] Идентификатор, который может использоваться для опознавания ответа на эту команду.
Привилегии
call, all
Пример
Action: Hangup Channel: SIP/labrat-8d3a
Response: Success Message: Channel Hungup
Event: Hangup Privilege: call,all
Channel: SIP/labrat-8d3a Uniqueid: 1173448206.0 Cause: 0
Cause-txt: Unknown
lAXNetstats
Представляет статистику IAX
Представляет сводку статистки сетевой активности драйвера IAX2- канала.
Привилегии
none
Пример
Action: IAXNetstats
IAX2/216.207.245.8:4569-1 608 -1 0 -1 -1 0 -1 1 288 508 10 1 3 0 0
lAXPeers
Создает список равноправных участников IAX
Создает список всех равноправных участников IAX2 с указанием их текущего статуса.
Привилегии
none
Пример
Action: IAXPeers
Name/Username Host Mask Port StatusName/Username Host Mask Port Status jared/jared 192.168.0.71 (S) 255.255.255.255 4569 UNREACHABLE jaredsmith 192.168.0.72 (S) 255.255.255.255 4569 OK (43 ms) arrivaltel/8017 172.20.95.2 (S) 255.255.255.255 4569 Unmonitored sokol/jsmith 172.17.122.217 (S) 255.255.255.255 4569 OK (48 ms) demo/asterisk 216.207.245.47 (S) 255.255.255.255 4569 Unmonitored5 iax2 peers [2 online, 1 offline, 2 unmonitored]
ListCommands
Создает список команд интерфейса ManagerПривилегии
none
Пример
Action: ListCommands
Response: Success
AbsoluteTimeout: Set Absolute Timeout (Priv: call,all)
AgentCallbackLogin: Sets an agent as logged in by callback (Priv: agent,all) AgentLogoff: Sets an agent as no longer logged in (Priv: agent,all)
ZapTransfer: Transfer Zap Channel (Priv: <none>)
Logoff
Завершает сеанс интерфейса Manager
Завершает данный сеанс интерфейса Manager.
Привилегии
none
Пример
Action: Logoff
Response: Goodbye
Message: Thanks for all the fish.
MailboxCount
Проверяет количество сообщений в почтовом ящике
Возвращает количество сообщений в заданном ящике голосовой почты.
Привилегии
call, all
Пример
Action: MailboxCount Mailbox: [email protected] ActionID: 54321abcde
Response: Success ActionID: 54321abcde Message: Mailbox Message Count Mailbox: [email protected] NewMessages: 2 OldMessages: 0
MailboxStatus
Проверяет статус почтового ящика
Проверяет статус заданного ящика голосовой почты.
Параметры
Mailbox
[обязательный] Полный идентификатор почтового ящика, включая почтовый ящик и контекст (ящик контекст).
ActionID
[необязательный] Уникальный идентификатор, который может использоваться для опознавания ответов на эту команду интерфейса Manager.
Привилегии
call, all
Пример
Action: MailboxStatus Mailbox: [email protected] ActionID: abcdef0123456789
Response: Success ActionID: abcdef0123456789 Message: Mailbox Status Mailbox: [email protected] Waiting: 1
MeetmeMute
Выключает микрофон пользователя MeetMe
Выключает микрофон конкретного пользователя, участвующего в конференции MeetMe.
Параметры
Meetme
[обязательный] Номер конференции MeetMe.
Usernum
[обязательный] Номер абонента в заданной конференции.
ActionID
call, all
Пример
Action: MeetmeMute Meetme: 104 Usernum: 1
ActionID: 5432154321
Response: Success ActionID: 5432154321 Message: User muted
Event: MeetmeMute
Privilege: call,all
Channel: SIP/linksys2-10211dc0
Uniqueid: 1174008176.3
Meetme: 104
Usernum: 1
Status: on
Примечания
Чтобы найти номер Usernum конкретного вызывающего абонента, понаблюдайте за интерфейсом Asterisk Manager при входе нового участника в конференцию. Когда это произойдет, вы увидите такое событие:
Event: MeetmeJoin Privilege: call,all Channel: SIP/linksys2-10211dc0 Uniqueid: 1174008176.3 Meetme: 104 Usernum: 1
MeetMeUnmute
Включает микрофон пользователя MeetMe
Включает микрофон заданного пользователя в конференции MeetMe.
Параметры
Meetme
[обязательный] Номер конференции MeetMe.
Usernum
[обязательный] Номер пользователя в заданной конференции.
ActionID
call, all
Пример
Action: MeetmeUnmute Meetme: 104 Usernum: 1
ActionID: abcdefghijklmnop
Response: Success ActionID: abcdefghijklmnop Message: User unmuted
Event: MeetmeMute
Privilege: call,all
Channel: SIP/linksys2-10211dc0
Uniqueid: 1174008176.3
Meetme: 104
Usernum: 1
Status: off
Monitor
Записывает разговор по каналу
Записывает аудиоданные, передаваемые по каналу, в заданный файл.
Параметры
Channel
[обязательный] Определяет канал, разговор по которому будет записываться.
File
[необязательный] Имя файла, в который производится запись разговора по каналу. По умолчанию запись ведется в папку очереди для записи разговоров Asterisk, которой обычно является /var/spool/ asterisk/monitor. Если имя файла не задано, в качестве него используется имя канала, при этом символы слэша заменяются на тире.
