pve_node_acme_domains_set
Set ACME account and domain list on a Proxmox VE node for certificate issuance. Use with DNS plugin for DNS-01 or standalone for http-01; dry-run by default, confirm to apply.
Instructions
MUTATION: set a node's ACME account + domains (PUT /nodes/{node}/config). Dry-run by default.
The "what to issue" half of an ACME cert: pair with pve_acme_account_create + pve_acme_plugin_create, then issue with pve_acme_cert_order. plugin= uses a DNS-01 challenge (written as acmedomain0..N=domain=...,plugin=...); omit plugin for standalone http-01 (domains ride in acme=...,domains=...). REPLACE semantics: stale acmedomainN entries are removed, not merged. MEDIUM — config only, no cert is issued by this step. confirm=True executes and returns {"status": "ok"}; the default returns a dry-run PLAN dict. Smoke-confirm: node-config body shape against a live PVE instance.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Target PVE node name; omit to use the configured default node. | |
| plugin | No | ACME DNS plugin ID for a DNS-01 challenge; omit to use standalone http-01 instead. | |
| account | Yes | Name of the ACME account (created via pve_acme_account_create) to associate with the node. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the node config change. | |
| domains | Yes | Domain names to request a certificate for; replaces any existing acmedomainN entries on the node. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |