Адреса отправки, у которых есть очередь

/vmtas
Кто чем занят

Отдаёт адреса отправки, у которых сейчас есть почта в очереди, по убыванию числа получателей.

Вызов — GET /vmtas?format=json (или xml). Очереди одного адреса руководство предлагает брать через /queues с параметром queue=*/имя-адреса.

Это тоже верхушка: длину задаёт http-default-max-items, по умолчанию десять строк.

Показывает работу адресов, а не их настройки: адрес без почты в очереди сюда не попадёт вовсе.

Доступ решает http-access по адресу, откуда пришёл запрос, — для чтения хватает уровня monitor. Ключ из http-api-key в заголовке X-API-Key даёт полный доступ с любого адреса.

Главная ловушка — искать здесь все адреса узла. Адрес с пустой очередью в ответ не попадает: простаивающий и несуществующий выглядят одинаково — отсутствием. Перечня адресов, заведённых в конфигурации, эта точка не даёт.
Что делает Хаб. Спрашивает — экран «Мониторинг PMTA» берёт эту точку вместе с /status, /queues, /domains и /jobs с длиной maxItems=1000, то есть все адреса, у которых есть очередь, и дополняет их адресами, которые Хаб завёл сам.
Рекомендуемые значения

О чём спрашивать эту точку:

Вопрос Она ли
какие адреса сейчас заняты больше всех да
все адреса с почтой в очереди нет — show vmtas: у команды умолчание «все»
очереди одного адреса нет — /queues с queue=*/имя-адреса
что было вчера нет — это учёт
Отбор «только с почтой в очереди», порядок, длина списка и способ взять очереди одного адреса — из руководства (§ 5.9, § 3.3.1.58.23, § 6.3.21). Разграничение вопросов наше.
Пример в конфигурации
# занятые адреса отправки и очереди одного из них
curl -s 'http://127.0.0.1:8080/vmtas?format=json'curl -s 'http://127.0.0.1:8080/queues?format=json&queue=*/vmta1'
Вторая строка — то, что руководство называет подробностями адреса отправки: отдельной точки для них нет.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Сравнить верхушку с полным перечнем в консоли:
curl -s 'http://127.0.0.1:8080/vmtas?format=json' | head -60
pmta show vmtas
Команда по умолчанию печатает все адреса, а ответ точки — верхушку; разница в числе строк — не расхождение данных.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Прогрев адресов