Package: proxmoxmanager
ProxmoxManagerIntroductionProxmoxManager is a smart Python wrapper for Proxmox VE API. It's purpose is to allow easy automatic management for many users with many virtual machines and LCX containers. The idea is that users from external website would unknowingly be registered in Proxmox environment, which will allow them to seamlessly use virtucal machines and containers.ProxmoxManager is based onproxmoxerlibrary and requires it as a dependency.Required version of Python: >=3.7InstallationpipinstallproxmoxmanagerUseful infoProxmox VE is a virtualization platfrom that supports both containers and virtual machines.NodesNode is a real computer on which Proxmox runs. Proxmox can run on multiple nodes which are united into cluster.Each node has it's own unique string ID.UsersProxmox VE has a complex user and permission system. There are two realms in which users are created: PAM (build-in Linux authentication, primarily used for root user) and PVE (Proxmox VE authentication).This library only supports PVE users, because not all API features are availible for PAM users.Usernames are unique string values in formatusername@pamorusername@pve. Because this library only supports PVE realm,@pveis appended automatically to usernames.Users are NOT linked to specific nodes, and they can have access to any VMs/containers.PermissionsEach user has a set of permissions, which consist of a path (e.g.,/vms/100) and a permission name (e.g.Administrator). Each role itself contains a set of permissions.Proxmox allows to give root permissions (with path/) or permissions to all VMs/containers (with path like/vms), but this library for the sake of simplicity only allows to give permissions for specific user to specific VM/container.Virtual machines and containersEach VM/container is located on it's own node and has a unique integer ID (100-99999999), which has to be unique for ALL the nodes.Despite being different objects, VMs and containers cannot share the same ID.This library allows to pass VM/container IDs both as integers and strings, but internally they are always hadnled as strings for the sake of simplicity.UseProxmoxManager library features a ProxmoxManager class that contains all of the library's functionality. To start using it, you will need to generate API key with root access and full permissions.CreatingProxmoxManagerinstance:fromproxmoxmanagerimportProxmoxManagerproxmox_manager=ProxmoxManager(host="example.com:8006",user="root@pam",token_name="TOKEN_NAME",token_value="SECRET_VALUE")ProxmoxManagerclass contains separate classes for nodes, users, virtual machines and containers, which contain methods needed for managing them.By callingnodes,users,vmsorcontainersfield ofProxmoxManagerobject you will get a collection of respective objects that behaves like a Python dict and has some additional features.Example of usage for nodesListing all nodes:proxmox_manager.nodesAccessing specific node:proxmox_manager.nodes["node_id"]Randomly choosing a node (useful for distributing loads evenly):proxmox_manager.nodes.choose_at_random()Choose node with most free memory (in %) and get it's id:id=proxmox_manager.nodes.choose_by_most_free_ram(absolute=False).idExample of usage for usersListing all users:proxmox_manager.usersCreating new user:proxmox_manager.users.create("username","password")Accessing specific user:proxmox_manager.users["username"]Getting auth and csrf tokens of user:proxmox_manager.users["username"].get_tokens("password")Changing user password:proxmox_manager.users["username"].change_password("password","better_new_password")Deleting user:proxmox_manager.users["username"].delete()Example of usage for virtual machines (containers are almost exactly the same)Listing all VMs:proxmox_manager.vmsAccessing specific VM:proxmox_manager.vms["100"]It can also be accesed by integer ID:proxmox_manager.vms[100]Check if VM is a template:proxmox_manager.vms["100"].is_template()Start VM:proxmox_manager.vms["100"].start()Shutdown VM with timeout of 10 seconds after which it will be stopped by force:proxmox_manager.vms["100"].start(timeout=10)Add permission for user to use this VM:proxmox_manager.vms["100"].add_permission(user="username",role="SomeRoleName")Clone VM to the same node and choose ID that is not taken:proxmox_manager.vms["100"].clone(newid=proxmox_manager.smallest_free_vmid())Clone VM to node with most free memory:proxmox_manager.vms["100"].clone(newid="101",newnode=proxmox_manager.nodes.choose_by_most_free_ram())Delete VM:proxmox_manager.vms["100"].delete()