pve_storage_download
Download an ISO or CT template from a URL to a storage, with dry-run planning and optional verification using checksum.
Instructions
MUTATION: download an ISO (content=iso) or CT template (content=vztmpl) from a URL into a storage. Dry-run by default; confirm=True. Async — returns a UPID (poll with pve_task_status). The URL and its content are operator-trusted — Proximo does not verify or sandbox what it fetches. Use pve_storage_content to see what's already on a storage.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Source URL to download the ISO or CT template from. | |
| node | No | PVE node hosting the storage. Omit to use the configured default node. | |
| confirm | No | Leave `false` (default) to get a dry-run PLAN; set `true` to execute the download. | |
| content | Yes | Content type of the downloaded file: `iso` or `vztmpl`. | |
| storage | Yes | Storage backend name to download the file into. | |
| checksum | No | Expected checksum of the downloaded file, used to verify integrity. | |
| filename | Yes | Filename to save the downloaded content as on the storage. | |
| 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. | |
| checksum_algorithm | No | Algorithm the checksum was computed with (e.g. `sha256`). Required if checksum is given. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |