Browse files in a PBS backup
proxmox_list_backup_filesBrowse files inside a Proxmox Backup Server backup to locate and restore individual files or disks, starting at / and drilling into directories.
Instructions
Browse the files inside a Proxmox Backup Server backup (single-file restore): start at path "/" to see the archives (disk images/filesystem archives), then drill into directories. Only works for PBS storages. Opening VM disk images starts a temporary restore VM on the node and can take a while on first access.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"storage": "<storage>",
"volid": "<volid>"
},
"name": "proxmox_list_backup_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Node to run the file restore on (default: any node with the storage) | |
| path | No | Path to list, as shown in earlier results (default "/") | |
| limit | No | Maximum number of results (default 500) | |
| volid | Yes | Backup volume ID as listed by proxmox_list_backups, e.g. local:backup/vzdump-qemu-100-2025_01_01-02_00_00.vma.zst or pbs:backup/vm/100/2025-01-01T02:00:00Z | |
| fields | No | ||
| search | No | ||
| storage | Yes | PBS storage ID |