directvps

Unofficial DirectVPS API module

nodejs-directvps

Access the DirectVPS API from your Node.js code

To install the module from the npm repository run this:

npm install directvps

And then link inside your code with:

var directvps = require('directvps')

Install directly from Github source:

git clone https://github.com/fvdm/nodejs-directvps.git

And load in your code:

var directvps = require('/path/to/nodejs-directvps')

In order to use the API you need to have an API access private-key and certificate. Refer to the documentation for details. After loading the module with require() set the key and certificate with setup().

Name              Type      Description                          Example
---------------   -------   ----------------------------------   ---------
privateKey        string    The private-key in plain text.
certificate       string    The certificate in plain text.
privateKeyFile    string    Path to the private-key file.        ~/api.key
certificateFile   string    Path to certificate file.            ~/api.crt
verifyCert        boolean   Validate server certificate          true
                            agains trusted CA's.
debugResponse     function  Receive communication details.

This is the simple way, if you have access to a filesystem.

directvps.setup({
    privateKeyFile:     '/path/to/private.key',
    certificateFile:    '/path/to/shared-certificate.crt'
})

Or you can load the private-key and certificate directly, ie. from a database.

directvps.setup({
    privateKey:         '-----BEGIN RSA PRIVATE KEY-----',
    certificate:        '-----BEGIN CERTIFICATE-----'
})

This module is event based, meaning all functions require a callback function parameter to process the result. All methods from the API are implemented directly, but for VPS specific methods a shorthand is also available. The two samples below highlight both methods.

The examples below are based on the NPM install. If you rather directly use the source file use the require() replacement above.

In this example the API method get_vpslist is called, the callback function loops through the resulting servers object and for each server it writes a log to the console.

var directvps = require('directvps')
 
directvps.get_vpslist( function( servers ) {
    for( var s in servers ) {
        var vps = servers[s]
        console.log( 'VPS '+ vps.vpsid +' allows '+ vps.traffic 'GB traffic' )
    }
})

In this example the vps shorthand method is called to get the functions for server 123. Then its sub-function .details is called to get the server's information. In the background the script requests all servers with get_vpslist, loops through them until vpsid 123 is found and then send the result to the callback function. In this case, to write a line to the console.

var directvps = require('directvps')
 
// one line 
directvps.vps(123).details( function( details ) {
    console.log( 'VPS '+ vps.vpsid +' allows '+ vps.traffic 'GB traffic' )
})
 
// or via a variable 
var vps = directvps.vps(123)
vps.details( function( details ) {
    console.log( 'VPS '+ vps.vpsid +' allows '+ vps.traffic 'GB traffic' )
})

Shutdown all servers from one client, these may be identified with 'client: 123' in their tag.

// First get the list of all servers 
directvps.get_vpslist( function( servers ) {
    
    // walk through each of them 
    for( var vpsid in servers ) {
        
        // request server specific functions 
        var vps = directvps.vps( vpsid )
        
        // and its information 
        vps.details = servers[ vpsid ]
        
        // do the matching 
        if( vps.details.tag.match( /^client: 123\, / ) ) {
            
            // found one, shutdown gracefully 
            vps.shutdown( function( plan ) {
                
                // report status to console 
                var status = 'Server '+ vpsid +' shutdown '
                
                if( plan.error == '0' ) {
                    status += 'planned: ID '+ plan.planningid
                } else {
                    status += 'failed: '+ plan.errormessage
                }
                
                console.log( status )
                
            })
            
        }
        
    }
    
})

The methods are described in the wiki at Github:

https://github.com/fvdm/nodejs-directvps/wiki

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to http://unlicense.org