pve_apt_update_refresh
Refresh the APT package index on a PVE node. Dry-run by default; confirm to execute and resynchronize index cache.
Instructions
MUTATION: resynchronize the APT package index on a PVE node (apt-get update).
RISK_LOW: no package state change — refreshes the local index cache only. Proxmox's API deliberately does not expose upgrade execution; the upgrade itself happens at your console. This tool governs visibility only — it does NOT install or upgrade any package. Idempotent — safe to re-run any time. Dry-run by default (returns a PLAN); confirm=True executes (POST, Smoke-confirm) and returns {"status": "submitted"|"ok", "result": <task UPID | None>}.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PVE node name to refresh; defaults to the configured node if omitted. | |
| quiet | No | If True, ask Proxmox to omit progress output suitable only for interactive logging. | |
| notify | No | If True, ask Proxmox to send a notification email about newly available packages. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the index refresh. | |
| 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |