delete

критично

Удалить письма из очереди
🔴 Безвозвратно

Удаляет получателей из очереди по отбору: очередь, задание, отправитель, получатель, идентификатор конверта, возраст.

Отбор обязателен: хотя –queue по умолчанию означает все очереди, команда требует явно указать –queue или –jobId — чтобы случайный pmta delete не опустошил очередь.

В учёт удаление записывается как удаление администратором; ключ –no-accounting это отключает. С –dsn отправителю уходит отчёт о недоставке, удаление идёт медленнее, и без –accounting записи в учёте нет.

🔴 Необратимо: удалённое не восстановить, резервных копий спула у нас нет.

Главная ловушка — отбор шире задуманного. –queue=*/* или задание, общее для нескольких рассылок, удалит всё, что под них подошло, без вопроса. Сначала тот же отбор смотрят list — у неё те же ключи, — и только потом удаляют.
Что делает Хаб. Вызывает — операция «Очистить очередь» уходит через POST /command с ключом узла как delete –queue=цель, только после подтверждения в окне и со снимком размера очереди до и после. Форму delete queue цель MTA не принимает — это проверено на узле.
Рекомендуемые значения

Ключи отбора:

Ключ Что отбирает
–queue=домен/адрес очереди; звёздочки допустимы
–jobId одно задание
–orig, –rcpt отправителя или получателя
–envId идентификатор конверта
–older-than=4d получателей старше срока; запись — как у bounce-after
Ключи, обязательный отбор, запись в учёт, –dsn и –no-accounting — из руководства (§ 6.3.24). Порядок «сначала посмотреть» — наш.
Пример в конфигурации
# сначала посмотреть отбор, потом удалить
pmta list --queue=yahoo.com/*
pmta delete --queue=yahoo.com/*
Выделенная строка — пример руководства. Верхняя показывает, что попадёт под удаление: у list те же ключи отбора.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Убедиться, что очередь опустела:
pmta show queues --no-rcpt-events yahoo.com/*
Очереди с нулём получателей или без строк в выводе — удаление прошло.
В Хабе
Цена ошибки
опасно: последствия переживут откат
Сценарии
Аварийная остановка · Подавление адресов
Важность
критично