Skip to main content

Infoblox WAPI module for Python

Project description

pyinfoblox - Infoblox WAPI module for Python

Latest Version Downloads

pyinfoblox is a Python module for interfacing with the Infoblox WAPI.

For more information about the Infoblox WAPI, please refer to the Infoblox WAPI documentation.

pyinfoblox is Open Source and licensed under the BSD License.

Contributions

pyinfoblox is hosted on Github. Please contribute by reporting issues, suggesting features or by sending patches using pull requests.

Installation

The easiest way to install pyinfoblox is by using pip:

$ pip install pyinfoblox

In order to install the latest version of pyinfoblox from the Github repository simply execute these commands instead:

$ git clone https://github.com/dnaeon/pyinfoblox.git
$ cd pyinfoblox
$ python setup.py install

Examples

The first thing we do when using pyinfoblox is to instantiate a new InfobloxWAPI object.

>>> from __future__ import print_function
>>> from pyinfoblox import InfobloxWAPI
>>> infoblox = InfobloxWAPI(
...     username='admin',
...     password='p4ssw0rd',
...     wapi='https://localhost/wapi/v1.1/'
... )

Getting Infoblox networks is as easy as doing:

>>> networks = infoblox.network.get()
>>> print(networks)

Getting a specific network in Infoblox is easy too:

>>> network = infoblox.network.get(network='192.168.1.0/24')
>>> print(network)

Another example that will get all Infoblox ipv4address objects.

>>> ipv4address = infoblox.ipv4address.get()
>>> print(ipv4address)

Here is how to create a new Infoblox network:

>>> objref = infoblox.network.create(
...     network='192.168.1.0/24',
...     comment='This is my test network'
... )
>>> print(objref)
u'network/ZG5zLm5ldHdvcmskMTkyLjE2OC4xLjAvMjQvMA:192.168.1.0/24/default'

Creating new objects returns a reference to the newly created object in Infoblox.

We can also update objects. When we update objects in Infoblox we need to pass the object reference as well. This is how we can update the network we created in the previous example

>>> infoblox.network.update(
...     objref='network/ZG5zLm5ldHdvcmskMTkyLjE2OC4xLjAvMjQvMA:192.168.1.0/24/default',
...     comment='This is my updated network'
... )
u'network/ZG5zLm5ldHdvcmskMTkyLjE2OC4xLjAvMjQvMA:192.168.1.0/24/default'
>>> network = infoblox.network.get(network='192.168.1.0/24')
>>> print(network[0]['comment'])
This is my updated network

When we no longer need an Infoblox object we can always remove it. Just make sure to pass the object reference when deleting objects.

>>> infoblox.network.delete(
...     objref='network/ZG5zLm5ldHdvcmskMTkyLjE2OC4xLjAvMjQvMA:192.168.1.0/24/default'
... )
u'network/ZG5zLm5ldHdvcmskMTkyLjE2OC4xLjAvMjQvMA:192.168.1.0/24/default'

As a last example we will see how to call functions on Infoblox objects.

Here is how to call the next_available_ip function on a network object in order to get the next 3 available IP addresses:

>>> infoblox.network.function(
...     objref='network/ZG5zLm5ldHdvcmskMTkyLjE2OC4xLjAvMjQvMA:192.168.1.0/24/default',
...     _function='next_available_ip',
...     num=3
... )
{u'ips': [u'192.168.1.21', u'192.168.1.22', u'192.168.1.23']}

Project details


Release history Release notifications

This version
History Node

0.1.3

History Node

0.1.1

History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyinfoblox-0.1.3.tar.gz (4.5 kB) Copy SHA256 hash SHA256 Source None Mar 30, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page