pbs_tape_drive_label_media
Write a new label to a tape drive's mounted media and optionally assign it to a media pool. Dry-run returns a plan; set confirm=True to execute. High risk: prior content becomes orphaned.
Instructions
MUTATION: write a NEW label to a drive's mounted media.
RISK_HIGH: writing a new label makes any PRIOR content on the tape ORPHANED/unaddressable through normal PBS tooling — rated the same tier as pbs_tape_drive_format even though raw bytes aren't erased. UNLIKE format-media, this op has NO built-in check that the tape is actually empty — PBS's only guidance is a prose note ("the media need to be empty"), never enforced. Call pbs_tape_drive_read_label first if unsure what's mounted. Dry-run by default (returns a PLAN); confirm=True executes (POST /tape/drive/{drive}/label-media) and returns {"status": "submitted", "result": ""}. No undo. Needs PROXIMO_PBS_* config.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pool | No | Media pool to assign the newly-labeled media to. Omit to assign it to the free-media pool. | |
| drive | Yes | Drive identifier. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the label write. | |
| label_text | Yes | The NEW label text to write (2-32 chars, alnum/underscore start, then alnum/./_/-). | |
| 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 |