proxmox
Manage Proxmox VE clusters via REST API. Use when user asks to list, start, stop, restart VMs or LXC containers, check node status, create snapshots, view tasks, or manage Proxmox infrastructure. Requires API token or credentials configured.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Manage Proxmox VE clusters via REST API. Use when user asks to list, start, stop, restart VMs or LXC containers, check node status, create snapshots, view tasks, or manage Proxmox infrastructure. Requires API token or credentials configured.
How to use
Utwórz token API w interfejsie Proxmox, przechodząc do Datacenter → Permissions → API Tokens → Add, a następnie zanotuj identyfikator tokenu i jego tajny klucz.
Skonfiguruj dostęp, ustawiając zmienne środowiskowe PROXMOX_HOST (adres serwera, np. https://192.168.1.100:8006), PROXMOX_TOKEN_ID (identyfikator tokenu w formacie user@pam!tokenname) i PROXMOX_TOKEN_SECRET (tajny klucz tokenu). Alternatywnie zapisz te dane w pliku ~/.proxmox-credentials i ustaw uprawnienia chmod 600.
Załaduj konfigurację poleceniem source ~/.proxmox-credentials, aby przygotować zmienne do użytku w bieżącej sesji.
Sprawdź status klastra, wysyłając żądanie curl z nagłówkiem autoryzacji do /api2/json/cluster/status, aby upewnić się, że połączenie działa poprawnie.
Wykonaj operacje na maszynach wirtualnych i kontenerach, wysyłając żądania curl do odpowiednich endpointów API: /nodes/{node}/qemu dla maszyn wirtualnych, /nodes/{node}/lxc dla kontenerów LXC, lub /cluster/resources dla zasobów całego klastra.
Parsuj odpowiedzi JSON za pomocą jq, aby wyświetlić tylko interesujące Cię pola, takie jak vmid, name, status, cpu czy mem.