pbs_tape_drive_create
Create a Proxmox Backup Server tape drive configuration. Specify the drive name and SCSI device path; dry-run by default to preview changes before execution.
Instructions
MUTATION: create a PBS tape drive config.
RISK_MEDIUM: maps 'name' onto real host hardware at 'path' — a wrong path means a future tape job silently targets the wrong physical drive. Dry-run by default (returns a PLAN); confirm=True executes (POST /config/drive, synchronous — PBS returns null) and returns {"status": "ok", "result": None}. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | New drive identifier (3-32 chars, alnum/underscore start, then alnum/./_/-). | |
| path | Yes | Path to the LTO SCSI-generic tape device, e.g. '/dev/sg0'. | |
| changer | No | Optional tape changer identifier this drive is loaded by. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation. | |
| 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. | |
| changer_drivenum | No | Optional changer drive slot number (0-255, default 0; only meaningful with 'changer' set). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |