pve_acme_plugin_create
Creates an ACME DNS challenge plugin for Proxmox VE. Dry-run by default; confirm to execute.
Instructions
MUTATION: create an ACME DNS challenge plugin. Dry-run by default.
Additive — does not affect any existing plugin. dns_api = DNS provider name (e.g. 'cf', 'route53'). Reference plugin_id from pve_node_acme_domains_set(plugin=...) to drive a DNS-01 challenge with it; to remove the plugin use pve_acme_plugin_delete. confirm=True executes and returns {"status": "ok"}; the default returns a dry-run PLAN dict. Smoke-confirm: POST body shape (id in body) against a live PVE instance.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Plugin-specific credential/config data (e.g. API tokens) required by the DNS provider. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the plugin creation. | |
| disable | No | Set to disable the plugin on creation; omit to leave it enabled. | |
| dns_api | No | DNS provider API name for a DNS-01 challenge (e.g. 'cf', 'route53'); maps to PVE's 'api' field. | |
| plugin_id | Yes | Identifier for the new ACME DNS challenge plugin (cluster/acme/plugins/{plugin_id}). | |
| plugin_type | Yes | ACME challenge plugin type, e.g. 'dns' for a DNS-01 challenge plugin. | |
| 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 |