pve_sdn_dns_create
Create a pending SDN DNS integration for PowerDNS. Requires API URL and key; returns a plan by default, confirm to execute.
Instructions
MUTATION: create an SDN dns integration (PENDING — inert until pve_sdn_apply).
url/key are REQUIRED. key is a SECRET — redacted to "[redacted]" in the returned
PLAN and never written to the audit ledger; the real create call still carries it raw
(the mutation must actually work). To update an existing integration use
pve_sdn_dns_update; to remove one use pve_sdn_dns_delete. Dry-run by default (returns a
PLAN); confirm=True creates the pending integration, returning {status, result}.
RISK_LOW (staging, no live network effect).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dns | Yes | New SDN dns integration id to create. | |
| key | Yes | PowerDNS API key — a SECRET, masked in plans/the ledger; forwarded raw on the wire so the create actually works. | |
| url | Yes | PowerDNS API base URL. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the staged mutation. | |
| dns_ttl | No | DNS record TTL in seconds (wire key 'ttl' — named dns_ttl here because this codebase reserves the bare 'ttl' parameter name for the out-of-band arm-lease mechanism). | |
| dns_type | No | Dns plugin type — only 'powerdns' exists today. | powerdns |
| lock_token | No | SDN cluster lock token to use for this write, if one is held. | |
| fingerprint | No | Certificate SHA-256 fingerprint (colon-separated hex byte pairs). | |
| reversemaskv6 | No | IPv6 reverse-zone mask length. | |
| reversev6mask | No | IPv6 reverse-zone mask length (create-only field — not accepted on update; schema asymmetry, see module docstring). | |
| 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 |