Unofficial DirectVPS API module
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.
directvpssetupprivateKeyFile: '/path/to/private.key'certificateFile: '/path/to/shared-certificate.crt'
Or you can load the private-key and certificate directly, ie. from a database.
directvpssetupprivateKey: '-----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'directvpsget_vpslistfor var s in serversvar vps = serverssconsole.log 'VPS '+ vpsvpsid +' allows '+ vpstraffic '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 linedirectvpsvps123detailsconsole.log 'VPS '+ vpsvpsid +' allows '+ vpstraffic 'GB traffic'// or via a variablevar vps = directvpsvps123vpsdetailsconsole.log 'VPS '+ vpsvpsid +' allows '+ vpstraffic 'GB traffic'
Shutdown all servers from one client, these may be identified with 'client: 123' in their tag.
// First get the list of all serversdirectvpsget_vpslist// walk through each of themfor var vpsid in servers// request server specific functionsvar vps = directvpsvps vpsid// and its informationvpsdetails = servers vpsid// do the matchingif vpsdetailstagmatch /^client: 123\, /// found one, shutdown gracefullyvpsshutdown// report status to consolevar status = 'Server '+ vpsid +' shutdown 'if plan.error == '0'status += 'planned: ID '+ planplanningidelsestatus += 'failed: '+ planerrormessageconsole.log status
The methods are described in the wiki at Github:
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