Infoblox
Interact with the Infoblox WAPI with Ruby. Use this gem to list, create, and delete host records.
Installation
Add this line to your application's Gemfile:
gem 'infoblox'
And then execute:
$ bundle
Or install it yourself as:
$ gem install infoblox
Usage
Connecting
An instance of the Infoblox::Connection
class is necessary:
connection = Infoblox::Connection.new(:username => '', :password => '', :host => '')
Querying
Once a connection is made, one can use the resource class methods to query records. You can use the _max_results
and _return_fields
parameters for both find
and all
. See the Infoblox WAPI documentation on how to use these parameters.
# Find all networks. Note that this is limited to 1000 objects, as per the
# Infoblox WAPI documentation.
Infoblox::Network.all(connection)
# => [...]
# Find the first 7890 hosts
Infoblox::Network.all(connection, :_max_results => 7890)
# Find hosts that match a regular expression
Infoblox::Host.find(connection, {"name~" => "demo[0-9]{1,}-web.domain"})
# => [...]
You can also search across the Infoblox cluster using the Infoblox::Search
resource. The response will contain any number of Infoblox::Resource
subclass instances.
result = Infoblox::Search.find(connection, "search_string~" => "webserver-")
# => [#<Infoblox::Host>, #<Infoblox::Ptr>, ...]
Creating a network
The resource class instances support get
, post
, put
, and delete
. For example, creating a network is pretty straightforward:
# create
network = Infoblox::Network.new(:connection => connection)
network.network = "10.20.30.0/24"
network.extensible_attributes = {"VLAN" => "my_vlan"}
network.auto_create_reversezone = true
network.post
# update
network.network = "10.20.31.0/24"
network.put
Changing IP on an existing host
To change the IP of an existing host, you have to poke around in the ipv4addrs collection to find the one you are looking for. The example below assumes that there is only one ipv4 address and just overwrites it.
host = Infoblox::Host.find(connection, {"name~" => "my.host.name"}).first
host.ipv4addrs[0].ipv4addr = "10.10.10.10"
host.put
Basic CRUD examples
To do basic create/update/delete operations on an a_record/ptr_record set:
Create:
a_record = Infoblox::Arecord.new(:connection => connection, :name => <fqdn>, :ipv4addr => <ip_address>)
a_record.post
ptr_record = Infoblox::Ptr.new(:connection => connection, :ptrdname => <fqdn>, :ipv4addr => <ip_address>)
ptr_record.post
Update:
a_record = Infoblox::Arecord.find(connection, {:name => <fqdn>, :ipv4addr => resource_version_last_published.ip_address}).first
a_record.name = <fqdn>
a_record.ipv4addr = <ip_address>
a_record.view = nil
a_record.put
ptr_record = Infoblox::Ptr.find(connection, {:ptrdname => <fqdn>, :ipv4addr => resource_version_last_published.ip_address}).first
ptr_record.ptrdname = <fqdn>
ptr_record.ipv4addr = <ip_address>
ptr_record.view = nil
ptr_record.put
Delete:
a_record = Infoblox::Arecord.find(connection, {:name => <fqdn>, :ipv4addr => <ip_address>}).first
a_record.delete
ptr_record = Infoblox::Ptr.find(connection, {:ptrdname => <fqdn>, :ipv4addr => <ip_address>}).first
ptr_record.delete
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request