pve_sdn_dns_update
Update an existing SDN DNS integration in Proxmox. Dry-run by default to review changes before applying with confirmation.
Instructions
MUTATION: update an SDN dns integration (PENDING). type is IMMUTABLE.
reversev6mask does NOT exist on this endpoint — only reversemaskv6 (schema
asymmetry vs. create, see pve_sdn_dns_create's own docstring).
key (if given) is redacted in the returned PLAN and never written to the audit
ledger. To create a new integration use pve_sdn_dns_create; to remove one use
pve_sdn_dns_delete. Dry-run by default (returns a PLAN, with the current config
CAPTURED and redacted); confirm=True stages the edit and returns {status, result}.
RISK_LOW (staging).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dns | Yes | Existing SDN dns integration id to update. | |
| key | No | New PowerDNS API key — a SECRET, masked in plans/the ledger; forwarded raw on the wire. | |
| url | No | New PowerDNS API base URL. | |
| delete | No | Field names to unset. | |
| digest | No | Expected config digest for optimistic-concurrency checking. | |
| 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' — see pve_sdn_dns_create's own note on the param-name split). | |
| 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. | |
| 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 |