Skip to main content

A simple client for the Infoblox NetMRI RESTful API.

Project description

Infoblox NetMRI Client

https://codecov.io/github/infobloxopen/infoblox-netmri/coverage.svg?branch=master https://img.shields.io/travis/infobloxopen/infoblox-netmri.svg https://img.shields.io/pypi/v/infoblox-netmri.svg

A simple client for the Infoblox NetMRI RESTful API.

Features

  • Enables execution of RESTful API calls on the NetMRI via Python.

  • HTTP and HTTPS

Installation

Install infoblox-netmri using pip:

pip install infoblox-netmri

Usage

It’s simple to use. Just create an InfobloxNetMRI object and then call the api_request method. Almost every API request will return a dictionary. It will contain the outputs documented in the online API documentation.

from infoblox_netmri import InfobloxNetMRI

c = InfobloxNetMRI(host="netmri",
                   username="admin",
                   password="password")

devices = c.api_request('devices/index', {'limit': 10})

Now, devices contains a dictionary of the API call outputs. In this case, it contains the standard keys returned by “list” style methods (index, search, find - see the docs): current, start, limit, and the plural form of the model, devices. This last is an array of dictionaries with the device details, while the others describe the “paging” information of the result. So, we really want to loop through devices['devices']:

FORMAT='%30s %16s %10s'
print FORMAT % ('Device Name', 'IP Address', 'Vendor')
for d in devices['devices']:
    print FORMAT % (d['DeviceName'], d['DeviceIPDotted'], d['DeviceVendor'])

NetMRI Documentation

To see documentation on the calls available, visit the page /api/docs on your NetMRI.

Please also see https://github.com/infobloxopen/netmri-toolkit for examples.

History

0.1.5 (2017-08-09)

  • Fix issue #11, where an API versions numbers with a minor part were not seen as valid.

0.1.4 (2017-03-22)

  • Fix issue #7, where an expired session is never renewed.

  • Cleanup and make more Pythonic

0.1.3 (2016-02-19)

  • Implement authentication caching

0.1.2 (2016-01-07)

  • Fix issue passing strings to show and delete methods

  • Add Python 3 compatibility

0.1.1 (2015-11-11)

  • Fix module naming issue

0.1.0 (2015-11-09)

  • First release on PyPI.

Project details


Download files

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

Source Distribution

infoblox-netmri-0.1.5.tar.gz (17.1 kB view hashes)

Uploaded Source

Built Distributions

infoblox_netmri-0.1.5-py2.py3-none-any.whl (8.0 kB view hashes)

Uploaded Python 2 Python 3

infoblox_netmri-0.1.5-py2.7.egg (9.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page