Skip to content
/ pvea Public

node.js library for the proxmox api.

License

Notifications You must be signed in to change notification settings

kaliro/pvea

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

93 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pvea

pvea (pronounced pea-va) is a modern and up-to-date node.js client for the proxmox api. Note: Because of how busy my life has been (moving across the country, etc) I haven't had much time to work on this. I still have more to implement and I need to write documentation, but a good chunk of the Proxmox API is implemented!

Installation:

npm i pvea or yarn add pvea.

To-Do List:

  • Basic functionality.

    • Authenticate with Proxmox VE API.
    • Check if authentication token is expired.
    • Get api version.
  • storage

    • getStorage(param)
    • createStorage(param)
    • getStorageConfig(storage)
    • deleteStorageConfig(storage, param)
    • getStorageStatus(node, storage)
    • getStorageRrdData(node, storage, param)
    • getStorageContent(node, storage, param)
    • allocateDiskImage(node, storage, param)
    • getVolumeAttributes(node, storage, volume, param)
    • deleteVolume(node, storage, volume, param)
    • createBackup(node, param)
    • getBackupConfig(node, param)
  • pools

    • getPools()
    • getPoolConfig(poolid)
    • deletePoolConfig(poolid)
    • updatePoolConfig(poolid, param)
  • nodes

    • getNodes()
    • wakeNode(node)
    • getNodeVersion(node)
    • getNodeTime(node)
    • updateNodeTimeZone(node, param)
    • getNodeLog(node, param)
    • getNodeSubscriptionStatus(node)
    • deleteNodeSubscriptionKey(node)
    • setNodeSubscriptionKey(node)
    • updateNodeSubscriptionKey(node)
    • stopAll(node, param)
    • getNodeStatus(node)
    • rebootNode(node)
    • shutdownNode(node)
    • startAll(node, param)
    • getNodeRrdData(node)
    • getNodeReport(node)
    • getNodeNetstat(node)
    • migrateAll(node, param)
    • getNodeJournal(node, param)
    • getNodeHostname(node)
    • setNodeHostname(node, param)
    • getNodeDnsSettings(node)
    • setNodeDnsSettings(node, param)
    • listNodeCpu(node)
    • getNodeConfig(node, param)
    • updateNodeConfig(node, param)
    • getNodeAplInfo(node)
  • tasks

    • getNodeTasks(node, param)
    • stopTask(node, upid)
    • getTaskLog(node, upid, param)
    • getTaskStatus(node, upid)
  • services

    • reloadService(node, service)
    • restartService(node, service)
    • startService(node, service)
    • stopService(node, service)
    • getServiceState(node, service)
    • listServices(node)
  • lxc

    • listLxcContainers(node)
    • createLxcContainer(node, param)
    • createLxcTemplate(node, vmid)
    • getLxcRRDData(node, vmid, param)
    • resizeLxcContainer(node, vmid, param)
    • getLxcPending(node, vmid)
    • getLxcConfig(node, vmid)
    • cloneLxcContainer(node, vmid, param)
    • suspendLxcContainer(node, vmid)
    • stopLxcContainer(node, vmid)
    • resumeLxcContainer(node, vmid)
    • rebootLxcContainer(node, vmid)
    • getLxcContainerStatus(node, vmid)
    • deleteLxcContainer(node, vmid, param)
    • getLxcSnapshot(node, vmid)
    • createLxcSnapshot(node, vmid, param)
    • deleteLxcSnapshot(node, vmid, snapName, param)
    • getLxcSnapshotConfig(node, vmid, snapName)
    • updateLxcSnapshotMetadata(node, vmid, snapName, param)
    • rollbackLxcContainer(node, vmid, snapName)
    • getLxcFirewallRefs(node, vmid)
    • getLxcFirewallOptions(node, vmid)
    • setLxcFirewallOptions(node, vmid, param)
    • getLxcFirewallLog(node, vmid, param)
    • getLxcFirewallRules(node, vmid)
    • createLxcFirewallRule(node, vmid, param)
    • getLxcFirewallIPSets(node, vmid)
    • createLxcFirewallIPSet(node, vmid, param)
    • getLxcFirewallAliases(node, vmid)
    • createLxcFirewallAlias(node, vmid, param)
  • Write documentation for this library.

Example:

// pvea library.
const pveajs = require("pvea")

// create a new instance, you can use this to connect to multiple nodes if you want.
const pvea = new pveajs('hostname', 'user@auth', 'password')

// our main application.
async function main() {
    // get version of proxmox API.
    pvea.apiVersion().then( res => {
        // log result.
        console.log(res)
    })
}

// execute the application.
pvea.run(main)

Main contributors

As of now, Ami is the only main contributor.

Notes

Thanks to ttarvis for writing node-proxmox! Code was used for reference and function names are taken from it. Also thanks to alo-is for writing another module also called node-proxmox.

License

Copyright 2020 Ami Cole

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

node.js library for the proxmox api.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published