pve_acme_plugin_update
Update an ACME DNS challenge plugin's configuration and preview changes with a dry-run plan to avoid breaking certificate renewal.
Instructions
MUTATION: update an ACME DNS challenge plugin. Dry-run by default.
MEDIUM risk — invalid new credentials break cert renewal for every domain using this plugin at the next attempt. To remove a plugin instead use pve_acme_plugin_delete. The dry-run PLAN includes the plugin's current config with any DNS-provider credential redacted; confirm=True executes and returns {"status": "ok"}.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | New plugin-specific credential/config data; omit to leave unchanged. | |
| digest | No | Config digest for optimistic-locking the update against concurrent changes; omit to skip the check. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the update. | |
| disable | No | Set to enable/disable the plugin; omit to leave unchanged. | |
| dns_api | No | New DNS provider API name for a DNS-01 challenge; maps to PVE's 'api' field. Omit to leave unchanged. | |
| plugin_id | Yes | Identifier of the existing ACME DNS challenge plugin to update. | |
| 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |