Читать онлайн «Asterisk™: будущее телефонии Второе издание». Страница 123

Возвращает запись 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 Unmonitored

5 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. Если имя файла не задано, в качестве него используется имя канала, при этом символы слэша заменяются на тире.