pve_mapping_pci_create
Create a new PCI cluster passthrough mapping for hardware device passthrough. Dry-run by default; set confirm=true to apply the mapping.
Instructions
MUTATION: create a PCI cluster passthrough mapping. Dry-run by default (returns a PLAN); confirm=True executes and returns {"status": "ok", "result": null} (no further payload). Additive — MEDIUM risk, since a mismatched IOMMU/VFIO map can prevent VMs from starting. To modify an existing mapping use pve_mapping_pci_update; to remove one use pve_mapping_pci_delete.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| map | No | PCI device map string(s) defining the physical device(s) covered by this mapping | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation | |
| mapping_id | Yes | Unique ID for the new PCI cluster passthrough mapping | |
| description | No | Optional free-text description stored with the mapping | |
| 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 |