[pmg-devel] [PATCH pmg-api v3 1/1] fix #3450: api: queue: add POST endpoint for batch deletion/delivery
Hannes Laimer
h.laimer at proxmox.com
Wed Sep 24 09:13:13 CEST 2025
Delivery is done using `postqueue -i <id>`, this is slower than using
`postsuper -r -`. But `postsuper -r -` would only re-queue the mails,
they'd also recieve new IDs. Flush should rather be an immediate delivery
attempt.
The flushing of 2000 mails took ~8s, since 2000 is the max amount
possible through the UI this is ok I think.
DELETE endpoints don't accept data, that is why we didn't extend the
existing DELETE endpoint with an optional `ids` field. This is also how
batch actions, including delete, are done for quarantine.
Signed-off-by: Hannes Laimer <h.laimer at proxmox.com>
---
src/PMG/API2/Postfix.pm | 40 ++++++++++++++++++++++++++++++++++++++++
src/PMG/Postfix.pm | 24 ++++++++++++++++++++++++
2 files changed, 64 insertions(+)
diff --git a/src/PMG/API2/Postfix.pm b/src/PMG/API2/Postfix.pm
index ba0689c..a8f9995 100644
--- a/src/PMG/API2/Postfix.pm
+++ b/src/PMG/API2/Postfix.pm
@@ -335,6 +335,46 @@ __PACKAGE__->register_method({
},
});
+__PACKAGE__->register_method({
+ name => 'queue_action',
+ path => 'queue/{queue}',
+ method => 'POST',
+ description => "Perform an action on the given queue IDs (delete/deliver).",
+ proxyto => 'node',
+ permissions => { check => ['admin'] },
+ protected => 1,
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ queue => $queue_name_option,
+ action => {
+ description => 'Operation to perform on the given IDs.',
+ type => 'string',
+ enum => ['delete', 'deliver'],
+ },
+ ids => {
+ description => 'Queue ID(s), separated by semicolons (;).',
+ type => 'string',
+ pattern => '[a-zA-Z0-9]{8,20}(;[a-zA-Z0-9]{8,20})*',
+ },
+ },
+ },
+ returns => { type => 'null' },
+ code => sub {
+ my ($param) = @_;
+ my @id_list = PVE::Tools::split_list($param->{ids});
+
+ if ($param->{action} eq 'delete') {
+ PMG::Postfix::delete_queue_ids($param->{queue}, \@id_list);
+ } elsif ($param->{action} eq 'deliver') {
+ PMG::Postfix::flush_queue_ids(\@id_list);
+ }
+
+ return undef;
+ },
+});
+
__PACKAGE__->register_method({
name => 'delete_queue',
path => 'queue/{queue}',
diff --git a/src/PMG/Postfix.pm b/src/PMG/Postfix.pm
index 966130f..ca7ac40 100644
--- a/src/PMG/Postfix.pm
+++ b/src/PMG/Postfix.pm
@@ -221,6 +221,30 @@ sub delete_queue {
PVE::Tools::run_command($cmd);
}
+# delete multiple mails by queue IDs
+sub delete_queue_ids {
+ my ($queue, $ids) = @_;
+
+ return if !$ids || ref($ids) ne 'ARRAY' || !@$ids;
+
+ my $input = join("\n", @$ids) . "\n";
+ my $cmd = ['/usr/sbin/postsuper', '-d', '-'];
+ push @$cmd, $queue if defined($queue);
+
+ PVE::Tools::run_command($cmd, input => $input);
+}
+
+# flush multiple mails by queue IDs
+sub flush_queue_ids {
+ my ($ids) = @_;
+
+ return if !$ids || ref($ids) ne 'ARRAY' || !@$ids;
+
+ for my $qid (@$ids) {
+ PVE::Tools::run_command(['/usr/sbin/postqueue', '-i', $qid]);
+ }
+}
+
sub discard_verify_cache {
unlink "/var/lib/postfix/verify_cache.db";
--
2.47.3
More information about the pmg-devel
mailing list