IVA ДОКУМЕНТАЦИЯ ОБНОВЛЕНИЯ

Справочник команд CLI

Общие сведения

Справочник содержит команды интерфейса командной строки CLI сервера IVA Mail, сгруппированные по объектам и задачам.

Правила записи команд (кавычки, необязательные параметры, альтернативы, массивы и объекты JSON) описаны в разделе Правила записи команд.

Общие параметры

Параметры из таблицы встречаются во многих командах и в описаниях команд отдельно не поясняются.

Параметр Описание

"domName"|domUID

Домен: имя в кавычках или числовой UID.

"accName"|accUID

Аккаунт: имя в кавычках или числовой UID.

"objName"|objUID

Объект домена (аккаунт, ресурсный аккаунт, группа, переадресатор, список рассылки): имя в кавычках или числовой UID.

"key"|["key1","key2",..]

Настройка: ключ или путь к вложенной настройке в виде массива ключей. Путь можно также записать строкой через точку: "key1.key2".

{object}

Значение настройки — любой объект JSON.

null вместо домена

Команда действует на уровне сервера или кластера (если это допускает команда).

deleteKeys

Массив ключей настроек, которые нужно удалить. Вместо них будут действовать значения по умолчанию.

updateKeyVals

Массив вида ключ1,значение1,ключ2,значение2,…​ с новыми значениями настроек.

settingsDict|settingsKeyValArray

Настройки создаваемого объекта: словарь или массив с чередующимися названиями настроек и их значениями.


Общие команды

Quit

Назначение

Завершает CLI-сессию и закрывает соединение.

Синтаксис
Quit

Shutdown

Назначение

Останавливает сервер.

Синтаксис
Shutdown

Inline

Назначение

Переключает режим вывода объектов в результатах команд между компактным и многострочным.

Синтаксис
Inline

Ext

Назначение

Переключает режим вывода объектов в результатах команд между стандартным и расширенным.

Синтаксис
Ext

NoTimeout

Назначение

Устанавливает тайм-аут чтения в соединении в 365 дней.

Синтаксис
NoTimeout

NoEscape

Назначение

Переключает флаг экранирования служебных символов в выводе последующих команд.

Синтаксис
NoEscape

Help

Назначение

Выводит список команд с возможностью фильтрации.

Синтаксис
Help ("search")
Параметр Описание

search

Параметр фильтрации при поиске команд (при необходимости).


Ping

Назначение

Отвечает фиксированным сообщением.

Синтаксис
Ping

RaiseMem

Назначение

Вызывает аварийное завершение процесса с генерацией системного сигнала SIGSEGV.

Используется для проверки создания отладочных образов памяти выполняемой программы core dump.

Синтаксис
RaiseMem

SchemaDump

Назначение

Выдаёт описание схемы настроек.

Синтаксис
SchemaDump "type" (false)
Параметр Описание

type

Имя схемы настроек. Если указана пустая строка, возвращается список известных схем.

false

При задании этого параметра описания объектов в схеме не содержат прав доступа


ModulesList

Назначение

Выдаёт список инициализированных модулей.

Синтаксис
ModulesList

MailModulesList

Назначение

Выдаёт список инициализированных почтовых модулей.

Синтаксис
MailModulesList

MailQueueList

Назначение

Выдаёт сведения о почтовой очереди модуля. Если имя модуля не указано или пустое, выдаётся общая очередь.

Синтаксис
MailQueueList ("moduleName" (start limit))
Параметр Описание

moduleName

Имя почтового модуля. Если не указано или пустое — общая очередь.

start

Список начинается с QUEUE ID больше указанного.

limit

Максимальное количество записей. Если 0 — возвращается число писем в очереди.

Пример
MailQueueList "SMTP"

MailBatchList

Назначение

Выдаёт сведения об активных или ожидающих блоках доставки в очереди почтового модуля.

Синтаксис
MailBatchList "moduleName" (true|false) (start limit)
Параметр Описание

moduleName

Имя почтового модуля.

start

Список начинается с QUEUE ID больше указанного.

limit

Максимальное количество записей. Если 0 — возвращается число блоков доставки.


ModuleReadConfig

Назначение

Выдаёт словарь настроек модуля.

Синтаксис
ModuleReadConfig "moduleName" (true)
Параметр Описание

moduleName

Имя почтового модуля.

true|false

Не обязательный параметр. Если задано true, то словарь с настройками содержит описание полей. Если задано false, то словарь не содержит настройки по умолчанию.


ModuleUpdateConfig

Назначение

Обновляет настройки модуля.

Синтаксис
ModuleUpdateConfig "moduleName" deleteKeys updateKeyVals
Параметр Описание

moduleName

Имя модуля.

deleteKeys

Массив ключей для удаления из настроек (вместо них будут использоваться значения по умолчанию).

updateKeyVals

Массив пар ключ-значение, по которому значения указанных ключей заменяются на новые.


ModuleSetLogLevel

Назначение

Изменяет уровень журналирования модуля.

Синтаксис
ModuleSetLogLevel "moduleName" level
Параметр Описание

moduleName

Имя модуля.

level

Уровень журналирования.

Уровни журналирования
Значение Уровень

0

Критические ошибки

1

Ошибки

2

Информация

3

Предупреждения

4

Подробности

5

Отладочный

Пример
ModuleSetLogLevel "IMAP" 0

ModuleGetSetting

Назначение

Выдаёт объект настроек модуля.

Синтаксис
ModuleGetSetting "moduleName" "key"|["key1","key2",..]
Параметр Описание

moduleName

Имя модуля.

"key"|["key1","key2",…​]

Объект/объекты настроек модуля.


ModuleSetSetting

Назначение

Устанавливает объект настроек модуля.

Синтаксис
ModuleSetSetting "moduleName" "key"|["key1","key2",..] {object}

ModuleDelSetting

Назначение

Удаляет объект настроек модуля и возвращает значение по умолчанию.

Синтаксис
ModuleDelSetting "moduleName" "key"|["key1","key2",..]
Параметр Описание

moduleName

Имя модуля.

"key"|["key1","key2",…​]

Объект/объекты настроек модуля.


DigestList

Назначение

Выдаёт список методов хэширования.

Синтаксис
DigestList

CipherList

Назначение

Выдаёт список методов шифрования.

Синтаксис
CipherList

KDFList

Назначение

Выдаёт список методов преобразования паролей в ключи.

Синтаксис
KDFList

ThreadsList

Назначение

Выдаёт список потоков выполнения.

Синтаксис
ThreadsList ("filter")
Параметр Описание

filter

Не обязательный строковый параметр. Если параметр задан, то выводится информация только о тех потоках, чьё описание содержит эту строку.


ConnectionsList

Назначение

Выдаёт список активных сетевых соединений.

Синтаксис
ConnectionsList ("moduleName") ("filter")
Параметр Описание

moduleName

Имя модуля. Если задано, то выводится информация только о соединениях этого модуля.

filter

Не обязательный строковый параметр. Если параметр задан, то выводится информация только о тех соединениях, чьё описание содержит эту строку.


LogsList

Назначение

Выдаёт список файлов журналов указанного типа с размерами в байтах.

Синтаксис
LogsList (""|"MailQueue"|"Settings"|"Auth"|"Block")
Параметр Описание

""|"MailQueue"|"Settings"|"Auth"|"Block"

Тип журнала. Если не указан или пустая строка — возвращается список основных журналов сервера.


LogsRemove

Назначение

Удаляет файлы журналов указанного типа, перечисленные в массиве.

Синтаксис
LogsRemove ""|"MailQueue"|"Settings"|"Auth"|"Block" ["logName1","logName2",...]
Параметр Описание

""|"MailQueue"|"Settings"|"Auth"|"Block"

Тип журнала. Пустая строка — основные журналы сервера.

["logName1","logName2",…​]

Имена файлов журнала без расширения.


Maintenance

Назначение

Запускает задачу обслуживания Maintenance для всего сервера, или для отдельного домена, или для отдельного аккаунта.

Синтаксис
Maintenance "*"|"domain"|"user@domain" ("SubtaskName")
Параметр Описание

*, domain, `user@domain

Запуск обслуживания всего сервера, отдельного домена, отдельного аккаунта соответственно.

SubtaskName

Имя подзадачи (не обязательный параметр). Если не указано, то выполняются подзадачи с 1 по 8. Если указана, то выполняется только указанная.

Подзадачи SubtaskName
Номер Имя Описание

1.

CleanTrash

Очистка папки Корзины от старых сообщений в аккаунте.

2.

CleanSpam

Очистка папки Спам от старых сообщений в аккаунте.

3.

CleanMail

Удаление старых сообщений из всех папок в аккаунте.

4.

RestructureMail

Перемещение старых сообщений из папок INBOX и Отправленные в подпапки Архивы с раскладкой по кварталам года.

5.

ArchiveMail

Перемещение старых сообщений из всех папок в подпапки Архивы с сохранением оригинальной структуры папок.

6.

CleanCalendars

Удаление старых старых календарных событий из всех календарей в аккаунте.

7.

RestructureCalendar

Перемещение старых календарных событий из главного календаря в подпапки Архивы с раскладкой по кварталам года

8.

CleanDomain

Удаляет из домена объекты, имеющие в настройках ключ DeleteMeAfter со значением отметки времени, которая меньше текущего времени.


SystemInfo

Назначение

Выдаёт общие сведения о сервере.

Синтаксис
SystemInfo

AdminAlertsGet

Назначение

Выдаёт список активных (не просроченных) системных предупреждений: остановка сервера, потоки, соединения, слушатели, DNS, плагины, файлы, приближение истечения срока действия лицензии и т.д.

Синтаксис
AdminAlertsGet

MyRights

Назначение

Выдаёт текущие права администратора данного CMD-подключения.

Синтаксис
MyRights

Geolocation

Назначение

Выдаёт геолокационные данные по IP-адресу.

Синтаксис
Geolocation "ip address" ("language")
Параметр Описание

ip address

IP-адрес.

language

Язык локали (не обязательный параметр).


MailBatchInfo

Назначение

Выдаёт сведения о блоке доставки batch в очереди почтового модуля moduleName.

Синтаксис
MailBatchInfo "moduleName" "batch"

MailBatchWake

Назначение

Возобновляет обработку ожидающего блока доставки batch в очереди почтового модуля moduleName.

Синтаксис
MailBatchWake "moduleName" "batch"

MailQueueInfo

Назначение

Выдаёт сведения о письме в очереди по его идентификатору fileID.

Синтаксис
MailQueueInfo fileID

MailQueueFail

Назначение

Удаляет письмо fileID из очереди. Необязательный параметр reason задаёт текст ошибки, который записывается для адресатов письма.

Синтаксис
MailQueueFail fileID ("reason")

MyAdminRights

Назначение

Выдаёт административные права, с которыми работает текущее CLI-соединение.

Синтаксис
MyAdminRights

TotpGenerate

Назначение

Создаёт TOTP-ключ для идентификатора identifier и выдаёт ссылку otpauth:// для добавления ключа в приложение-аутентификатор.

Синтаксис
TotpGenerate "identifier"

Работа с доменами

DomainsList

Назначение

Выдаёт список зарегистрированных доменов в виде словаря с числовыми ключами. Ключ — UID домена, значение — основное имя домена.

Синтаксис
DomainsList ("filter"|false|true|null )
Параметр Описание

filter

Фильтр поиска. Если задан фильтр поиска, то будет произведена фидльтрация по наличию подстроки как в основном имени домена, так и в псевдониме.

Если вместо фильтра указать false, то будет выведен подробный список доменов с типом, всеми доступными именами, псевдонимами и флагами. Если указать true — будут также выведены проверочные хэш-суммы.

Если вместо фильтра указать null, будет выведена информация только о кластерных доменах.


DomainCreate

Назначение

Создаёт домен.

Синтаксис
DomainCreate "domName" (null)
Параметр Описание

domName

Имя домена.

null

Указывается для создания кластерного домена.

Пример 1
DomainCreate "example.org"
Пример 2
DomainCreate "cluster.dom" (null)

DomainRemove

Назначение

Удаляет домен.

Синтаксис
DomainRemove "domName"|domUID
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.


DomainRename

Назначение

Переименовывает домен.

Синтаксис
DomainRename "domName"|domUID "newName"
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

newName

Новое имя домена.


DomainGetID

Назначение

Выдаёт UID домена по его имени.

Синтаксис
DomainGetID "domName"
Параметр Описание

domName

Имя домена.


DomainListNames

Назначение

Выдаёт список всех имён домена по его имени.

Синтаксис
DomainListNames "domName"|domUID
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.


DomainAddName

Назначение

Добавляет домену дополнительное имя.

Синтаксис
DomainAddName "domName"|domUID "newName" (flag)
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

newName

Добавляемое имя домена.

flag

Необязательный флаг применения имени. По умолчанию 255.


DomainDelName

Назначение

Удаляет имя домена.

Синтаксис
DomainDelName "domName"
Параметр Описание

domName

Имя домена.


DomainUseName

Назначение

Делает имя основным.

Синтаксис
DomainUseName "domName"
Параметр Описание

domName

Имя домена.


DomainMoveName

Назначение

Переносит новое имя домену.

Синтаксис
DomainMoveName "domName"|domUID "newName"
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

newName

Новое имя домена.


DomainGetFlags

Назначение

Выдаёт флаги доменного имени.

Синтаксис
DomainGetFlags "domName"
Параметр Описание

domName

Имя домена.


DomainSetFlags

Назначение

Устанавливает флаги доменного имени.

Синтаксис
DomainSetFlags "domName" flag
Параметр Описание

domName

Имя домена.

flag

Флаг применения имени домена.


DomainReadConfig

Назначение

Выдаёт объект настроек домена.

Синтаксис
DomainReadConfig "domName"|domUID (true|false)
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

true|false

Дополнительный параметр. Если указан true, то словарь содержит описания полей. Если задан false, то словарь не содержит настроек по умолчанию.


DomainGetSetting

Назначение

Выдаёт значение настройки домена по ключу или пути из массива ключей.

Синтаксис
DomainGetSetting "domName"|domUID "key"|["key1","key2",..] (true)
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

"key"|["key1","key2",…​]

Объект/объекты настроек домена.


DomainSetSetting

Назначение

Устанавливает значение настройки в объект настроек домена.

Синтаксис
DomainSetSetting "domName"|domUID "key"|["key1","key2",..] {object}
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

"key"|["key1","key2",…​]

Объект/объекты настроек домена.

object

Значение настройки.


DomainDelSetting

Назначение

Удаляет настройку домена, возвращая значение по умолчанию.

Синтаксис
DomainDelSetting "domName"|domUID "key"|["key1","key2",..]
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

"key"|["key1","key2",…​]

Объект/объекты настроек домена для удаления.


DomainUpdateConfig

Назначение

Обновляет настройки домена.

Синтаксис
DomainUpdateConfig "domName"|domUID deleteKeys updateKeyVals
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

deleteKeys

Массив ключей для удаления из настроек (вместо них будут использоваться значения по умолчанию).

updateKeyVals

Массив вида ключ-значение, по которому значения, указанных ключей заменяются на новые.


DomainsDefaults

Назначение

Выдаёт объект настроек по умолчанию для доменов.

Синтаксис
DomainsDefaults (true|false) (null)
Параметр Описание

true|false

Дополнительный параметр. Если задан true, то словарь содержит описания полей. Если задан false, то выдаётся объект настроек без учёта жёстко заданных в программе.

null

Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов.


DomainsGetDefault

Назначение

Выдаёт настройку доменов по умолчанию.

Синтаксис
DomainsGetDefault "key"|["key1","key2",..] (null)
Параметр Описание

key"|["key1","key2",…​]

Объект/объекты настроек по умолчанию.

null

Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов.


DomainsSetDefault

Назначение

Изменяет настройки доменов по умолчанию.

Синтаксис
DomainsSetDefault "key"|["key1","key2",..] {object} (null)
Параметр Описание

key"|["key1","key2",…​]

Объект/объекты настроек по умолчанию.

object

Значение для объекта настроек.

null

Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов.


DomainsDelDefault

Назначение

Удаляет объект настроек по умолчанию для доменов.

Синтаксис
DomainsDelDefault "key"|["key1","key2",..] (null)
Параметр Описание

key"|["key1","key2",…​]

Объект/объекты настроек по умолчанию.

null

Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов.


DomainsUpdateDefaults

Назначение

Обновляет настройки доменов по умолчанию.

Синтаксис
DomainsUpdateDefaults deleteKeys updateKeyVals (null)
Параметр Описание

deleteKeys

Массив для удаления из настроек (вместо них будут использоваться значения по умолчанию).

updateKeyVals

Массив вида ключ-значение, по которому значения указанных ключей заменяются на новые.

null

Дополнительный параметр. Если параметр задан, то изменяются значения по умолчанию для кластерных доменов.


DomainGetIPs

Назначение

Выдаёт глобальную карту соответствия "IP-адрес — домен".

Синтаксис
DomainGetIPs

DomainSetIPs

Назначение

Устанавливает для домена список IP-адресов и обновляет глобальную карту.

Синтаксис
DomainSetIPs "domName"|domUID {object}
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

object

Список IP-адресов для домена.

KerberosKeyAdd

Назначение

Добавляет в домен запись keytab Kerberos. Содержимое keytab передаётся в параметре keytabBase64 в кодировке Base64.

Синтаксис
KerberosKeyAdd "domName"|domUID "keytabBase64"

KerberosKeyList

Назначение

Выдаёт список записей keytab Kerberos домена.

Синтаксис
KerberosKeyList "domName"|domUID

KerberosKeyRemove

Назначение

Удаляет запись keytab Kerberos из домена по индексу index.

Синтаксис
KerberosKeyRemove "domName"|domUID index

DomainGetMultiSet

Назначение

Выдаёт значения нескольких настроек домена. Ключи настроек передаются массивом requestKeys; допускаются только ключи верхнего уровня.

Синтаксис
DomainGetMultiSet "domName"|domUID requestKeys

DomainHasInList

Назначение

Проверяет, есть ли значение object в списке, который хранится в настройке домена key.

Синтаксис
DomainHasInList "domName"|domUID "key"|["key1",..] {object}

DomainAddToList

Назначение

Добавляет значение object в список, который хранится в настройке домена key.

Синтаксис
DomainAddToList "domName"|domUID "key"|["key1",..] {object}

DomainDelInList

Назначение

Удаляет значение object из списка, который хранится в настройке домена key.

Синтаксис
DomainDelInList "domName"|domUID "key"|["key1",..] {object}

DomainGetWebAccessURL

Назначение

Выдаёт адрес (URL) веб-сервера для пользователей домена.

Синтаксис
DomainGetWebAccessURL "domName"|domUID

DomainGetSecurity

Назначение

Выдаёт сведения о TLS-контексте (профиле сертификата), который сейчас используется доменом.

Синтаксис
DomainGetSecurity "domName"|domUID

DomainListSecureCTX

Назначение

Выдаёт список TLS-контекстов (профилей сертификатов), настроенных в домене.

Синтаксис
DomainListSecureCTX "domName"|domUID

DomainAddSecureCtx

Назначение

Добавляет в домен TLS-контекст (профиль сертификата) с именем name. В параметрах передаются сертификат cert, закрытый ключ key и, при необходимости, цепочка сертификатов chain.

Синтаксис
DomainAddSecureCtx "domName"|domUID "name" "cert" "key" ("chain")

DomainDelSecureCtx

Назначение

Удаляет из домена TLS-контекст с именем name.

Синтаксис
DomainDelSecureCtx "domName"|domUID "name"

DomainGetSecureCtx

Назначение

Выдаёт содержимое TLS-контекста name: массив из сертификата, закрытого ключа и цепочки сертификатов в формате PEM.

Синтаксис
DomainGetSecureCtx "domName"|domUID "name"

DomainSelSecureCtx

Назначение

Делает TLS-контекст name активным для домена. Необязательным массивом [crt,key,chn] можно заменить отдельные части контекста: сертификат, ключ, цепочку.

Синтаксис
DomainSelSecureCtx "domName"|domUID "name" ([crt,key,chn])

DomainClrSecureCtx

Назначение

Отменяет выбор TLS-контекста для домена.

Синтаксис
DomainClrSecureCtx "domName"|domUID (false)

DomainGetStats

Назначение

Выдаёт статистику использования ресурсов домена.

Синтаксис
DomainGetStats "domName"|domUID

Работа с объектами в доменах

ObjectsList

Назначение

Выдаёт список зарегистрированных объектов домена в виде словаря с числовыми ключами: ключ — UID объекта, значение — основное имя объекта.

Синтаксис
ObjectsList "domName"|domUID ("filter"|false|true ) (start limit ([fields]))
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

"filter"|false|true

Фильтр поиска. Если указать фильтр поиска filter, то будет произведена фильтрация по наличию подстроки как в основном имени объекта, так и в псевдониме.

Если строка фильтра начинается с символа =, то подстрока ищется в типе доменного объекта: например, с фильтром "=acc" можно пролистать все аккаунты.

Если вместо фильтра поиска указать значение false, то будет выведен подробный список с типом, всеми доступными именами и псевдонимами и флагами (при true будут также выведены и проверочные хэш-суммы).

start limit

Числовые параметры. Если заданы start и limit, то выдача будет ограничена элементами с UID не менее start и общим количество не более limit.

fields

Массив ключей (не обязательный параметр). Если массив указан, их значения должны быть включены в информацию об объекте, например ["RealName", "StorageSize"].


ForwarderCreate

Назначение

Создаёт переадресатор.

Синтаксис
ForwarderCreate "domName"|domUID "fwdName" "destination"

GroupCreate

Назначение

Создаёт группу.

Синтаксис
GroupCreate "domName"|domUID "grpName" (settingsDict|settingsKeyValArray)
Параметр Описание

domName

Имя домена.

domUID

Числовой идентификатор домена.

grpName

Имя группы.

settingsDict|settingsKeyValArray

Опциональный словарь settingsDict или массив settingsKeyValArray (с чередующимися названием настроек [строка] и их значениями [объект]) с настройками группы, которые будут установлены сразу после создания группы.


MailingListCreate

Назначение

Создаёт список рассылки.

Синтаксис
MailingListCreate "domName"|domUID "mlName" "owner" ("mountName")
Параметр Описание

owner

Адрес владельца в формате строки.

mountName

Точка монтирования в формате строки (опционально).


ObjectRemove

Назначение

Удаляет объект.

Синтаксис
ObjectRemove "domName"|domUID "objName"|objUID

ObjectRename

Назначение

Переименовывает объект.

Синтаксис
ObjectRename "domName"|domUID "objName"|objUID "newName"

ObjectGetID

Назначение

Выдаёт UID объекта по его имени objName.

Синтаксис
ObjectGetID "domName"|domUID "objName" ("instanceid")

ObjectListNames

Назначение

Выдаёт список имён объекта.

Синтаксис
ObjectListNames "domName"|domUID "objName"|objUID

ObjectAddName

Назначение

Добавляет объекту дополнительное имя newName. Необязательный параметр flag задаёт флаг применения имени (по умолчанию 255).

Синтаксис
ObjectAddName "domName"|domUID "objName"|objUID "newName" (flag)

ObjectDelName

Назначение

Удаляет имя объекта.

Синтаксис
ObjectDelName "domName"|domUID "objName"

ObjectUseName

Назначение

Делает имя objName основным именем объекта (первым в списке его имён). Имя должно принадлежать объекту.

Синтаксис
ObjectUseName "domName"|domUID "objName"

ObjectMoveName

Назначение

Переносит имя объекту.

Синтаксис
ObjectMoveName "domName"|domUID "destName"|destUID "newName"

ObjectGetFlags

Назначение

Выдаёт флаги имени объекта.

Синтаксис
ObjectGetFlags "domName"|domUID "objName"

ObjectSetFlags

Назначение

Устанавливает флаги имени объекта.

Синтаксис
ObjectSetFlags "domName"|domUID "objName" flag

ObjectReadConfig

Назначение

Выдаёт настройки объекта.

Синтаксис
ObjectReadConfig "domName"|domUID "objName"|objUID (true|false)

ObjectGetSetting

Назначение

Выдаёт настройку объекта.

Синтаксис
ObjectGetSetting "domName"|domUID "objName"|objUID "key"|["key1","key2",..] (true)

ObjectSetSetting

Назначение

Изменяет настройку объекта.

Синтаксис
ObjectSetSetting "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}

ObjectDelSetting

Назначение

Удаляет настройку объекта.

Синтаксис
ObjectDelSetting "domName"|domUID "objName"|objUID "key"|["key1","key2",..]

ObjectHasInList

Назначение

Проверяет наличие значения в списке настройки.

Синтаксис
ObjectHasInList "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}

ObjectAddToList

Назначение

Добавляет значение в список настройки.

Синтаксис
ObjectAddToList "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}

ObjectDelInList

Назначение

Удаляет значение из списка настройки.

Синтаксис
ObjectDelInList "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}

ObjectUpdateConfig

Назначение

Обновляет настройки объекта.

Синтаксис
ObjectUpdateConfig "domName"|domUID "objName"|objUID deleteKeys updateKeyVals

ObjectsCount

Назначение

Выдаёт количество объектов в домене.

Синтаксис
ObjectsCount "domName"|domUID

AccountCreateMP

Назначение

Создаёт аккаунт accName на точке монтирования mountName домена. Необязательный параметр — словарь настроек settingsDict или массив settingsKeyValArray, в котором чередуются названия настроек и их значения. Эти настройки применяются сразу после создания аккаунта.

Синтаксис
AccountCreateMP "domName"|domUID "mountName" "accName" (settingsDict|settingsKeyValArray)

ResourceCreate

Назначение

Создаёт ресурсный аккаунт resName с владельцем owner.

Синтаксис
ResourceCreate "domName"|domUID "resName" "owner"

ResourceCreateMP

Назначение

Создаёт ресурсный аккаунт resName с владельцем owner на точке монтирования mountName домена.

Синтаксис
ResourceCreateMP "domName"|domUID "mountName" "resName" "owner"

ForwarderCreateMP

Назначение

Создаёт переадресатор fwdName на точке монтирования mountName домена. Письма, отправленные на адрес переадресатора, перенаправляются на адрес destination.

Синтаксис
ForwarderCreateMP "domName"|domUID "mountName" "fwdName" "destination"

GroupCreateMP

Назначение

Создаёт группу grpName на точке монтирования mountName домена. Необязательный параметр — словарь настроек settingsDict или массив settingsKeyValArray, в котором чередуются названия настроек и их значения. Эти настройки применяются сразу после создания группы.

Синтаксис
GroupCreateMP "domName"|domUID "mountName" "grpName" (settingsDict|settingsKeyValArray)

ObjectGetMultiSet

Назначение

Выдаёт значения нескольких настроек объекта. Ключи настроек передаются массивом requestKeys; допускаются только ключи верхнего уровня.

Синтаксис
ObjectGetMultiSet "domName"|domUID "objName"|objUID requestKeys

ObjectSetInactive

Назначение

Блокирует или разблокирует аккаунт.

  • inactive — true: аккаунт становится неактивным; false: аккаунт снова становится активным.

  • killsessions — необязательный параметр. Если true, при блокировке закрываются все активные сессии аккаунта. Учитывается, только если inactive равен true.

Синтаксис
ObjectSetInactive "domName"|domUID "accName"|accUID inactive (killsessions)

ObjectExport

Назначение

Выгружает объект домена в архив и выдаёт путь к папке с архивом.

Архивы сохраняются относительно рабочего каталога сервера: в Cluster/Exports в кластерной конфигурации и в Exports на одиночном сервере. Параметр prefix добавляется к имени архива.

Синтаксис
ObjectExport "domName"|domUID "objName"|objUID "prefix"

ObjectImport

Назначение

Загружает объект в домен из архива. Параметр path — путь к папке с архивом относительно рабочего каталога сервера.

Синтаксис
ObjectImport "domName"|domUID "path"

Работа с аккаунтами

AccountCreate

Назначение

Создаёт аккаунт в домене. Настройки из необязательного параметра применяются сразу после создания аккаунта.

Синтаксис
AccountCreate "domName"|domUID "accName" (settingsDict|settingsKeyValArray)
Параметр Описание

domName

Имя домена.

domUID

UID домена.

accName

Имя аккаунта.

settingsDict|settingsKeyValArray

Необязательный словарь настроек или массив с чередующимися названиями настроек и их значениями.

Пример
AccountCreate "example.org" "user1"

AccountsDefaultProfileCreate

Назначение

Создаёт профиль настроек аккаунтов.

Синтаксис
AccountsDefaultProfileCreate "domName"|domUID|null "defaults_profile" (true)
Если вместо домена передан null, профиль создаётся на уровне кластера.

AccountsDefaultProfileRemove

Назначение

Удаляет профиль настроек аккаунтов.

Синтаксис
AccountsDefaultProfileRemove "domName"|domUID|null "defaults_profile" (true)

AccountsDefaultProfileList

Назначение

Выдаёт список профилей настроек аккаунтов.

Уровень задаётся первым параметром:

  • имя или UID домена — уровень домена;

  • пустая строка или 0 — уровень сервера;

  • null — уровень кластера.

Если указать true, выдаются профили без учёта профилей, унаследованных с вышестоящих уровней. Второй необязательный флаг используется для взаимодействия узлов кластера.

Синтаксис
AccountsDefaultProfileList "domName"|domUID|null (true|false (true))

AccountSetPassword

Назначение

Задаёт пароль аккаунта. Необязательный параметр tag задаёт метку пароля; пустая строка — основной пароль.

Синтаксис
AccountSetPassword "domName"|domUID "accName"|accUID "password" ("tag")
Пример
AccountSetPassword "example.org" "user1" "secret123"

AccountVerifyPwd

Назначение

Проверяет пароль аккаунта.

Синтаксис
AccountVerifyPwd "domName"|domUID "accName"|accUID "password" ("tag")

AccountGetPassword

Назначение

Выдаёт пароль аккаунта с меткой tag; пустая строка — основной пароль.

Синтаксис
AccountGetPassword "domName"|domUID "accName"|accUID ("tag")

AccountsDefaults

Назначение

Выдаёт настройки аккаунтов по умолчанию.

Синтаксис
AccountsDefaults "domName"|domUID|null ("profileName") (true|false)

AccountsGetDefault

Назначение

Выдаёт настройку аккаунтов по умолчанию.

Синтаксис
AccountsGetDefault "domName"|domUID|null "key"|["key1","key2",..] ("profileName")

AccountsSetDefault

Назначение

Изменяет настройку аккаунтов по умолчанию.

Синтаксис
AccountsSetDefault "domName"|domUID|null "key"|["key1","key2",..] obj ("profileName")

AccountsDelDefault

Назначение

Удаляет настройку аккаунтов по умолчанию.

Синтаксис
AccountsDelDefault "domName"|domUID|null "key"|["key1","key2",..] ("profileName")

AccountsUpdateDefs

Назначение

Обновляет настройки аккаунтов по умолчанию.

Синтаксис
AccountsUpdateDefs "domName"|domUID|null deleteKeys updateKeyVals ("profileName")

AccountListNamespaces

Назначение

Выдаёт список пространств имён папок аккаунта.

Синтаксис
AccountListNamespaces "domName"|domUID "accName"|accUID

AccountListMailboxes

Назначение

Выдаёт список почтовых папок аккаунта.

Синтаксис
AccountListMailboxes "domName"|domUID "accName"|accUID "namespace"
Пространство имён может быть пустым или иметь вид ~user@domain/.

AccountGetMailStorageSize

Назначение

Выдаёт размер почтового хранилища аккаунта.

Синтаксис
AccountGetMailStorageSize "domName"|domUID "accName"|accUID (true)

AccountDelPassword

Назначение

Удаляет пароль аккаунта. Необязательный параметр tag задаёт метку пароля; пустая строка — основной пароль.

Синтаксис
AccountDelPassword "domName"|domUID "accName"|accUID ("tag")

AccountCloseSessions

Назначение

Закрывает все сессии аккаунта.

Синтаксис
AccountCloseSessions "domName"|domUID "accName"|accUID

AccountListOpenMboxes

Назначение

Выдаёт список папок аккаунта, открытых в данный момент.

Синтаксис
AccountListOpenMboxes "domName"|domUID "accName"|accUID

DataFilesRebuild

Назначение

Восстанавливает сведения о файлах аккаунта по фактически хранящимся данным.

Синтаксис
DataFilesRebuild "domName"|domUID "accName"|accUID

DataFilesList

Назначение

Выдаёт сведения о файлах и папках аккаунта по пути path. Необязательный параметр depth задаёт глубину обхода вложенных папок (по умолчанию 1).

Синтаксис
DataFilesList "domName"|domUID "accName"|accUID "path" (depth)

DataFilesSetACL

Назначение

Задаёт права доступа пользователя userName к файлу или папке аккаунта по пути path.

Параметр acl может содержать символы:

  • r — чтение файла или просмотр содержимого папки;

  • w — запись или удаление файла или папки.

Если acl — пустая строка, права пользователя на этот путь удаляются.

В параметре userName можно указать:

  • полное имя аккаунта, например user@domain.dom;

  • полный идентификатор аккаунта в формате =accountId@=domainId;

  • anyone@ — любой аккаунт домена владельца;

  • anyone — любой аккаунт и анонимный доступ.

Синтаксис
DataFilesSetACL "domName"|domUID "accName"|accUID "path" "userName" "acl"

DataFiles

Назначение

Выполняет операцию с файлом или папкой аккаунта. Операция задаётся третьим параметром:

  • read — выдаёт содержимое файла path1;

  • write — записывает в файл path1 содержимое из последнего параметра; существующий файл перезаписывается;

  • remove — удаляет файл или папку path1; папки удаляются вместе с содержимым;

  • mkdir — создаёт папку path1 и все недостающие родительские папки;

  • move — перемещает файл или папку path1 в path2; существующий файл перезаписывается;

  • copy — копирует файл или папку path1 в path2 без вложенного содержимого; существующий файл перезаписывается;

  • url — выдаёт ссылку для скачивания файла path1.

Синтаксис
DataFiles "domName"|domUID "accName"|accUID "read|write|remove|mkdir|move|copy|url" "path1" ["path2|content"]

Работа с группами

GroupListMembers

Назначение

Выдаёт список участников группы.

  • mailsFlag — если true, выдаются адреса электронной почты участников; иначе для локальных участников выдаются их канонические имена.

  • filter — шаблон, по которому отбираются участники.

Если вместо группы указать аккаунт, выдаётся список групп, в которые он входит.

Синтаксис
GroupListMembers "domName"|domUID "grpName"|grpUID (mailsFlag ("filter"))

GroupAddAccount

Назначение

Добавляет в группу участника или массив участников. Если указать true, сохраняется адрес электронной почты; иначе для локальных участников сохраняется их UID.

Синтаксис
GroupAddAccount "domName"|domUID "grpName"|grpUID "addr"|[list] (mail)

GroupDelAccount

Назначение

Удаляет из группы участника или массив участников. Если указать true, участник ищется по адресу с учётом маршрутизации.

Синтаксис
GroupDelAccount "domName"|domUID "grpName"|grpUID "addr"|[list] (mail)

GroupHasAccount

Назначение

Проверяет наличие участника в группе.

Синтаксис
GroupHasAccount "domName"|domUID "grpName"|grpUID "addr" (mail)

GroupGetOwner

Назначение

Выдаёт владельца группы.

Синтаксис
GroupGetOwner "domName"|domUID "grpName"|grpUID

GroupSetOwner

Назначение

Назначает владельца группы.

Синтаксис
GroupSetOwner "domName"|domUID "grpName"|grpUID "addr"

Работа со списками рассылки

MailingListGetMembers

Назначение

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

Синтаксис
MailingListGetMembers "domName"|domUID "mlName"|mlUID

MailingListAddMember

Назначение

Добавляет один или несколько адресов участников списка рассылки.

Синтаксис
MailingListAddMember "domName"|domUID "mlName"|mlUID "addr"|[list]
Параметр Описание

addr

Адрес участника в формате строки или список адресов в формате массива JSON.


MailingListDelMember

Назначение

Удаляет один или несколько адресов участников списка рассылки.

Синтаксис
MailingListDelMember "domName"|domUID "mlName"|mlUID "addr"|[list]
Параметр Описание

addr

Адрес участника в формате строки или список адресов в формате массива JSON.


MailingListGetMember

Назначение

Возвращает текущие параметры участника списка рассылки.

Синтаксис
MailingListGetMember "domName"|domUID "mlName"|mlUID "addr"
Параметр Описание

addr

Адрес участника в формате строки.


MailingListRouteMember

Назначение

Возвращает список адресов на которые оформлена подписка участника списка рассылки.

Синтаксис
MailingListRouteMember "domName"|domUID "mlName"|mlUID "addr"
Параметр Описание

addr

Адрес участника в формате строки.


MailingListGetOwner

Назначение

Возвращает адрес владельца списка рассылки.

Синтаксис
MailingListGetOwner "domName"|domUID "mlName"|mlUID

MailingListSetOwner

Назначение

Устанавливает адрес владельца списка рассылки.

Синтаксис
MailingListSetOwner "domName"|domUID "mlName"|mlUID "addr"
Параметр Описание

addr

Адрес владельца в формате строки.


MailingListGetSubscription

Назначение

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

Синтаксис
MailingListGetSubscription "domName"|domUID "mlName"|mlUID

MailingListSetSubscription

Назначение

Устанавливает статус подписки участника списка рассылки.

Синтаксис
MailingListSetSubscription "domName"|domUID "mlName"|mlUID "addr" "subscription"
Параметр Описание

addr

Адрес владельца в формате строки.

subscription

Статус подписки.

Статусы подписки subscription
Статус Описание

normal

Участник может принимать и отправлять сообщения, изменять статус подписки.

silent

Участник может только отправлять сообщения и изменять статус подписки.

special

Участник может отправлять и получать автоматически сгенерированные сообщения, и изменять статус подписки.

suspended

Подписка приостановлена, участник не может отправлять и получать сообщения, а также изменять статус подписки.


Работа с папками

MailboxesList

Назначение

Выдаёт словарь папок аккаунта. Ключи словаря — полные имена папок в формате, заданном параметром mode.

Синтаксис
MailboxesList "domName"|domUID "accName"|accUID ("optClass" (mode (parent)))
Параметр Описание

optClass

Класс папок, которые попадут в результат.

mode

Формат имён папок: 0 — UTF-8 (по умолчанию), 1 — модифицированная UTF-7, 2 — имена поддиректорий в директории аккаунта.

parent

UID папки, вложенные папки которой нужно вывести. 0 — все папки аккаунта.


MailboxCreate

Назначение

Создаёт в аккаунте папку newName класса optClass. Если класс не указан, создаётся почтовая папка (mail).

Поддерживаемые классы: mail, calendar, contacts, notes, tasks.

Любое написание имени Inbox в корне аккаунта приводится к INBOX.

Синтаксис
MailboxCreate "domName"|domUID "accName"|accUID "newName" "optClass"

MailboxRename

Назначение

Переименовывает папку.

Синтаксис
MailboxRename "domName"|domUID "accName"|accUID "oldName" "newName"

MailboxRemove

Назначение

Удаляет папку toDelete вместе со всеми вложенными папками.

Синтаксис
MailboxRemove "domName"|domUID "accName"|accUID "toDelete" ("timeToDelete")

MailboxGetACL

Назначение

Выдаёт ACL папки.

Синтаксис
MailboxGetACL "domName"|domUID "accName"|accUID "mboxName"

MailboxUpdateACL

Назначение

Изменяет ACL папки.

Синтаксис
MailboxUpdateACL "domName"|domUID "accName"|accUID "mboxName" "identifier" ("rights")

MboxGetInfo

Назначение

Выдаёт значение метаданных папки по ключу settings.key. Если ключ не указан, выдаются все сведения о папке.

Синтаксис
MboxGetInfo "domName"|domUID "accName"|accUID "mboxName"|mboxUID ("settings.key")

MboxSetInfo

Назначение

Задаёт значение метаданных папки по ключу settings.key. Если значение object не указано, ключ удаляется из метаданных.

Синтаксис
MboxSetInfo "domName"|domUID "accName"|accUID "mboxName"|mboxUID "settings.key" (object)

ObjectGetInfo

Назначение

Выдаёт значение метаданных объекта по ключу или пути из массива ключей.

Синтаксис
ObjectGetInfo "domName"|domUID "accName"|accUID "key"|[keys]

ObjectSetInfo

Назначение

Задаёт значение метаданных объекта по ключу. Если значение object не указано, ключ удаляется из метаданных.

Синтаксис
ObjectSetInfo "domName"|domUID "accName"|accUID "key"|[keys] (object)

ObjectIncInfo

Назначение

Увеличивает значение счётчика объекта.

Синтаксис
ObjectIncInfo "domName"|domUID "accName"|accUID "settings.key" "delta" "limit.key"

ObjectIncTimedInfo

Назначение

Увеличивает значение временного счётчика объекта.

Синтаксис
ObjectIncTimedInfo "domName"|domUID "accname"|accUID "settingskey" "delta" "limitkey"

MailboxGetMyRights

Назначение

Выдаёт права аккаунта на папку.

Синтаксис
MailboxGetMyRights "domName"|domUID "accName"|accUID "mboxName"

CalendarGetACL

Назначение

Выдаёт ACL календаря.

Синтаксис
CalendarGetACL "domName"|domUID "accName"|accUID "mboxName"

CalendarUpdateACL

Назначение

Изменяет ACL календаря.

Синтаксис
CalendarUpdateACL "domName"|domUID "accName"|accUID "mboxName" "identifier" ("rights")

CalendarGetMyRights

Назначение

Выдаёт права аккаунта на календарь.

Синтаксис
CalendarGetMyRights "domName"|domUID "accName"|accUID "mboxName"

MboxMessageInfo

Назначение

Выдаёт сведения о письме с UID msgUID в папке аккаунта. Папка задаётся именем mboxName или UID mbxUID.

Синтаксис
MboxMessageInfo "domName"|domUID "accName"|accUID "mboxName"|mbxUID msgUID

Работа с административными правами

RolesList

Назначение

Выдаёт список административных ролей.

Синтаксис
RolesList "domName"|domUID|null

RoleCreate

Назначение

Создаёт административную роль roleName с правами из массива. Уровень задаётся так же, как в команде RolesList: домен, сервер или кластер. Необязательный флаг true отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
RoleCreate "domName"|domUID|null "roleName" ([rights] (true))

RoleRemove

Назначение

Удаляет административную роль roleName. Уровень задаётся так же, как в команде RolesList: домен, сервер или кластер. Необязательный флаг true отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
RoleRemove "domName"|domUID|null "roleName" (true)

RoleGet

Назначение

Выдаёт список прав роли.

Синтаксис
RoleGet "domName"|domUID|null "roleName"

RoleUpdate

Назначение

Изменяет административную роль roleName: удаляет права из массива rightsDel и добавляет права из массива rightsAdd. Уровень задаётся так же, как в команде RolesList: домен, сервер или кластер. Необязательный флаг true отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
RoleUpdate "domName"|domUID|null "roleName" [rightsDel] [rightsAdd] (true)

AdminsList

Назначение

Выдаёт список администраторов.

Синтаксис
AdminsList "domName"|domUID|null

AdminCreate

Назначение

Назначает пользователя user администратором с правами из массива. Уровень задаётся так же, как в команде AdminsList: домен, сервер или кластер. Необязательный флаг true отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
AdminCreate "domName"|domUID|null "user" ([rights] (true))

AdminRemove

Назначение

Удаляет пользователя user из списка администраторов. Уровень задаётся так же, как в команде AdminsList: домен, сервер или кластер. Необязательный флаг true отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
AdminRemove "domName"|domUID|null "user" (true)

AdminInfo

Назначение

Выдаёт права администратора.

Синтаксис
AdminInfo "domName"|domUID|null "user"

AdminUpdate

Назначение

Изменяет права и роли администратора user: удаляет права из массива rightsDel и добавляет права из массива rightsAdd. Уровень задаётся так же, как в команде AdminsList: домен, сервер или кластер. Необязательный флаг true отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
AdminUpdate "domName"|domUID|null "user" [rightsDel] [rightsAdd] (true)

AccountGetRights

Назначение

Выдаёт административные права аккаунта.

Синтаксис
AccountGetRights "domName"|domUID "accName"|accUID

RightsList

Назначение

Выдаёт список административных прав, доступных текущему администратору. Если указать true, права выдаются вложенными словарями в соответствии с иерархией прав.

Синтаксис
RightsList (bWithHierarchy)

AccessDump

Назначение

Выдаёт административные роли и список администраторов.

Уровень задаётся первым параметром:

  • имя или UID домена — уровень домена;

  • пустая строка или 0 — уровень сервера;

  • null — уровень кластера (на сервере вне кластера — уровень сервера).

Синтаксис
AccessDump "domName"|domUID|null

AdminSet

Назначение

Заменяет права и роли администратора user в домене, на сервере или в кластере на права и роли из массива.

Необязательные параметры:

  • первый — принудительный режим. Если пользователь не администратор и список прав не пуст, он назначается администратором. Если пользователь администратор и список прав пуст, он удаляется из списка администраторов;

  • второй — отключает рассылку уведомлений о смене прав по кластеру.

Синтаксис
AdminSet "domName"|domUID|null "user" [rightsDel] (false) (false)

Работа со справочником

DirectoryFind

Назначение

Выдаёт записи справочника, соответствующие запросу.

Синтаксис
DirectoryFind "baseDn" "scope" "filter" ["field1","field2",...] "sorting" "cookie" limit
Параметр Описание

baseDn

Базовый DN.

scope

Область поиска: base — запись с указанным DN, one — непосредственные дочерние записи, sub — все дочерние записи.

filter

Фильтр в формате (<поле>=<значение>); может быть пустым.

["field1","field2",…​]

Атрибуты для каждой записи; * — все доступные атрибуты.

sorting

Сортировка в формате [+-]<атрибут>; может быть пустой.

cookie

Значение из последней записи предыдущего результата для загрузки следующей страницы; может быть пустым.

limit

Максимальное число записей в ответе (1..500, по умолчанию 100).


DirectoryAdd

Назначение

Добавляет в справочник запись с DN dn и атрибутами из JSON-объекта attributes.

Синтаксис
DirectoryAdd "dn" {attributes}

DirectoryUpdate

Назначение

Изменяет атрибуты записи справочника dn: атрибуты из JSON-объекта changedAttributes добавляются к существующим или заменяют их.

Синтаксис
DirectoryUpdate "dn" {changedAttributes}

DirectoryMove

Назначение

Перемещает запись справочника.

Синтаксис
DirectoryMove "dn" "newDn"

DirectoryRemove

Назначение

Удаляет запись справочника.

Синтаксис
DirectoryRemove "dn"

DirectoryCleanup

Назначение

Удаляет из справочника записи об удалённых объектах в DN dn и всех дочерних записях. Обрабатывается только том, к которому относится dn.

  • minTombstoneTime — удаляются записи только об объектах, удалённых раньше этого времени. По умолчанию — текущее время.

  • Если dn не указан, используется пустая строка.

Синтаксис
DirectoryCleanup ("dn") ("minTombstoneTime")

DirectorySync

Назначение

Запускает синхронизацию томов справочника, для которых настроено зеркалирование. Если указан dn, синхронизируется только том с этим DN; иначе — все тома с зеркалированием.

Синтаксис
DirectorySync ("dn")

DomainsToDirectory

Назначение

Синхронизирует справочник для доменов из массива. Если массив пустой, синхронизируются все домены.

Синтаксис
DomainsToDirectory ["domName"|domUID]

Работа со справочником PostgreSQL

PgDirectoryFind

Назначение

Выдаёт записи справочника, хранящегося в базе данных PostgreSQL, соответствующие запросу.

  • baseDn — базовый DN.

  • scope — область поиска: base — запись с указанным DN, one — непосредственные дочерние записи, sub — все дочерние записи.

  • filter — фильтр в формате (<поле>=<значение>); может быть пустым. В значении допускаются * (любое число символов) и ? (один символ). Условия объединяются через (&(…​)(…​)) (все условия) или (|(…​)(…​)) (хотя бы одно).

  • ["field1","field2",…​] — атрибуты для каждой записи; * — все доступные атрибуты.

  • sorting — сортировка в формате [+-]<атрибут>; может быть пустой.

  • cookie — значение из последней записи предыдущего результата для загрузки следующей страницы; может быть пустым.

  • limit — максимальное число записей в ответе (1..500, по умолчанию 100).

  • последний параметр — URI подключения к базе данных в формате postgres://user:pass@host:port/db.

Синтаксис
PgDirectoryFind "baseDn" "scope" "filter" ["field1","field2",...] "sorting" "cookie" limit 'postgres://user:pass@host:port/db'

PgDirectoryAdd

Назначение

Добавляет запись с DN dn и атрибутами из JSON-объекта attributes в справочник в базе данных PostgreSQL. Параметр server — URI подключения в формате postgres://user:pass@host:port/db.

Синтаксис
PgDirectoryAdd "dn" {attributes} "server"

PgDirectoryUpdate

Назначение

Изменяет атрибуты записи dn в справочнике в базе данных PostgreSQL: атрибуты из JSON-объекта changedAttributes добавляются к существующим или заменяют их. Параметр server — URI подключения в формате postgres://user:pass@host:port/db.

Синтаксис
PgDirectoryUpdate "dn" {changedAttributes} "server"

PgDirectoryMove

Назначение

Перемещает запись PostgreSQL-справочника.

Синтаксис
PgDirectoryMove "dn" "newDn" "server"

PgDirectoryRemove

Назначение

Удаляет запись PostgreSQL-справочника.

Синтаксис
PgDirectoryRemove "dn" "server"

Клиент LDAP

Назначение

Выдаёт записи LDAP-сервера, соответствующие запросу.

Синтаксис
LdapClientSearch "baseDn" "scope" "deref" "filter" ["field1","field2",...] "attrsonly"|"all" sizeLimit timeLimit "sorting" "cookie" "ldap://user:pass@host:port"
Параметр Описание

baseDn

Базовый DN.

scope

Область поиска: base, one, sub.

deref

Разыменование ссылок: never, always, searching, finding.

filter

LDAP-фильтр.

["field1","field2",…​]

Атрибуты результата.

"attrsonly"|"all"

Возвращать только атрибуты или атрибуты и значения.

sizeLimit

Максимальное число записей.

timeLimit

Максимальное время выполнения.

sorting

Параметры сортировки.

cookie

Маркер страницы.

ldap://user:pass@host:port

URI LDAP-сервера с параметрами доступа.


Работа с плагинами

Параметры команд работы с плагинами:

Параметр Описание

type

Тип плагина: Scanner, Extension или Authenticator.

name

Имя плагина.

Подробнее о плагинах см. Модуль Менеджер плагинов.

PluginList

Назначение

Выдаёт список плагинов с их настройками и статусом.

Синтаксис
PluginList

PluginAdd

Назначение

Создаёт плагин указанного типа с указанным именем.

Синтаксис
PluginAdd "type" "name" {settings}
Параметр Описание

type

Тип плагина: Scanner, Extension или Authenticator.

name

Имя плагина.

settings

Словарь настроек плагина.


PluginDel

Назначение

Удаляет плагин указанного типа с указанным именем.

Синтаксис
PluginDel "type" "name"

PluginStart

Назначение

Запускает плагин указанного типа с указанным именем.

Синтаксис
PluginStart "type" "name"

PluginStop

Назначение

Останавливает плагин указанного типа с указанным именем.

Синтаксис
PluginStop "type" "name"

Работа с сессиями

SessionList

Назначение

Выдаёт список сессий. Для каждой сессии выдаются поля:

  • token — токен сессии;

  • tsCreated — время создания;

  • tsActivity — время последнего обращения;

  • remoteAddress — IP-адрес, с которого открыта сессия (если известен);

  • clientAddress — IP-адрес клиента за прокси-сервером из заголовка X-Forwarded-For (если известен);

  • authAccount — имя аутентифицированного пользователя (если есть).

Если указан домен, выдаются только сессии аккаунтов этого домена; если указаны домен и аккаунт — только сессии этого аккаунта.

Синтаксис
SessionList ("domName"|domUID ("accName"|accUID))

SessionCreate

Назначение

Создаёт сессию для аккаунта и выдаёт токен сессии. Необязательный параметр protocolVersion задаёт версию протокола; по умолчанию используется последняя.

Синтаксис
SessionCreate "domName"|domUID "accName"|accUID (protocolVersion)

SessionClose

Назначение

Закрывает сессию.

Синтаксис
SessionClose "token"

SessionGetInfo

Назначение

Выдаёт данные сессии.

Синтаксис
SessionGetInfo "token"

SessionUpdateInfo

Назначение

Дополняет данные сессии с токеном token данными из объекта newInfo.

Синтаксис
SessionUpdateInfo "token" {newInfo}

SessionSendEvent

Назначение

Отправляет в сессию с токеном token событие event.

Синтаксис
SessionSendEvent "token" {event}

Работа с точками монтирования

DomainListMounts

Назначение

Выдаёт список точек монтирования домена.

Синтаксис
DomainListMounts "domName"|domUID

DomainCreateMount

Назначение

Создаёт в домене точку монтирования name. В кластере дополнительно передаётся фактическое имя каталога точки монтирования path.

Синтаксис
DomainCreateMount "domName"|domUID "name" ("path")

DomainRemoveMount

Назначение

Удаляет точку монтирования name домена. В точке монтирования не должно быть объектов. В кластере можно передать true, чтобы удалить и каталог точки монтирования.

Синтаксис
DomainRemoveMount "domName"|domUID "name" (true)

ObjectSetMount

Назначение

Переносит каталог объекта домена на точку монтирования mountName и выдаёт новый путь к каталогу. Если mountName не указан, каталог переносится в основной каталог домена.

Синтаксис
ObjectSetMount "domName"|domUID "objName"|objUID ("mountName")

ObjectGetMount

Назначение

Выдаёт имя точки монтирования, на которой хранится каталог объекта. Пустая строка означает, что каталог находится в основном каталоге домена.

Синтаксис
ObjectGetMount "domName"|domUID "objName"|objUID

DomainListMountObjects

Назначение

Выдаёт список объектов, которые хранятся на точке монтирования name домена. Если указать пустую строку, выдаются объекты, которые хранятся непосредственно в каталоге домена.

Синтаксис
DomainListMountObjects "domName"|domUID "name"

Работа с ресурсными аккаунтами

ResourceGetOwner

Назначение

Выдаёт владельца ресурсного аккаунта, если он задан. Владелец может управлять ресурсом без административных прав.

Синтаксис
ResourceGetOwner "domName"|domUID "resName"|resUID

ResourceSetOwner

Назначение

Назначает владельца ресурсного аккаунта. Владелец может управлять ресурсом без административных прав.

Синтаксис
ResourceSetOwner "domName"|domUID "resName"|resUID "addr"

Работа с правилами обработки почты

Первые два параметра команд задают уровень, на котором действует правило:

  • сервер — null и null;

  • кластер — null и 0;

  • домен — имя или UID домена и null;

  • аккаунт или другой объект домена — имя или UID домена и имя или UID объекта.

RulesListOptions

Назначение

Выдаёт доступные для правил операции, условия или действия — в зависимости от последнего параметра. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Для actionsExt выдаётся словарь, где ключ — название действия, а значение:

  • null — действие можно сочетать с любыми другими в любом порядке;

  • true — завершающее действие: после него другие действия невозможны;

  • false — действие нельзя сочетать ни с какими другими.

Синтаксис
RulesListOptions "domName"|domUID|null "objName"|objUID|null "operations"|"conditions"|"actions"|"actionsExt"

RulesList

Назначение

Выдаёт список правил обработки почты. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Синтаксис
RulesList "domName"|domUID|null "objName"|objUID|null

RuleGet

Назначение

Выдаёт настройки правила ruleName. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Синтаксис
RuleGet "domName"|domUID|null "objName"|objUID|null "ruleName"

RuleDel

Назначение

Удаляет правило ruleName. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Синтаксис
RuleDel "domName"|domUID|null "objName"|objUID|null "ruleName"

RuleAdd

Назначение

Создаёт правило ruleName с настройками из объекта ruleData. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Синтаксис
RuleAdd "domName"|domUID|null "objName"|objUID|null "ruleName" {ruleData}

RuleSet

Назначение

Изменяет правило ruleName в соответствии с объектом ruleData. Чтобы переименовать правило, передайте в ruleData ключ name с новым именем. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Синтаксис
RuleSet "domName"|domUID|null "objName"|objUID|null "ruleName" {ruleData}

RuleAddVacation

Назначение

Создаёт для аккаунта или домена правило автоответа ruleName по шаблону из настройки VacationTemplate.

  • В период с startDate по stopDate правило отвечает на письма текстом message. Если дата не указана или пустая, период не ограничен с этой стороны.

  • Если задана адресная книга bookName, адреса, которым отправлен автоответ, добавляются в неё, и повторные письма с этих адресов не обрабатываются.

  • Если в addresses указаны адреса, дополнительно создаётся правило, которое в тот же период пересылает копии писем на эти адреса.

Синтаксис
RuleAddVacation "domName"|domUID "accName"|accUID "ruleName" "message" "addresses" ("startDate" ("stopDate" ("bookName")))

RuleGetVacation

Назначение

Выдаёт настройки правила автоответа ruleName.

Синтаксис
RuleGetVacation "domName"|domUID "accName"|accUID "ruleName"

RuleDelVacation

Назначение

Удаляет правило автоответа ruleName.

Синтаксис
RuleDelVacation "domName"|domUID "accName"|accUID "ruleName"

StringListDump

Назначение

Выдаёт список именованных наборов строк или содержимое набора listname, если он указан. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).

Синтаксис
StringListDump "domName"|domUID|null "acc.name"|accUID|null ("listname" (true)

Общекластерные настройки

GlobalGetSetting

Назначение

Выдаёт значение общекластерной настройки по ключу или пути из массива ключей.

Синтаксис
GlobalGetSetting "key"|["key1","key2",..]

GlobalSetSetting

Назначение

Задаёт значение общекластерной настройки по ключу или пути из массива ключей. Если skipCast — true, новое значение не передаётся на другие узлы кластера.

Синтаксис
GlobalSetSetting "key"|["key1","key2",..] {object} (skipCast)

GlobalDelSetting

Назначение

Удаляет значение общекластерной настройки. Если skipCast — true, удаление не передаётся на другие узлы кластера.

Синтаксис
GlobalDelSetting "key"|["key1","key2",..] (skipCast)

Работа с хранилищем некорректных файлов

DefectedFileList

Назначение

Выдаёт список файлов в хранилище некорректных файлов.

Синтаксис
DefectedFileList

DefectedFileGet

Назначение

Выдаёт содержимое файла name из хранилища некорректных файлов в кодировке Base64.

Синтаксис
DefectedFileGet "name"

DefectedFileClear

Назначение

Очищает хранилище некорректных файлов.

Синтаксис
DefectedFileClear

Работа с белыми и чёрными списками сетевых адресов

GetWhitelisted

Назначение

Выдаёт адреса из белого списка, входящие в указанный блок адресов (в нотации CIDR).

Пример — все адреса белого списка:

GetWhitelisted "0.0.0.0/0"
Синтаксис
GetWhitelisted "ip address/0"

GetBlacklisted

Назначение

Выдаёт адреса из чёрного списка, входящие в указанный блок адресов (в нотации CIDR).

Пример — все адреса чёрного списка:

GetBlacklisted "0.0.0.0/0"
Синтаксис
GetBlacklisted "ip address/0"

SetWhitelisted

Назначение

Добавляет адреса в белый список: в течение интервала, заданного в настройках сервера, они не блокируются. Адреса, которые были в чёрном списке, удаляются из него. Для адресов, которые уже есть в белом списке, срок продлевается.

Синтаксис
SetWhitelisted "ip address"|["ip address1","ip address2",...]

SetBlacklisted

Назначение

Добавляет адреса в чёрный список: они блокируются на интервал, заданный в настройках сервера. Адреса, которые были в белом списке, удаляются из него. Для адресов, которые уже есть в чёрном списке, срок продлевается.

Синтаксис
SetBlacklisted "ip address"|["ip address1","ip address2",...]

DelWhitelisted

Назначение

Удаляет адреса из белого списка.

Синтаксис
DelWhitelisted "ip address"|["ip address1","ip address2",...]

DelBlacklisted

Назначение

Удаляет адреса из чёрного списка.

Синтаксис
DelBlacklisted "ip address"|["ip address1","ip address2",...]

Работа с календарями

Общие правила для команд раздела:

  • если параметр calendarMboxName — пустая строка, используется календарь аккаунта по умолчанию;

  • даты и время передаются в формате ISO 8601;

  • необязательный параметр "jump"|"rfc"|"raw" задаёт формат результата.

CalendarUpdate

Назначение

Создаёт или изменяет событие в календаре аккаунта. Событие передаётся объектом VCALENDAR или во внутреннем формате.

Параметр action задаёт действие:

  • publish, cancel, accept, decline, tentative, delegate, propose, progress;

  • import — сохраняет событие с заменой существующего без дополнительных действий (уведомлений, обновления DTSTAMP и т. п.);

  • forward — пересылает сохранённое приглашение на новые адреса, не изменяя календарь.

К действию можно добавить модификатор через _ или пробел, например force_publish:

  • force — не проверять версию события (SEQUENCE, DTSTAMP);

  • silent — не рассылать уведомления участникам.

Дополнительные параметры в формате имя=значение:

  • delegate=email — адрес, которому делегируется участие;

  • progress=число — процент выполнения задачи (100 — выполнена);

  • conflict=accept|decline|decline_conflicted — как поступать с конфликтующими событиями при принятии приглашения;

  • to=email1,email2 — адреса для действия forward.

Синтаксис
CalendarUpdate "domName"|domUID "accName"|accUID "calendarMboxName" "calendarObject"|"calendarUID"|msgUID "action"

Назначение

Выдаёт события календаря аккаунта за интервал от fromTime до tillTime. Повторяющиеся события разбиваются на отдельные экземпляры по правилам повторения (RRULE). Выдаётся не более countBefore событий до момента referenceTime и не более countAfter — после него.

Синтаксис
CalendarSearch "domName"|domUID "accName"|accUID "calendarMboxName" "fromTime" "tillTime" "referenceTime" countBefore countAfter ("jump"|"rfc"|"raw")

CalendarShow

Назначение

Выдаёт событие календаря по его UID или по номеру письма msgUID в том виде, в котором оно хранится.

Синтаксис
CalendarShow "domName"|domUID "accName"|accUID "calendarMboxName" "calendarUID"|msgUID ("jump"|"rfc"|"raw")

CalendarSetAlarm

Назначение

Заменяет напоминания события на переданные в параметре alarm (сокращённый VCALENDAR с VALARM или внутренний формат). Если передать пустой список, напоминания события удаляются.

Синтаксис
CalendarSetAlarm "domName"|domUID "accName"|accUID "calendarMboxName" "calendarUID" "calendar_recurrence" "alarm"

CalendarNextAlarm

Назначение

Выдаёт ближайшее напоминание о событии в календаре. Если fromTime пустой, поиск начинается с текущего момента. Если calendarUID пустой, ищется ближайшее напоминание среди всех событий.

Синтаксис
CalendarNextAlarm "domName"|domUID "accName"|accUID "calendarMboxName" "[fromTime]" "[calendarUID]"

CalendarFreeBusy

Назначение

Выдаёт периоды занятости аккаунта за интервал от fromTime до tillTime. Интервал должен лежать в пределах от текущего момента до 30 дней вперёд. Обязательный параметр accessorMail — адрес аккаунта, от имени которого выполняется запрос; пустая строка — анонимный запрос.

Синтаксис
CalendarFreeBusy "domName"|domUID "accName"|accUID "fromTime" "tillTime" "accessorMail" ("jump"|"rfc"|"raw")

CalendarProposal

Назначение

Принимает (accept) или отклоняет (decline) предложение по событию calendarUID. Предложение хранится в письме proposal_msgUID в папке proposalMboxName; recurrenceID указывает экземпляр повторяющегося события.

Синтаксис
CalendarProposal "domName"|domUID "accName"|accUID "proposalMboxName" proposal_msgUID "calendarMboxName" "calendarUID" "recurrenceID" "accept|decline"

CalendarListUids

Назначение

Выдаёт UID всех событий календаря аккаунта.

Синтаксис
CalendarListUids "domName"|domUID "accName"|accUID "calendarMboxName"

TimeZoneList

Назначение

Выдаёт список часовых поясов, известных серверу.

Синтаксис
TimeZoneList

Работа с контактами

Общие правила для команд раздела:

  • если параметр contactsMboxName — пустая строка, используется адресная книга аккаунта по умолчанию;

  • параметр "jump"|"rfc"|"raw" задаёт формат результата.

ContactsUpdate

Назначение

Создаёт или изменяет контакт в адресной книге аккаунта. Контакт передаётся объектом в формате vCard (RFC) или JUMP.

Синтаксис
ContactsUpdate "domName"|domUID "accName"|accUID "contactsMboxName" "contactsObject"

Назначение

Выдаёт контакты аккаунта, соответствующие запросу searchUri, — не более maxCount записей.

Формат запроса (все поля необязательны):

vcard://?uid=<uid>&fn=<fn_part>&email=<email_part>&title=<title_part>&name=<name_part>
Синтаксис
ContactsSearch "domName"|domUID "accName"|accUID "contactsMboxName" "searchUri" maxCount "jump"|"rfc"|"raw"

ContactsRemove

Назначение

Удаляет контакт из адресной книги аккаунта по UID vCard или по номеру письма msgUID, в котором хранится контакт.

Синтаксис
ContactsRemove "domName"|domUID "accName"|accUID "contactsMboxName" "vcardUID"|msgUID

Работа с полнотекстовым поиском

Назначение

Ищет письма в папке аккаунта mboxName по полнотекстовому индексу и выдаёт UID писем, которые содержат слова из запроса query. Необязательный массив задаёт поля поиска: Body, Attachment, Subject, From, To, Cc, Bcc; по умолчанию поиск ведётся по всем полям.

Синтаксис
FullTextSearch "domName"|domUID "accName"|accUID "mboxName" "query" (["field1","field2",...])

FTIndexSync

Назначение

Синхронизирует полнотекстовые индексы папок аккаунта user@domain, всех аккаунтов домена domain или всего сервера (*). Отсутствующие индексы создаются, недостающие письма индексируются, а записи об удалённых письмах удаляются из индекса.

Синтаксис
FTIndexSync "*"|"domain"|"user@domain"

GlobalSearchMail

Назначение

Ищет письма по всей системе. Параметры поиска передаются словарём params.

Синтаксис
GlobalSearchMail { params }

Работа с профилями SMTP-Input

SMTPIProfilesList

Назначение

Выдаёт профиль SMTP-Input name или все профили, если имя не указано. Если указать true, в результат включаются описания полей; если false — результат не содержит значений по умолчанию.

Синтаксис
SMTPIProfilesList ("name") (true|false)

SMTPIProfilesUpdate

Назначение

Изменяет профили SMTP-Input. Действие зависит от параметров:

  • param1 — словарь: заменяет все профили;

  • param1 — строка, param2 — словарь: заменяет профиль param1 на param2;

  • param1 — строка, param2 — null: удаляет профиль param1;

  • param1 и param2 — строки, param3 — словарь: заменяет в профиле param1 элемент param2 на param3;

  • param1 и param2 — строки, param3 — null: удаляет в профиле param1 элемент param2.

Синтаксис
SMTPIProfilesUpdate param1 (param2 (param3))

Работа с профилями SMTP-Output

SMTPOProfilesList

Назначение

Выдаёт все профили SMTP-Output (без унаследованных значений по умолчанию) или профиль name (с унаследованными значениями). Если указать true, в результат включаются описания полей; если false — результат не содержит значений по умолчанию.

Синтаксис
SMTPOProfilesList ("name") (true|false)

SMTPOProfilesUpdate

Назначение

Изменяет профили SMTP-Output. Действие зависит от параметров:

  • param1 — словарь: заменяет все профили (словарь должен быть в формате, который ожидает сервер);

  • param1 — строка, param2 — словарь: заменяет профиль param1 на param2;

  • param1 — строка, param2 — null: удаляет профиль param1;

  • param1 и param2 — строки, param3 — объект настроек: заменяет в профиле param1 элемент param2 на param3;

  • param1 и param2 — строки, param3 — null: удаляет в профиле param1 элемент param2.

Синтаксис
SMTPOProfilesUpdate param1 (param2 (param3))

Работа со списками адресов

AddressListCheck

Назначение

Проверяет, входит ли IP-адрес в список адресов, переданный текстом. Результат:

  • 1 — адрес входит в список;

  • 0 — не входит;

  • -1 — исключён из списка;

  • -2 — ошибка: неизвестный вложенный список;

  • -3 — ошибка: слишком глубокая вложенность списков.

При неверном формате адреса возвращается ошибка 500 Bad format for an IP address.

Примеры:

AddressListCheck "10.0.0.1" "#NATed\n!10.0.0.2"
AddressListCheck "178.177.53.210" "#@*iva.ru"
Синтаксис
AddressListCheck "IP address" "address list as text"

AddressListGet

Назначение

Выдаёт список адресов с указанным именем или все именованные списки, если имя не указано.

Служебные списки не выводятся в общем перечне, но их можно получить и изменить по имени:

  • $BLOCKED — заблокированные адреса;

  • $UNBLOCKABLE — неблокируемые адреса (белый список);

  • $DEBUG — адреса с включённой отладкой.

Пример:

AddressListGet "LAN"
Синтаксис
AddressListGet ("list name")

AddressListUpdate

Назначение

Изменяет списки адресов:

  • словарь lists — заменяет все именованные списки;

  • имя списка и строка data — заменяет содержимое списка;

  • имя списка и null — удаляет список.

Пример:

AddressListUpdate "LAN_2" "10.1.1.0/8 ; сегмент2\n!10.1.1.2 ; исключение"
Синтаксис
AddressListUpdate {lists}|"list name" ("data"|null)

Работа с настройками федеративного доступа

FederatedSharingList

Назначение

Выдаёт набор настроек федеративного доступа name или все наборы, если имя не указано.

Синтаксис
FederatedSharingList ("name") (true|false)

FederatedSharingUpdate

Назначение

Изменяет настройки федеративного доступа. Действие зависит от параметров:

  • param1 — словарь: заменяет все наборы настроек;

  • param1 — строка, param2 — словарь: заменяет набор param1 на param2;

  • param1 — строка, param2 — null: удаляет набор param1;

  • param1 и param2 — строки, param3 — словарь: заменяет в наборе param1 элемент param2 на param3;

  • param1 и param2 — строки, param3 — null: удаляет в наборе param1 элемент param2.

Синтаксис
FederatedSharingUpdate param1 (param2 (param3))

Работа с планировщиком задач

TaskSchedule

Назначение

Добавляет задание в планировщик.

  • objectId — объект задания: "*" (сервер), домен, аккаунт или =objUID@=domUID;

  • action — название действия;

  • deadline — время выполнения;

  • period — необязательный интервал повторения;

  • args — необязательный аргумент действия (любой объект).

Примеры:

TaskSchedule "postmaster@ivamail.local" "WriteToLog" "\/T 2025-08-27T11:00:00.000Z" "\/D 10m"
TaskSchedule "*" "Maintenance" "\/T 2025-09-26T01:00:00.000Z" "\/D 24h"
Синтаксис
TaskSchedule "objectId" "action" "deadline" ("period") ("args")

TaskCancel

Назначение

Удаляет задание uid из планировщика.

Синтаксис
TaskCancel "uid"

TasksList

Назначение

Выдаёт список запланированных заданий.

  • bInCluster — true: кластерный планировщик, false: планировщик сервера;

  • fromTime — необязательное время, начиная с которого выдаются задания;

  • maxCount — необязательное максимальное количество заданий.

Пример:

TasksList false "\/T 2025-08-27T11:00:00.000Z" 100
Синтаксис
TasksList bInCluster ("fromTime" ("maxCount"))

Работа с отложенными почтовыми отправлениями

DeferredDeliveryPlan

Назначение

Планирует отправку письма messageID на время delayTill. После успешной отправки письмо перемещается в папку targetMbox; если папка не указана, письмо не сохраняется.

Синтаксис
DeferredDeliveryPlan "domName"|domUID "accName"|accUID delayTill "messageID" "targetMbox"

DeferredDeliveryList

Назначение

Выдаёт сведения об отложенных письмах аккаунта (не более 100).

Синтаксис
DeferredDeliveryList "domName"|domUID "accName"|accUID

DeferredDeliverySend

Назначение

Управляет отложенным письмом messageID в зависимости от параметра mode:

  • later — переносит отправку на время deadline (оно должно быть позже текущего);

  • now — отправляет письмо немедленно;

  • never — отменяет отправку.

Синтаксис
DeferredDeliverySend "domName"|domUID "accName"|accUID "messageID" "mode" ("deadline")

Маршрутизация

RouteAddress

Назначение

Проверяет маршрутизацию адреса и выдаёт результат: домен, объект и папку, тег, возможность ретрансляции и внешний маршрут. Необязательный параметр mode задаёт таблицу маршрутизатора, noext отключает вывод внешних маршрутов.

Синтаксис
RouteAddress "address@string" (mode (noext))

RouterGetTable

Назначение

Выдаёт текст таблицы маршрутизатора: mode — 0 для почты, 1 для доступа. Если указан null, выдаётся общекластерная таблица.

Синтаксис
RouterGetTable mode (null)

RouterSetTable

Назначение

Заменяет таблицу маршрутизатора mode текстом tabletext и применяет её. Если указан null, заменяется общекластерная таблица.

Синтаксис
RouterSetTable mode "tabletext" (null)

DNS-резолвер

ResolverGetServers

Назначение

Выдаёт список DNS-серверов, настроенных на сервере.

Синтаксис
ResolverGetServers

ResolverQuery

Назначение

Выполняет DNS-запрос записи типа recordType (A, AAAA, MX, TXT, NS, CNAME, PTR) для имени или адреса domName.

Синтаксис
ResolverQuery "domName" "recordType"

Работа с кластером

Команды раздела используются для диагностики кластера и вывода узлов из его состава.

ClusterGetImage

Назначение

Выдаёт текущее состояние кластера (образ кластера) со сведениями обо всех узлах.

Синтаксис
ClusterGetImage

ClusterLockList

Назначение

Выдаёт список блокировок объектов домена domUID; если указан accUID — только для этого объекта.

Синтаксис
ClusterLockList (domUID (accUID))

ClusterMLockList

Назначение

Выдаёт блокировки, которые удерживает узел memberUID. Результат можно ограничить доменом domUID и объектом accUID.

Синтаксис
ClusterMLockList (memberUID (domUID (accUID)))

ClusterGetStats

Назначение

Выдаёт статистику по узлам кластера: число объектов и подключений.

Синтаксис
ClusterGetStats

ClusterLeave

Назначение

Выводит текущий узел из кластера: узел переходит в режим офлайн. Роль диспетчера при этом может перейти к резервному узлу.

Синтаксис
ClusterLeave

ClusterExclude

Назначение

Исключает узел memberUID из кластера.

Синтаксис
ClusterExclude memberUID

Лицензии

LicenseRequest

Назначение

Формирует запрос на лицензию, подписанный ключом сервера, и сохраняет его в файл file или выдаёт в формате PEM. Словарь object содержит данные запроса: название организации, количество аккаунтов и т. п.

Синтаксис
LicenseRequest "file" {object}

LicenseInstall

Назначение

Проверяет и устанавливает лицензию из файла, строки PEM или словаря. В кластере лицензия передаётся диспетчеру.

Синтаксис
LicenseInstall "file"|"pem"|object