Product SiteDocumentation Site

⁠44.4. Утилита pvesh

Утилита управления PVE (pvesh) позволяет вызывать методы API непосредственно из командной строки, без обращения к серверу REST/HTTPS:
# pvesh ls /
Dr---        access
Dr---        cluster
Dr---        nodes
Drwcd        pools
Dr-c-        storage
-r---        version

Примечание

Для выполнения команд pvesh необходимы права пользователя root.
При обращении к API другого узла кластера утилита автоматически перенаправляет запрос к соответствующему узлу.
Примеры использования:
  • вывести текущую версию PVE:
    # pvesh get /version
    
  • получить список узлов кластера:
    # pvesh get /nodes
    
  • получить список параметров конфигурации центра обработки данных:
    # pvesh usage cluster/options -v
    
  • создать пользователя:
    # pvesh create /access/users --userid testuser@pve
    
  • удалить пользователя:
    # pvesh delete /access/users/testuser@pve
    
  • установить HTML5-консоль NoVNC в качестве консоли по умолчанию:
    # pvesh set cluster/options -console html5
    
  • создать контейнер на узле pve03:
    # pvesh create nodes/pve03/lxc -vmid 210 -hostname test --storage local \
      --password "supersecret" \
      --ostemplate nfs-storage:vztmpl/alt-p11-rootfs-systemd-x86_64.tar.xz \
      --memory 512 --swap 512
    
    Команда возвращает идентификатор задачи, выполняющей создание контейнера:
    UPID:pve03:0000286E:0003553C:66A75FE7:vzcreate:210:root@pam:
    
  • запустить контейнер с идентификатором 210 на узле pve03:
    # pvesh create /nodes/pve03/lxc/210/status/start
    
    Пример ответа:
    UPID:pve03:0000294B:00036B33:66A7601F:vzstart:210:root@pam