proxbox-api v0.0.11

proxbox-api v0.0.11

This production release is the backend/API half of the Proxbox release train paired with netbox-proxbox v0.0.15. It was validated against NetBox v4.5.8, v4.5.9, and v4.6.0, and publishes both the Python package and Docker image variants used by the plugin.

Highlights

• Adds HA cluster read APIs for the NetBox Proxbox HA tab and cluster page.
• Adds opt-in Proxmox operational verb routes for start, stop, snapshot, and migrate, guarded by endpoint write permissions.
• Adds cloud-init and cloud provisioning support, including /cloud/vm/provision and /cloud/templates.
• Adds NetBox Branching support by forwarding X-NetBox-Branch through full and individual sync flows.
• Adds idempotent NetBox bootstrap, drift-detecting writes, run stamps, orphan sweep support, duplicate-name resolution, discovery tags, and sync-active probing.
• Improves VM sync fidelity: primary MAC writes through dcim.mac_addresses, IPv6 link-local filtering, Proxmox tag sync, description metadata parsing, cloud-init reflection, endpoint placement, and role preservation.
• Adds hardware discovery support through netbox-proxbox credentials, plus Ceph and read-only PBS route surfaces.
• Improves PVE 9 authentication diagnostics and closes abandoned SDK sessions.
• Improves Docker/CI release reliability across raw, nginx, and granian image variants.

Compatibility

• Python: >=3.11
• NetBox validation matrix: v4.5.8, v4.5.9, v4.6.0
• Required companion plugin: netbox-proxbox >= 0.0.15
• SDK pins: proxmox-sdk==0.0.4.post3, netbox-sdk==0.0.8.post1

Closed Issues

• proxbox-api#61 - settings_client now honors ssl_verify=false.
• netbox-proxbox#352 - fixed FastAPI setup failures when using the nginx Docker container.
• netbox-proxbox#357 - added drift-detecting writes with a createOrUpdate helper.
• netbox-proxbox#358 - made NetBox-side supporting object bootstrap idempotent.
• netbox-proxbox#359 - migrated/verified primary MAC linkage through dcim.mac_addresses.
• netbox-proxbox#361 - skips IPv6 link-local addresses and strips zone IDs during IP reconciliation.
• netbox-proxbox#362 - added Proxmox discovery tag patterns for VMs and LXCs.
• netbox-proxbox#363 - added read-side cloud-init reflection fields.
• netbox-proxbox#364 - added role pinning by VM type.
• netbox-proxbox#365 - added tenant assignment by VM-name regex.
• netbox-proxbox#366 - added description metadata parsing and overwrite controls.
• netbox-proxbox#367 - added latest job UUID stamping and orphan deletion support.
• netbox-proxbox#368 - resolves duplicate VM names and emits duplicate-name SSE frames.
• netbox-proxbox#370 - added optional NetBox Branching support.
• netbox-proxbox#372 - added scheduler container mode support.
• netbox-proxbox#374 - added hardware discovery via SSH, dmidecode, and ethtool.
• netbox-proxbox#375 - introduced the backend session refactor foundation.
• netbox-proxbox#376 - added strictly opt-in operational REST endpoints.
• netbox-proxbox#390 - fixed tenant/site definition handling.
• netbox-proxbox#391 - fixed Proxbox VM/LXC object links for NetBox v4.5.9.
• netbox-proxbox#406 - ported Branching and SyncContext support into this release train.
• netbox-proxbox#417 - improved Proxmox VE 9 connection/authentication handling.
• netbox-proxbox#421 - syncs Proxmox tags into NetBox tags.
• N-MultiCloud/nms#12 - supports cloud-init workflows used by the NMS surface.

Verification

• v0.0.11rc8 completed the full release lane across PyPI, Docker Hub, and post-publish E2E.
• PR #108 completed green on the final release commit.
• Main merge commit c3641ab completed docs and CI successfully.
• Tag validation run 25923332054 completed green for v0.0.11.
• Production release run 25931295148 completed green:
  • PyPI publish completed at 2026-05-15T18:59:33Z.
  • PyPI install validation passed on Python 3.11, 3.12, and 3.13.
  • Docker Hub publish passed for raw, nginx, and granian image variants.
  • Post-publish E2E passed against NetBox v4.5.8, v4.5.9, and v4.6.0.
• Release Docker verification run 25931295149 completed green after the images were published.