pve_mapping_usb_create
Create a USB device passthrough mapping for a Proxmox cluster; dry-run returns a plan, confirm executes.
Instructions
MUTATION: create a USB 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 USB device ID can prevent VMs from acquiring the device. To modify an existing mapping use pve_mapping_usb_update; to remove one use pve_mapping_usb_delete.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| map | No | USB 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 USB 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 |