pbs_acme_plugin_update
Update an ACME DNS challenge plugin on PBS, with dry-run by default to preview changes before applying.
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 pbs_acme_plugin_delete. The dry-run PLAN includes the plugin's current config with the credential blob redacted (PBS DOES return it on read — see module docstring); confirm=True executes (PUT /config/acme/plugins/{id}, synchronous — PBS returns null) and returns {"status": "ok", "result": None}. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | New base64-encoded plugin credential/config data; omit to leave unchanged. Redacted from the PLAN preview and the audit ledger, but IS sent to PBS on confirm=True. | |
| delete | No | Property names to clear: 'disable' and/or 'validation-delay' (the only two the schema allows). | |
| 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; maps to PBS'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. | |
| validation_delay | No | New validation-delay in seconds (0-172800); omit to leave unchanged. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |