pbs_tape_media_destroy
Permanently delete a tape medium from Proxmox Backup Server's database. Dry-run by default; confirm to execute destruction.
Instructions
MUTATION: COMPLETELY REMOVES a tape medium from PBS's database.
RISK_HIGH: permanent, no undo — PBS's own description, verbatim: "completely remove from database". THE HTTP VERB IS GET, BUT THE EFFECT IS DESTRUCTIVE — the verb is not the safety signal here; this tool is PLAN-gated and confirm-gated exactly like every POST/PUT/DELETE mutation on this server. Dry-run by default (returns a PLAN, and the dry-run path never reaches the PBS API even though the real call is a GET); confirm=True executes (GET /tape/media/destroy) and returns {"status": "ok", "result": None}. Needs PROXIMO_PBS_* config.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | No | Media UUID identifying which medium to destroy. At least one of label_text/uuid is required. | |
| force | No | Force removal even if this media is used in a media set. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the destroy. | |
| label_text | No | Media label/barcode identifying which medium to destroy (2-32 chars). At least one of label_text/uuid is required. | |
| 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
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |