node-icontrol

Overview

Convience methods for making calls to the BIG-IP iControl REST API, mimicking the command style of TMSH.

Requires BIG-IP >= 11.4.0 and an enabled ircd service:

(tmos) # modify sys service ircd add

See F5 iControl REST API documentation for detail:

https://devcentral.f5.com/d/icontrol-rest-user-guide

Installation

npm install icontrol

Usage

Create BIG-IP instance

All default options shown below -- override where desired.

var iControl = require('icontrol');
var bigip = new iControl({
host: '192.168.1.245',
proto: 'https',
port: 443,
user: 'admin',
pass: 'admin',
strict: true,
debug: false
});

List configuration object(s)

bigip.list(path, [options], callback)

bigip.list('/sys/software/image', function(err, res) {
// do something with result
});

or alternatively with options:

bigip.list('/sys/software/image', {
expandAll: true,
includeStats: true
},
function(err, res) {
// do something with result
});

Create configuration object(s)

bigip.create(path, options, callback)

bigip.create('/ltm/pool', {
'name': 'test-pool',
'members': [
{ 'name': '192.168.100.1:80', 'description': 'test-member-1' },
{ 'name': '192.168.100.2:80', 'description': 'test-member-2' },
{ 'name': '192.168.100.3:80', 'description': 'test-member-3' },
]
},
function(err, res) {
// newly-created object
});

Modify existing configuration object

bigip.modify(path, options, callback);

bigip.modify('/ltm/pool/test-pool', {
'description': 'This pool should now have a description'
},
function(err, res) {
// updated JSON object
});

Delete existing configuration object

bigip.delete(path, callback);

bigip.delete('/ltm/pool/test-pool', function(err, res) {
// res should be undefined
});

TODO

• Test against BIG-IQ iControl proxy