===============================
Infoblox Client
===============================
.. image:: https://travis-ci.org/infobloxopen/infoblox-client.svg?branch=master
:target: https://travis-ci.org/infobloxopen/infoblox-client
.. image:: https://img.shields.io/pypi/v/infoblox-client.svg
:target: https://pypi.python.org/pypi/infoblox-client
.. image:: https://codecov.io/github/infobloxopen/infoblox-client/coverage.svg?branch=master
:target: https://codecov.io/github/infobloxopen/infoblox-client?branch=master
.. image:: https://readthedocs.org/projects/infoblox-client/badge/?version=latest
:target: http://infoblox-client.readthedocs.org/en/latest/?badge=latest
Client for interacting with Infoblox NIOS over WAPI.
* Free software: Apache license
* Documentation: https://infoblox-client.readthedocs.org.
Installation
------------
Install infoblox-client using pip:
::
pip install infoblox-client
Usage
-----
Configure logger prior to loading infoblox_client to get all debug messages in console:
.. code:: python
import logging
logging.basicConfig(level=logging.DEBUG)
Low level API, using connector module
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Retrieve list of network views from NIOS:
.. code:: python
from infoblox_client import connector
opts = {'host': '192.168.1.10', 'username': 'admin', 'password': 'admin'}
conn = connector.Connector(opts)
# get all network_views
network_views = conn.get_object('networkview')
# search network by cidr in specific network view
network = conn.get_object('network', {'network': '100.0.0.0/8', 'network_view': 'default'})
For these request data is returned as list of dicts:
.. code:: python
network_views:
[{u'_ref': u'networkview/ZG5zLm5ldHdvcmtfdmlldyQw:default/true',
u'is_default': True,
u'name': u'default'}]
network:
[{u'_ref': u'network/ZG5zLm5ldHdvcmskMTAwLjAuMC4wLzgvMA:100.0.0.0/8/default',
u'network': u'100.0.0.0/8',
u'network_view': u'default'}]
High level API, using objects
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Example of creating Network View, Network, DNS View, DNSZone and HostRecord using NIOS objects:
.. code:: python
from infoblox_client import connector
from infoblox_client import objects
opts = {'host': '192.168.1.10', 'username': 'admin', 'password': 'admin'}
conn = connector.Connector(opts)
Create a network view, and network:
.. code:: python
nview = objects.NetworkView.create(conn, name='my_view')
network = objects.Network.create(conn, network_view='my_view', cidr='192.168.1.0/24')
Create a DNS view and zone:
.. code:: python
view = objects.DNSView.create(conn, network_view='my_view', name='my_dns_view')
zone = objects.DNSZone.create(conn, view='my_dns_view', fqdn='my_zone.com')
Create a host record:
.. code:: python
my_ip = objects.IP.create(ip='192.168.1.25', mac='aa:bb:cc:11:22:33')
hr = objects.HostRecord.create(conn, view='my_dns_view',
name='my_host_record.my_zone.com', ip=my_ip)
Create host record with Extensible Attributes (EA):
.. code:: python
ea = objects.EA({'Tenant ID': tenantid, 'CMP Type': cmptype,
'Cloud API Owned': True})
host = objects.HostRecord.create(conn, name='new_host', ip=my_ip, extattrs=ea)
Create a host record with inherited Extensible Attributes (EA):
.. code:: python
my_ip = objects.IP.create(ip='192.168.1.25', mac='aa:bb:cc:11:22:33', use_for_ea_inheritance=True)
hr = objects.HostRecord.create(conn, view='my_dns_view',
name='my_host_record.my_zone.com', ip=my_ip)
Set the TTL to 30 minutes:
.. code:: python
hr = objects.HostRecord.create(conn, view='my_dns_view',
name='my_host_record.my_zone.com', ip=my_ip,
ttl = 1800)
Create a new host record, from the next available IP in a CIDR, with a MAC address, and DHCP enabled:
.. code:: python
next = objects.IPAllocation.next_available_ip_from_cidr('default', '10.0.0.0/24')
my_ip = objects.IP.create(ip=next, mac='aa:bb:cc:11:22:33', configure_for_dhcp=True)
host = objects.HostRecord.create(conn, name='some.valid.fqdn', view='Internal', ip=my_ip)
Reply from NIOS is parsed back into objects and contains next data:
.. code:: python
In [22]: hr
Out[22]: HostRecordV4: _ref=record:host/ZG5zLmhvc3QkLjQuY29tLm15X3pvbmUubXlfaG9zdF9yZWNvcmQ:my_host_record.my_zone.com/my_dns_view, name=my_host_record.my_zone.com, ipv4addrs=[<infoblox_client.objects.IPv4 object at 0x7f7d6b0fe9d0>], view=my_dns_view
Create a new fixed address, with a MS server DHCP reservation:
.. code:: python
obj, created = objects.FixedAddress.create_check_exists(connector=conn,
ip='192.168.100.100',
mac='aa:bb:cc:11:22:33',
comment='My DHCP reservation',
name='My hostname',
network_view='default',
ms_server={'_struct': 'msdhcpserver',
'ipv4addr': '192.168.0.0'})
High level API, using InfobloxObjectManager
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Create a new fixed address, selecting it from the next available IP in a CIDR:
.. code:: python
from infoblox_client.object_manager import InfobloxObjectManager
new_address = InfobloxObjectManager(conn).create_fixed_address_from_cidr(netview='default', mac='aa:bb:cc:11:22:33', cidr='10.0.0.0/24', extattrs=[])
What you get back is a ``FixedAddressV4`` object.
Objects Interface
-----------------
All top level objects support interface for CRUD operations. List of supported objects is defined in next section.
- ``create(cls, connector, check_if_exists=True, update_if_exists=False, **kwargs)``
Creates object on NIOS side.
Requires connector passed as the first argument, ``check_if_exists`` and ``update_if_exists`` are optional.
Object related fields are passed in as kwargs: ``field=value``, ``field2=value2``.
- ``search(cls, connector, return_fields=None, search_extattrs=None, force_proxy=False, **kwargs)``
Search single object on NIOS side, returns first object that match search criteria.
Requires connector passed as the first argument.
``return_fields`` can be set to retrieve particular fields from NIOS,
for example ``return_fields=['view', 'name']``.
If ``return_fields`` is ``[]`` default ``return_fields`` are returned by NIOS side for current ``wapi_version``.
``search_extattrs`` is used to filter out results by extensible attributes.
``force_proxy`` forces search request to be processed on Grid Master (applies only in cloud environment)
- ``search_all(cls, connector, return_fields=None, search_extattrs=None, force_proxy=False, **kwargs)``
Search all objects on NIOS side that match search criteria. Returns a list of objects.
All other options are equal to ``search()``.
- ``update(self)``
Update the object on NIOS side by pushing changes done in the local object.
- ``delete(self)``
Deletes the object from NIOS side.
Supported NIOS objects
----------------------
All NIOS Objects are supported in the 0.6.1 version release. check infoblox_client/objects.py for description of the objects.
Newly supported objects
* ``AAAADtcRecord``
* ``AAAARecord``
* ``AAAASharedRecord``
* ``ADtcRecord``
* ``ADtcRecordBase``
* ``ARecord``
* ``ARecordBase``
* ``ASharedRecord``
* ``ASharedRecordBase``
* ``AdAuthServer``
* ``AdAuthService``
* ``Addressac``
* ``Admingroup``
* ``Adminrole``
* ``Adminuser``
* ``AliasRecord``
* ``Allendpoints``
* ``Allnsgroup``
* ``Allrecords``
* ``Allrpzrecords``
* ``AnyMember``
* ``Approvalworkflow``
* ``Authpolicy``
* ``Awsrte53Task``
* ``Awsrte53Taskgroup``
* ``Awsuser``
* ``BaseObject``
* ``Bfdtemplate``
* ``Bgpas``
* ``Bulkhost``
* ``Bulkhostnametemplate``
* ``CNAMEDtcRecord``
* ``CNAMERecord``
* ``CNAMESharedRecord``
* ``CaaRecord``
* ``Cacertificate``
* ``Capacityreport``
* ``CapacityreportObjectcount``
* ``Captiveportal``
* ``CaptiveportalFile``
* ``CertificateAuthservice``
* ``Changedobject``
* ``CiscoiseEndpoint``
* ``Clientsubnetdomain``
* ``Csvimporttask``
* ``DHCPLease``
* ``DHCPRoamingHost``
* ``DNSView``
* ``DNSZone``
* ``DNSZoneDelegated``
* ``DNSZoneForward``
* ``DbObjects``
* ``Dbsnapshot``
* ``DdnsPrincipalcluster``
* ``DdnsPrincipalclusterGroup``
* ``DeletedObjects``
* ``DhcidRecord``
* ``DhcpOptionDefinition``
* ``DhcpOptionDefinitionV4``
* ``DhcpOptionDefinitionV6``
* ``DhcpOptionSpace``
* ``DhcpOptionSpaceV4``
* ``DhcpOptionSpaceV6``
* ``DhcpStatistics``
* ``Dhcpddns``
* ``Dhcpfailover``
* ``Dhcpmember``
* ``Dhcpoption``
* ``Discovery``
* ``DiscoveryAutoconversionsetting``
* ``DiscoveryCiscoapicconfiguration``
* ``DiscoveryClicredential``
* ``DiscoveryDevice``
* ``DiscoveryDevicecomponent``
* ``DiscoveryDeviceinterface``
* ``DiscoveryDeviceneighbor``
* ``DiscoveryDevicesupportbundle``
* ``DiscoveryDiagnostictask``
* ``DiscoveryGridproperties``
* ``DiscoveryIfaddrinfo``
* ``DiscoveryMemberproperties``
* ``DiscoveryNetworkinfo``
* ``DiscoveryPort``
* ``DiscoveryScaninterface``
* ``DiscoverySeedrouter``
* ``DiscoverySnmp3Credential``
* ``DiscoverySnmpcredential``
* ``DiscoveryStatus``
* ``DiscoveryVlaninfo``
* ``DiscoveryVrf``
* ``DiscoveryVrfmappingrule``
* ``Discoverytask``
* ``Discoverytaskport``
* ``Discoverytaskvserver``
* ``Distributionschedule``
* ``DnameRecord``
* ``Dns64Group``
* ``DnskeyRecord``
* ``Dnsseckey``
* ``Dnssectrustedkey``
* ``DsRecord``
* ``Dtc``
* ``DtcAllrecords``
* ``DtcCertificate``
* ``DtcLbdn``
* ``DtcMonitor``
* ``DtcMonitorHttp``
* ``DtcMonitorIcmp``
* ``DtcMonitorPdp``
* ``DtcMonitorSip``
* ``DtcMonitorSnmp``
* ``DtcMonitorSnmpOid``
* ``DtcMonitorTcp``
* ``DtcObject``
* ``DtcPool``
* ``DtcPoolConsolidatedMonitorHealth``
* ``DtcPoolLink``
* ``DtcServer``
* ``DtcServerLink``
* ``DtcServerMonitor``
* ``DtcTopology``
* ``DtcTopologyLabel``
* ``DtcTopologyRule``
* ``DtcTopologyRuleSource``
* ``DtclbdnRecord``
* ``DxlEndpoint``
* ``DxlEndpointBroker``
* ``EA``
* ``EADefinition``
* ``Exclusionrange``
* ``Exclusionrangetemplate``
* ``ExtensibleattributedefListvalues``
* ``Extserver``
* ``Extsyslogbackupserver``
* ``Fileop``
* ``Filterfingerprint``
* ``Filtermac``
* ``Filternac``
* ``Filteroption``
* ``Filterrelayagent``
* ``Filterrule``
* ``Fingerprint``
* ``FixedAddress``
* ``FixedAddressTemplate``
* ``FixedAddressTemplateV4``
* ``FixedAddressTemplateV6``
* ``FixedAddressV4``
* ``FixedAddressV6``
* ``Forwardingmemberserver``
* ``Ftpuser``
* ``Grid``
* ``GridCloudapi``
* ``GridCloudapiCloudstatistics``
* ``GridCloudapiUser``
* ``GridCloudapiVm``
* ``GridCloudapiVmaddress``
* ``GridDashboard``
* ``GridDhcpproperties``
* ``GridDns``
* ``GridDnsFixedrrsetorderfqdn``
* ``GridFiledistribution``
* ``GridLicensePool``
* ``GridLicensePoolContainer``
* ``GridLicensesubpool``
* ``GridMaxminddbinfo``
* ``GridMemberCloudapi``
* ``GridServicerestartGroup``
* ``GridServicerestartGroupOrder``
* ``GridServicerestartRequest``
* ``GridServicerestartRequestChangedobject``
* ``GridServicerestartStatus``
* ``GridThreatanalytics``
* ``GridThreatprotection``
* ``GridX509Certificate``
* ``GridmemberSoamname``
* ``GridmemberSoaserial``
* ``HostRecord``
* ``HostRecordV4``
* ``HostRecordV6``
* ``Hostnamerewritepolicy``
* ``Hotfix``
* ``HsmAllgroups``
* ``HsmSafenet``
* ``HsmSafenetgroup``
* ``HsmThales``
* ``HsmThalesgroup``
* ``IP``
* ``IPAddress``
* ``IPAllocation``
* ``IPRange``
* ``IPRangeV4``
* ``IPRangeV6``
* ``IPv4``
* ``IPv4Address``
* ``IPv4HostAddress``
* ``IPv6``
* ``IPv6Address``
* ``IPv6HostAddress``
* ``InfobloxObject``
* ``Interface``
* ``IpamStatistics``
* ``Ipv6Networksetting``
* ``Kerberoskey``
* ``LdapAuthService``
* ``LdapEamapping``
* ``LdapServer``
* ``LicenseGridwide``
* ``LocaluserAuthservice``
* ``Logicfilterrule``
* ``Lomnetworkconfig``
* ``Lomuser``
* ``MXRecord``
* ``MXSharedRecord``
* ``Macfilteraddress``
* ``Mastergrid``
* ``Member``
* ``MemberDhcpproperties``
* ``MemberDns``
* ``MemberDnsgluerecordaddr``
* ``MemberDnsip``
* ``MemberFiledistribution``
* ``MemberLicense``
* ``MemberParentalcontrol``
* ``MemberThreatanalytics``
* ``MemberThreatprotection``
* ``Memberserver``
* ``Memberservicecommunication``
* ``Memberservicestatus``
* ``Msdhcpoption``
* ``Msdhcpserver``
* ``Msdnsserver``
* ``Msserver``
* ``MsserverAdsitesDomain``
* ``MsserverAdsitesSite``
* ``MsserverDcnsrecordcreation``
* ``MsserverDhcp``
* ``MsserverDns``
* ``Mssuperscope``
* ``Namedacl``
* ``NaptrDtcRecord``
* ``NaptrRecord``
* ``Natgroup``
* ``Network``
* ``NetworkContainer``
* ``NetworkContainerV4``
* ``NetworkContainerV6``
* ``NetworkDiscovery``
* ``NetworkTemplate``
* ``NetworkTemplateV4``
* ``NetworkTemplateV6``
* ``NetworkV4``
* ``NetworkV6``
* ``NetworkView``
* ``Networkuser``
* ``NetworkviewAssocmember``
* ``Nodeinfo``
* ``NotificationRestEndpoint``
* ``NotificationRestTemplate``
* ``NotificationRestTemplateparameter``
* ``NotificationRule``
* ``NotificationRuleexpressionop``
* ``NsRecord``
* ``Nsec3ParamRecord``
* ``Nsec3Record``
* ``NsecRecord``
* ``Nsgroup``
* ``NsgroupDelegation``
* ``NsgroupForwardingmember``
* ``NsgroupForwardstubserver``
* ``NsgroupStubmember``
* ``Nxdomainrule``
* ``OcspResponder``
* ``Option60Matchrule``
* ``Orderedranges``
* ``Orderedresponsepolicyzones``
* ``Ospf``
* ``OutboundCloudclient``
* ``OutboundCloudclientEvent``
* ``ParentalcontrolAbs``
* ``ParentalcontrolAvp``
* ``ParentalcontrolBlockingpolicy``
* ``ParentalcontrolIpspacediscriminator``
* ``ParentalcontrolMsp``
* ``ParentalcontrolNasgateway``
* ``ParentalcontrolSitemember``
* ``ParentalcontrolSpm``
* ``ParentalcontrolSubscriber``
* ``ParentalcontrolSubscribersite``
* ``Permission``
* ``PtrRecord``
* ``PtrRecordV4``
* ``PtrRecordV6``
* ``RadiusAuthservice``
* ``RadiusServer``
* ``RangeTemplate``
* ``RangeTemplateV4``
* ``RangeTemplateV6``
* ``Rdatasubfield``
* ``Recordnamepolicy``
* ``Remoteddnszone``
* ``Restartservicestatus``
* ``Rir``
* ``RirOrganization``
* ``RpzAIpaddressRecord``
* ``RpzARecord``
* ``RpzAaaaIpaddressRecord``
* ``RpzAaaaRecord``
* ``RpzCnameClientipaddressRecord``
* ``RpzCnameClientipaddressdnRecord``
* ``RpzCnameIpaddressRecord``
* ``RpzCnameIpaddressdnRecord``
* ``RpzCnameRecord``
* ``RpzMxRecord``
* ``RpzNaptrRecord``
* ``RpzPtrRecord``
* ``RpzPtrRecordV4``
* ``RpzPtrRecordV6``
* ``RpzSrvRecord``
* ``RpzTxtRecord``
* ``RrsigRecord``
* ``Ruleset``
* ``SRVDtcRecord``
* ``SRVRecord``
* ``SRVSharedRecord``
* ``SamlAuthservice``
* ``Scavengingtask``
* ``Scheduledtask``
* ``Search``
* ``SettingNetwork``
* ``SettingViewaddress``
* ``SharedNetwork``
* ``SharedNetworkV4``
* ``SharedNetworkV6``
* ``Sharedrecordgroup``
* ``SmartfolderChildren``
* ``SmartfolderGlobal``
* ``SmartfolderGroupby``
* ``SmartfolderPersonal``
* ``SmartfolderQueryitem``
* ``Snmpuser``
* ``Sortlist``
* ``SubObjects``
* ``Superhost``
* ``Superhostchild``
* ``SyslogEndpoint``
* ``SyslogEndpointServers``
* ``Syslogserver``
* ``TXTRecord``
* ``TXTSharedRecord``
* ``TacacsplusAuthservice``
* ``TacacsplusServer``
* ``Taxii``
* ``TaxiiRpzconfig``
* ``Tenant``
* ``Tftpfiledir``
* ``ThreatanalyticsModuleset``
* ``ThreatanalyticsWhitelist``
* ``ThreatinsightCloudclient``
* ``ThreatprotectionGridRule``
* ``ThreatprotectionNatrule``
* ``ThreatprotectionProfile``
* ``ThreatprotectionProfileRule``
* ``ThreatprotectionRule``
* ``ThreatprotectionRulecategory``
* ``ThreatprotectionRuleset``
* ``ThreatprotectionRuletemplate``
* ``ThreatprotectionStatinfo``
* ``ThreatprotectionStatistics``
* ``Thresholdtrap``
* ``TlsaRecord``
* ``Trapnotification``
* ``UnknownRecord``
* ``Updatesdownloadmemberconfig``
* ``Upgradegroup``
* ``UpgradegroupMember``
* ``UpgradegroupSchedule``
* ``Upgradeschedule``
* ``Upgradestatus``
* ``Upgradestep``
* ``Userprofile``
* ``Vdiscoverytask``
* ``Vlan``
* ``Vlanlink``
* ``Vlanrange``
* ``Vlanview``
* ``Vtftpdirmember``
* ``ZoneAuthDiscrepancy``
* ``ZoneRp``
* ``ZoneStub``
* ``Zoneassociation``
* ``Zonenameserver``
Until 0.4.25 this project supported
* ``NetworkView`` for 'networkview'
* ``DNSView`` for 'view'
* ``DNSZone`` for 'zone_auth'
* ``Member`` for 'member'
* ``Network`` (V4 and V6)
* ``NetworkV4`` for 'network'
* ``NetworkV6`` for 'ipv6network'
* ``IPRange`` (V4 and V6)
* ``IPRangeV4`` for 'range'
* ``IPRangeV6`` for 'ipv6range'
* ``HostRecord`` (V4 and V6)
* ``HostRecordV4`` for 'record:host'
* ``HostRecordV6`` for 'record:host'
* ``FixedAddress`` (V4 and V6)
* ``FixedAddressV4`` for 'fixedaddress'
* ``FixedAddressV6`` for 'ipv6fixedaddress'
* ``IPAddress`` (V4 and V6)
* ``IPv4Address`` for 'ipv4address'
* ``IPv6Address`` for 'ipv6address'
* ``ARecordBase``
* ``ARecord`` for 'record:a'
* ``AAAARecord`` for 'record:aaaa'
* ``PtrRecord`` (V4 and V6)
* ``PtrRecordV4`` for 'record:ptr'
* ``PtrRecordV6`` for 'record:ptr'
* ``EADefinition`` for 'extensibleattributedef'
* ``CNAMERecord`` for 'record:cname'
* ``MXRecord`` for 'record:mx'
Search by regular expression
----------------------------
Search for partial match is supported only by low-level API for now.
Use '~' with field name to search by regular expressions. Not all
fields support search by regular expression. Refer to wapidoc to find
out complete list of fields that can be searched this way. Examples:
Find all networks that starts with '10.10.':
.. code:: python
conn = connector.Connector(opts)
nw = conn.get_object('network', {'network~': '10.10.'})
Find all host records that starts with '10.10.':
.. code:: python
conn = connector.Connector(opts)
hr = conn.get_object('record:host', {'ipv4addr~': '10.10.'})
More examples
-------------
Utilizing extensible attributes and searching on them can easily be done with the ``get_object`` function.
The ``default`` field in ``return_fields`` acts like the ``+`` does in WAPI.
> ``_return_fields+`` Specified list of fields (comma separated) will be returned in addition
to the basic fields of the object (documented for each object).
This enables you to always get the default values in return, in addition to what you specify whether
you search for a ``network`` or a ``networkcontainer``,
defined as ``place_to_check`` in the code below.
.. code:: python
from infoblox_client.connector import Connector
def default_infoblox_connection():
opts = {'host': '192.168.1.10', 'username': 'admin', 'password': 'admin'}
conn = Connector(opts)
return conn
def search_extensible_attribute(connection, place_to_check: str, extensible_attribute: str, value: str):
"""
Find extensible attributes.
:param connection: Infoblox connection
:param place_to_check: Can be `network`, `networkcontainer` or `record:host` and so on.
:param extensible_attribute: Which extensible attribute to search for. Can be `CustomerCode`, `Location`
and so on.
:param value: The value you want to search for.
:return: result
"""
extensible_args = [
place_to_check,
{
f"*{extensible_attribute}:~": value,
}
]
kwargs = {
'return_fields': [
'default',
'extattrs',
]
}
result = {"type": f"{place_to_check}", "objects": connection.get_object(*extensible_args, **kwargs)}
return result
connection = default_infoblox_connection()
search_network = search_extensible_attribute(connection, "network", "CustomerCode", "Infoblox")
# Print the output:
print(search_network)
{
"type": "network",
"objects": [
{
"_ref": "network/ZG5zLmhvc3QkLjQuY29tLm15X3pvbmUubXlfaG9zdF9yZWNvcmQ:192.168.1.1/28/default",
"comment": "Infoblox Network",
"extattrs": {
"CustomerCode": {
"value": "Infoblox"
}
},
"network": "192.168.1.0/28",
"network_view": "default"
}
]
}
search_host = search_extensible_attribute(connection, "record:host", "CustomerCode", "Infoblox")
# Print the output:
print(search_host)
{
"type": "record:host",
"objects": [
{
"_ref": "record:host/ZG5zLm5ldHdvcmtfdmlldyQw:InfobloxHost",
"extattrs": {
"CustomerCode": {
"value": "Infoblox"
}
},
"ipv4addrs": [
{
"_ref": "record:host_ipv4addr/ZG5zLm5ldHdvcmtfdmlldyQwdvcmtfdmlldyQw:192.168.1.1/InfobloxHost",
"configure_for_dhcp": false,
"host": "InfobloxHost",
"ipv4addr": "192.168.1.1"
}
],
"name": "InfobloxHost",
"view": " "
}
]
}
Features
--------
* TODO
History
-------
0.6.1 (2024-11-15)
__________________
* Resolved the problem with cookie management and re-authentication upon cookie expiration #384;
* Dropped support for Python versions below 3.6 #384;
0.6.0 (2022-11-18)
__________________
* Added support for Python version 3.9 #352;
* Removed support for Python version below 3.0 #352;
0.5.2 (2022-10-12)
__________________
* Added Certificate based authentication logic #330;
* Fixed use of EA inheritance in IP Objects #318;
* Fixed missing fields ('ipv4addr', 'ipv6addr') for 'class Member()' #345;
0.5.1 (2022-03-14)
__________________
* Updated connector's urlencoding logic for proper array encoding #287;
* Updated InfobloxObject's fetch method to raise `InfobloxFetchGotMultipleObjects` exception #288;
* Fix a bug when calling abstracted class from_dict with V4 & V6 subclass #282;
* Fix a bug when updating DNSZone object exception was raised and field not allowed to update #331;
* Fix a bug when ARecord and AAAARecord object skips updating the updatable fields #334, #328;
* Raised an exception while searching with non searchable fields #339;
* Fix errors generated for the client using sphinx with make docs #343;
**0.5.0 (2020-05-14)**
______________________
* Majorly Updated objects with around 380+ NIOS object calls supported now.(Find the infoblox_client/objects.py file to list the supported objects and its descriptions)
* Bug Fixes
* python-six dependency set to >=1.11.0
0.4.25 (2020-03-12)
___________________
* Bug Fixes
0.4.24 (2020-02-25)
___________________
* Added some extra fields(ms_server) for Fixed Address
* Supporting MX record
* Bug Fixes - PTR records now return an IP
0.4.23 (2019-09-10)
___________________
* Added some extra fields for network class
* Fixed update option for A Record
* Adding fields for fixed address
0.4.22 (2019-02-21)
___________________
* Supported returning default fileds plus user required fields reflecting WAPI
* Supporting 'aliases' parameter of HOST record for DNS
0.4.21 (2019-01-18)
___________________
* Supporting wapi version 2.10 or above
0.4.20 (2018-03-27)
___________________
* Updated default WAPI version from 1.4 to 2.1
0.4.19 (2018-02-06)
___________________
* Changed logging of failure on object search from Error to Warning
0.4.18 (2017-11-20)
___________________
* Fix bug related to temporary unavailable status code
0.4.17 (2017-11-09)
___________________
* Added pagination support for wapi calls
0.4.15 (2017-07-18)
___________________
* Changed logic of generate duid using only mac address
0.4.14 (2017-05-18)
___________________
* Add function to check object is created or reused
0.4.13 (2017-03-01)
___________________
* Add TTL field to HostRecordV*
* Add CNAME record support
* Specify return fields for an SRV record
0.4.12 (2016-12-08)
___________________
* Allow search all fields
* Remove ptrdname from PTR record search attributes
0.4.11 (2016-10-31)
___________________
* Add search HostRecords by MAC
0.4.10 (2016-10-24)
___________________
* Updated history and author
0.4.9 (2016-10-24)
__________________
* Add function to get fixed addresses by mac
0.4.8 (2016-10-10)
__________________
* Add ptrdname search option to PtrRecord objects
0.4.7 (2016-07-14)
__________________
* Add zones extensible attribute update support
0.4.6 (2016-07-01)
__________________
* Add network_view support for host records
0.4.5 (2016-06-13)
__________________
* Allow raising exception in create_ea_definition
* Add pep8 check to tox
* Add pep8 check to Travis CI
* Add examples of searching by regular expression
0.4.4 (2016-05-11)
__________________
* Pass only_ref option to update_from_dict
* Do not fail on processing unknown fields
* Fetch only object reference for service restart
* Update README with example of using EA
0.4.3 (2016-03-28)
__________________
* Add default fields for Member
* Update docstring for create_network
* Add fields to FixedAddressV4 and IPAddress
0.4.2 (2016-03-04)
__________________
* Add max_retries option to connector
* Log failure on get with Error log level
0.4.1 (2016-02-26)
__________________
* Add 'max_results' as connector option
**0.4.0 (2016-02-19)**
______________________
* Add max_results option to connector and objects
* Add Tenant object
* Update README.rst with more examples
0.3.9 (2016-02-18)
__________________
* Add 'configure_for_dns' field for HostRecord
0.3.8 (2016-02-17)
__________________
* Add 'extattrs' to DNSZone/DNSView return_fields
0.3.7 (2016-02-12)
__________________
* Add return_fields to NetworkView
0.3.6 (2016-01-28)
__________________
* Add support for list and tuple values to EA object
* Remove _value_to_bool
0.3.5 (2016-01-22)
__________________
* No changes
0.3.4 (2016-01-21)
__________________
* Do not override verify flag on request level
0.3.3 (2016-01-20)
__________________
* create_required_ea_definitions return created list
* Add 'start_addr', 'end_addr' to ip detection list
* Add request type to connector logger
* Flake8 fixes
0.3.2 (2016-01-19)
__________________
* Convert strings into booleans for ssl_verify
* Update AUTHORS.rst, add contributors
* Remove unused methods from utils.py
0.3.1 (2016-01-14)
__________________
* Add 'zone' to search fields of Host Record
**0.3.0 (2016-01-14)**
______________________
* Update development status from Pre-Alpha to Alpha
* Feature/tox testing (huge changes in testing env)
* Add 'network' to search fields of FixedAddress
* Allow domain-name-servers for ipv6
* Update existent EA for network instead of replace
0.2.3 (2016-01-06)
__________________
* Return None if search failed instead of exception
* Add ip_version as a public property for objects
0.2.2 (2015-12-23)
__________________
* Fix updating object from create method
* Rework delete_all_associated_objects logic
* Fix error handling in create_object
* Do not catch exception on create_dns_zone level
* Update feature version for member_ipv6_setting
0.2.1 (2015-12-18)
__________________
* Add InfobloxMemberAlreadyAssigned exception
* Update dns record if already exists
* Add 'log_api_calls_as_info' option for connector
* Check for empty values in EA
**0.2.0 (2015-12-17)**
______________________
* Deprecate network_exists method in object_manager
* Add _global_field_processing for objects
* Add parsing 'extattrs' into EA objects for all InfobloxObject childs
* Add docs badge to README.rst
* Reworked get_network in object_manager
* Move _eq_ to BaseObject
* Check if fixed address is found before delete
0.1.4 (2015-12-08)
__________________
* Field updates for Member object
* Log all api calls in connector on debug level
0.1.3 (2015-12-04)
__________________
* Add 'network' field to ip versioned fields
* Skip adding DHCP options for IPv6 network
* Do not search IPRange before creating
0.1.2 (2015-12-02)
__________________
* Do not fail if object is not found on delete
* Raise exception with details if reply is not json
* Add 'silent_ssl_warnings' option to connector
0.1.1 (2015-12-01)
__________________
* Fix unbind_name_from_record_a
0.1.0 (2015-12-01)
__________________
* Add new field type '_updateable_search_field' to objects and fix HostRecord search
* Fix 'make docs'
* Update README.rst (fixed formatting)
0.0.11 (2015-11-25)
___________________
* Fix adding second ip to HostRecord
* Fix failing in pdb
* Convert EA values into boolean if possible
* Added 'ips' allias for ip field in HostRecord
0.0.10 (2015-11-19)
___________________
* Add utility to determine supported feature
* Update README.rst with objects interface
0.0.9 (2015-11-13)
__________________
* Add allowed_object_types field for EA Definition
* Allow to return default fields for object
* Update README.rst with list of supported objects
0.0.8 (2015-11-12)
___________________
* Add Extensible Attributes Definition support
* Fixed options processing for create_network in object_manager
* Fixed missed DNSZone object in create_dns_zone
0.0.7 (2015-10-27)
____________________
* Added 'network' to IPRange search fields
* Modified `get` method of the EA class to allow return default values
0.0.6 (2015-10-26)
____________________
* Added initial support of Extensible Attributes as sub objects
* Added search by Extensible Attributes
* Improved validation in connector
* Added delete_object_by_ref to object manager
0.0.5 (2015-10-12)
____________________
* Fixed issues in working with objects
* Added missed _get_object_type_from_ref
* Added code coverage
* Updated links to point to infobloxopen repository
0.0.4 (2015-09-23)
____________________
* Added object abstraction for interacting with NIOS objects
* Added object_manager to simplify some operations on objects
0.0.3 (2015-09-15)
____________________
* Added dependencies to package.
0.0.2 (2015-09-11)
____________________
* Fixed using dashes in package directory names that prevented package import after install.
**0.0.1 (2015-09-11)**
______________________
* Added connector to send wapi requests to NIOS, does not includes NIOS object model at this point.
* First release on PyPI.
Raw data
{
"_id": null,
"home_page": "https://github.com/infobloxopen/infoblox-client",
"name": "infoblox-client",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "infoblox-client",
"author": "John Belamaric",
"author_email": "jbelamaric@infoblox.com",
"download_url": "https://files.pythonhosted.org/packages/81/22/463dab58fe5cff978225a11a5534f825dcc842b599858d64dc1b1cd071ca/infoblox-client-0.6.1.tar.gz",
"platform": null,
"description": "===============================\nInfoblox Client\n===============================\n\n.. image:: https://travis-ci.org/infobloxopen/infoblox-client.svg?branch=master\n :target: https://travis-ci.org/infobloxopen/infoblox-client\n\n.. image:: https://img.shields.io/pypi/v/infoblox-client.svg\n :target: https://pypi.python.org/pypi/infoblox-client\n\n.. image:: https://codecov.io/github/infobloxopen/infoblox-client/coverage.svg?branch=master\n :target: https://codecov.io/github/infobloxopen/infoblox-client?branch=master\n\n.. image:: https://readthedocs.org/projects/infoblox-client/badge/?version=latest\n :target: http://infoblox-client.readthedocs.org/en/latest/?badge=latest\n\nClient for interacting with Infoblox NIOS over WAPI.\n\n* Free software: Apache license\n* Documentation: https://infoblox-client.readthedocs.org.\n\nInstallation\n------------\n\nInstall infoblox-client using pip:\n\n::\n\n pip install infoblox-client\n\nUsage\n-----\n\nConfigure logger prior to loading infoblox_client to get all debug messages in console:\n\n.. code:: python\n\n import logging\n logging.basicConfig(level=logging.DEBUG)\n\nLow level API, using connector module\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nRetrieve list of network views from NIOS:\n\n.. code:: python\n\n from infoblox_client import connector\n\n opts = {'host': '192.168.1.10', 'username': 'admin', 'password': 'admin'}\n conn = connector.Connector(opts)\n # get all network_views\n network_views = conn.get_object('networkview')\n # search network by cidr in specific network view\n network = conn.get_object('network', {'network': '100.0.0.0/8', 'network_view': 'default'})\n\n\nFor these request data is returned as list of dicts:\n\n.. code:: python\n\n network_views:\n [{u'_ref': u'networkview/ZG5zLm5ldHdvcmtfdmlldyQw:default/true',\n u'is_default': True,\n u'name': u'default'}]\n\n network:\n [{u'_ref': u'network/ZG5zLm5ldHdvcmskMTAwLjAuMC4wLzgvMA:100.0.0.0/8/default',\n u'network': u'100.0.0.0/8',\n u'network_view': u'default'}]\n\nHigh level API, using objects\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nExample of creating Network View, Network, DNS View, DNSZone and HostRecord using NIOS objects:\n\n.. code:: python\n\n from infoblox_client import connector\n from infoblox_client import objects\n\n opts = {'host': '192.168.1.10', 'username': 'admin', 'password': 'admin'}\n conn = connector.Connector(opts)\n\nCreate a network view, and network:\n\n.. code:: python\n\n nview = objects.NetworkView.create(conn, name='my_view')\n network = objects.Network.create(conn, network_view='my_view', cidr='192.168.1.0/24')\n\nCreate a DNS view and zone:\n\n.. code:: python\n\n view = objects.DNSView.create(conn, network_view='my_view', name='my_dns_view')\n zone = objects.DNSZone.create(conn, view='my_dns_view', fqdn='my_zone.com')\n\nCreate a host record:\n\n.. code:: python\n\n my_ip = objects.IP.create(ip='192.168.1.25', mac='aa:bb:cc:11:22:33')\n hr = objects.HostRecord.create(conn, view='my_dns_view',\n name='my_host_record.my_zone.com', ip=my_ip)\n\nCreate host record with Extensible Attributes (EA):\n\n.. code:: python\n\n ea = objects.EA({'Tenant ID': tenantid, 'CMP Type': cmptype,\n 'Cloud API Owned': True})\n host = objects.HostRecord.create(conn, name='new_host', ip=my_ip, extattrs=ea)\n\nCreate a host record with inherited Extensible Attributes (EA):\n\n.. code:: python\n\n my_ip = objects.IP.create(ip='192.168.1.25', mac='aa:bb:cc:11:22:33', use_for_ea_inheritance=True)\n hr = objects.HostRecord.create(conn, view='my_dns_view',\n name='my_host_record.my_zone.com', ip=my_ip)\n\nSet the TTL to 30 minutes:\n\n.. code:: python\n\n hr = objects.HostRecord.create(conn, view='my_dns_view',\n name='my_host_record.my_zone.com', ip=my_ip,\n ttl = 1800)\n\nCreate a new host record, from the next available IP in a CIDR, with a MAC address, and DHCP enabled:\n\n.. code:: python\n\n next = objects.IPAllocation.next_available_ip_from_cidr('default', '10.0.0.0/24')\n my_ip = objects.IP.create(ip=next, mac='aa:bb:cc:11:22:33', configure_for_dhcp=True)\n host = objects.HostRecord.create(conn, name='some.valid.fqdn', view='Internal', ip=my_ip)\n\nReply from NIOS is parsed back into objects and contains next data:\n\n.. code:: python\n\n In [22]: hr\n Out[22]: HostRecordV4: _ref=record:host/ZG5zLmhvc3QkLjQuY29tLm15X3pvbmUubXlfaG9zdF9yZWNvcmQ:my_host_record.my_zone.com/my_dns_view, name=my_host_record.my_zone.com, ipv4addrs=[<infoblox_client.objects.IPv4 object at 0x7f7d6b0fe9d0>], view=my_dns_view\n\n\nCreate a new fixed address, with a MS server DHCP reservation:\n\n.. code:: python\n\n obj, created = objects.FixedAddress.create_check_exists(connector=conn,\n ip='192.168.100.100',\n mac='aa:bb:cc:11:22:33',\n comment='My DHCP reservation',\n name='My hostname',\n network_view='default',\n ms_server={'_struct': 'msdhcpserver',\n 'ipv4addr': '192.168.0.0'})\n\n\n\nHigh level API, using InfobloxObjectManager\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nCreate a new fixed address, selecting it from the next available IP in a CIDR:\n\n.. code:: python\n\n from infoblox_client.object_manager import InfobloxObjectManager\n\n new_address = InfobloxObjectManager(conn).create_fixed_address_from_cidr(netview='default', mac='aa:bb:cc:11:22:33', cidr='10.0.0.0/24', extattrs=[])\n\nWhat you get back is a ``FixedAddressV4`` object.\n\nObjects Interface\n-----------------\n\nAll top level objects support interface for CRUD operations. List of supported objects is defined in next section.\n\n- ``create(cls, connector, check_if_exists=True, update_if_exists=False, **kwargs)``\n Creates object on NIOS side.\n Requires connector passed as the first argument, ``check_if_exists`` and ``update_if_exists`` are optional.\n Object related fields are passed in as kwargs: ``field=value``, ``field2=value2``.\n\n- ``search(cls, connector, return_fields=None, search_extattrs=None, force_proxy=False, **kwargs)``\n Search single object on NIOS side, returns first object that match search criteria.\n Requires connector passed as the first argument.\n ``return_fields`` can be set to retrieve particular fields from NIOS,\n for example ``return_fields=['view', 'name']``.\n If ``return_fields`` is ``[]`` default ``return_fields`` are returned by NIOS side for current ``wapi_version``.\n ``search_extattrs`` is used to filter out results by extensible attributes.\n ``force_proxy`` forces search request to be processed on Grid Master (applies only in cloud environment)\n\n- ``search_all(cls, connector, return_fields=None, search_extattrs=None, force_proxy=False, **kwargs)``\n Search all objects on NIOS side that match search criteria. Returns a list of objects.\n All other options are equal to ``search()``.\n\n- ``update(self)``\n Update the object on NIOS side by pushing changes done in the local object.\n\n- ``delete(self)``\n Deletes the object from NIOS side.\n\nSupported NIOS objects\n----------------------\nAll NIOS Objects are supported in the 0.6.1 version release. check infoblox_client/objects.py for description of the objects.\nNewly supported objects\n\n* ``AAAADtcRecord``\n* ``AAAARecord``\n* ``AAAASharedRecord``\n* ``ADtcRecord``\n* ``ADtcRecordBase``\n* ``ARecord``\n* ``ARecordBase``\n* ``ASharedRecord``\n* ``ASharedRecordBase``\n* ``AdAuthServer``\n* ``AdAuthService``\n* ``Addressac``\n* ``Admingroup``\n* ``Adminrole``\n* ``Adminuser``\n* ``AliasRecord``\n* ``Allendpoints``\n* ``Allnsgroup``\n* ``Allrecords``\n* ``Allrpzrecords``\n* ``AnyMember``\n* ``Approvalworkflow``\n* ``Authpolicy``\n* ``Awsrte53Task``\n* ``Awsrte53Taskgroup``\n* ``Awsuser``\n* ``BaseObject``\n* ``Bfdtemplate``\n* ``Bgpas``\n* ``Bulkhost``\n* ``Bulkhostnametemplate``\n* ``CNAMEDtcRecord``\n* ``CNAMERecord``\n* ``CNAMESharedRecord``\n* ``CaaRecord``\n* ``Cacertificate``\n* ``Capacityreport``\n* ``CapacityreportObjectcount``\n* ``Captiveportal``\n* ``CaptiveportalFile``\n* ``CertificateAuthservice``\n* ``Changedobject``\n* ``CiscoiseEndpoint``\n* ``Clientsubnetdomain``\n* ``Csvimporttask``\n* ``DHCPLease``\n* ``DHCPRoamingHost``\n* ``DNSView``\n* ``DNSZone``\n* ``DNSZoneDelegated``\n* ``DNSZoneForward``\n* ``DbObjects``\n* ``Dbsnapshot``\n* ``DdnsPrincipalcluster``\n* ``DdnsPrincipalclusterGroup``\n* ``DeletedObjects``\n* ``DhcidRecord``\n* ``DhcpOptionDefinition``\n* ``DhcpOptionDefinitionV4``\n* ``DhcpOptionDefinitionV6``\n* ``DhcpOptionSpace``\n* ``DhcpOptionSpaceV4``\n* ``DhcpOptionSpaceV6``\n* ``DhcpStatistics``\n* ``Dhcpddns``\n* ``Dhcpfailover``\n* ``Dhcpmember``\n* ``Dhcpoption``\n* ``Discovery``\n* ``DiscoveryAutoconversionsetting``\n* ``DiscoveryCiscoapicconfiguration``\n* ``DiscoveryClicredential``\n* ``DiscoveryDevice``\n* ``DiscoveryDevicecomponent``\n* ``DiscoveryDeviceinterface``\n* ``DiscoveryDeviceneighbor``\n* ``DiscoveryDevicesupportbundle``\n* ``DiscoveryDiagnostictask``\n* ``DiscoveryGridproperties``\n* ``DiscoveryIfaddrinfo``\n* ``DiscoveryMemberproperties``\n* ``DiscoveryNetworkinfo``\n* ``DiscoveryPort``\n* ``DiscoveryScaninterface``\n* ``DiscoverySeedrouter``\n* ``DiscoverySnmp3Credential``\n* ``DiscoverySnmpcredential``\n* ``DiscoveryStatus``\n* ``DiscoveryVlaninfo``\n* ``DiscoveryVrf``\n* ``DiscoveryVrfmappingrule``\n* ``Discoverytask``\n* ``Discoverytaskport``\n* ``Discoverytaskvserver``\n* ``Distributionschedule``\n* ``DnameRecord``\n* ``Dns64Group``\n* ``DnskeyRecord``\n* ``Dnsseckey``\n* ``Dnssectrustedkey``\n* ``DsRecord``\n* ``Dtc``\n* ``DtcAllrecords``\n* ``DtcCertificate``\n* ``DtcLbdn``\n* ``DtcMonitor``\n* ``DtcMonitorHttp``\n* ``DtcMonitorIcmp``\n* ``DtcMonitorPdp``\n* ``DtcMonitorSip``\n* ``DtcMonitorSnmp``\n* ``DtcMonitorSnmpOid``\n* ``DtcMonitorTcp``\n* ``DtcObject``\n* ``DtcPool``\n* ``DtcPoolConsolidatedMonitorHealth``\n* ``DtcPoolLink``\n* ``DtcServer``\n* ``DtcServerLink``\n* ``DtcServerMonitor``\n* ``DtcTopology``\n* ``DtcTopologyLabel``\n* ``DtcTopologyRule``\n* ``DtcTopologyRuleSource``\n* ``DtclbdnRecord``\n* ``DxlEndpoint``\n* ``DxlEndpointBroker``\n* ``EA``\n* ``EADefinition``\n* ``Exclusionrange``\n* ``Exclusionrangetemplate``\n* ``ExtensibleattributedefListvalues``\n* ``Extserver``\n* ``Extsyslogbackupserver``\n* ``Fileop``\n* ``Filterfingerprint``\n* ``Filtermac``\n* ``Filternac``\n* ``Filteroption``\n* ``Filterrelayagent``\n* ``Filterrule``\n* ``Fingerprint``\n* ``FixedAddress``\n* ``FixedAddressTemplate``\n* ``FixedAddressTemplateV4``\n* ``FixedAddressTemplateV6``\n* ``FixedAddressV4``\n* ``FixedAddressV6``\n* ``Forwardingmemberserver``\n* ``Ftpuser``\n* ``Grid``\n* ``GridCloudapi``\n* ``GridCloudapiCloudstatistics``\n* ``GridCloudapiUser``\n* ``GridCloudapiVm``\n* ``GridCloudapiVmaddress``\n* ``GridDashboard``\n* ``GridDhcpproperties``\n* ``GridDns``\n* ``GridDnsFixedrrsetorderfqdn``\n* ``GridFiledistribution``\n* ``GridLicensePool``\n* ``GridLicensePoolContainer``\n* ``GridLicensesubpool``\n* ``GridMaxminddbinfo``\n* ``GridMemberCloudapi``\n* ``GridServicerestartGroup``\n* ``GridServicerestartGroupOrder``\n* ``GridServicerestartRequest``\n* ``GridServicerestartRequestChangedobject``\n* ``GridServicerestartStatus``\n* ``GridThreatanalytics``\n* ``GridThreatprotection``\n* ``GridX509Certificate``\n* ``GridmemberSoamname``\n* ``GridmemberSoaserial``\n* ``HostRecord``\n* ``HostRecordV4``\n* ``HostRecordV6``\n* ``Hostnamerewritepolicy``\n* ``Hotfix``\n* ``HsmAllgroups``\n* ``HsmSafenet``\n* ``HsmSafenetgroup``\n* ``HsmThales``\n* ``HsmThalesgroup``\n* ``IP``\n* ``IPAddress``\n* ``IPAllocation``\n* ``IPRange``\n* ``IPRangeV4``\n* ``IPRangeV6``\n* ``IPv4``\n* ``IPv4Address``\n* ``IPv4HostAddress``\n* ``IPv6``\n* ``IPv6Address``\n* ``IPv6HostAddress``\n* ``InfobloxObject``\n* ``Interface``\n* ``IpamStatistics``\n* ``Ipv6Networksetting``\n* ``Kerberoskey``\n* ``LdapAuthService``\n* ``LdapEamapping``\n* ``LdapServer``\n* ``LicenseGridwide``\n* ``LocaluserAuthservice``\n* ``Logicfilterrule``\n* ``Lomnetworkconfig``\n* ``Lomuser``\n* ``MXRecord``\n* ``MXSharedRecord``\n* ``Macfilteraddress``\n* ``Mastergrid``\n* ``Member``\n* ``MemberDhcpproperties``\n* ``MemberDns``\n* ``MemberDnsgluerecordaddr``\n* ``MemberDnsip``\n* ``MemberFiledistribution``\n* ``MemberLicense``\n* ``MemberParentalcontrol``\n* ``MemberThreatanalytics``\n* ``MemberThreatprotection``\n* ``Memberserver``\n* ``Memberservicecommunication``\n* ``Memberservicestatus``\n* ``Msdhcpoption``\n* ``Msdhcpserver``\n* ``Msdnsserver``\n* ``Msserver``\n* ``MsserverAdsitesDomain``\n* ``MsserverAdsitesSite``\n* ``MsserverDcnsrecordcreation``\n* ``MsserverDhcp``\n* ``MsserverDns``\n* ``Mssuperscope``\n* ``Namedacl``\n* ``NaptrDtcRecord``\n* ``NaptrRecord``\n* ``Natgroup``\n* ``Network``\n* ``NetworkContainer``\n* ``NetworkContainerV4``\n* ``NetworkContainerV6``\n* ``NetworkDiscovery``\n* ``NetworkTemplate``\n* ``NetworkTemplateV4``\n* ``NetworkTemplateV6``\n* ``NetworkV4``\n* ``NetworkV6``\n* ``NetworkView``\n* ``Networkuser``\n* ``NetworkviewAssocmember``\n* ``Nodeinfo``\n* ``NotificationRestEndpoint``\n* ``NotificationRestTemplate``\n* ``NotificationRestTemplateparameter``\n* ``NotificationRule``\n* ``NotificationRuleexpressionop``\n* ``NsRecord``\n* ``Nsec3ParamRecord``\n* ``Nsec3Record``\n* ``NsecRecord``\n* ``Nsgroup``\n* ``NsgroupDelegation``\n* ``NsgroupForwardingmember``\n* ``NsgroupForwardstubserver``\n* ``NsgroupStubmember``\n* ``Nxdomainrule``\n* ``OcspResponder``\n* ``Option60Matchrule``\n* ``Orderedranges``\n* ``Orderedresponsepolicyzones``\n* ``Ospf``\n* ``OutboundCloudclient``\n* ``OutboundCloudclientEvent``\n* ``ParentalcontrolAbs``\n* ``ParentalcontrolAvp``\n* ``ParentalcontrolBlockingpolicy``\n* ``ParentalcontrolIpspacediscriminator``\n* ``ParentalcontrolMsp``\n* ``ParentalcontrolNasgateway``\n* ``ParentalcontrolSitemember``\n* ``ParentalcontrolSpm``\n* ``ParentalcontrolSubscriber``\n* ``ParentalcontrolSubscribersite``\n* ``Permission``\n* ``PtrRecord``\n* ``PtrRecordV4``\n* ``PtrRecordV6``\n* ``RadiusAuthservice``\n* ``RadiusServer``\n* ``RangeTemplate``\n* ``RangeTemplateV4``\n* ``RangeTemplateV6``\n* ``Rdatasubfield``\n* ``Recordnamepolicy``\n* ``Remoteddnszone``\n* ``Restartservicestatus``\n* ``Rir``\n* ``RirOrganization``\n* ``RpzAIpaddressRecord``\n* ``RpzARecord``\n* ``RpzAaaaIpaddressRecord``\n* ``RpzAaaaRecord``\n* ``RpzCnameClientipaddressRecord``\n* ``RpzCnameClientipaddressdnRecord``\n* ``RpzCnameIpaddressRecord``\n* ``RpzCnameIpaddressdnRecord``\n* ``RpzCnameRecord``\n* ``RpzMxRecord``\n* ``RpzNaptrRecord``\n* ``RpzPtrRecord``\n* ``RpzPtrRecordV4``\n* ``RpzPtrRecordV6``\n* ``RpzSrvRecord``\n* ``RpzTxtRecord``\n* ``RrsigRecord``\n* ``Ruleset``\n* ``SRVDtcRecord``\n* ``SRVRecord``\n* ``SRVSharedRecord``\n* ``SamlAuthservice``\n* ``Scavengingtask``\n* ``Scheduledtask``\n* ``Search``\n* ``SettingNetwork``\n* ``SettingViewaddress``\n* ``SharedNetwork``\n* ``SharedNetworkV4``\n* ``SharedNetworkV6``\n* ``Sharedrecordgroup``\n* ``SmartfolderChildren``\n* ``SmartfolderGlobal``\n* ``SmartfolderGroupby``\n* ``SmartfolderPersonal``\n* ``SmartfolderQueryitem``\n* ``Snmpuser``\n* ``Sortlist``\n* ``SubObjects``\n* ``Superhost``\n* ``Superhostchild``\n* ``SyslogEndpoint``\n* ``SyslogEndpointServers``\n* ``Syslogserver``\n* ``TXTRecord``\n* ``TXTSharedRecord``\n* ``TacacsplusAuthservice``\n* ``TacacsplusServer``\n* ``Taxii``\n* ``TaxiiRpzconfig``\n* ``Tenant``\n* ``Tftpfiledir``\n* ``ThreatanalyticsModuleset``\n* ``ThreatanalyticsWhitelist``\n* ``ThreatinsightCloudclient``\n* ``ThreatprotectionGridRule``\n* ``ThreatprotectionNatrule``\n* ``ThreatprotectionProfile``\n* ``ThreatprotectionProfileRule``\n* ``ThreatprotectionRule``\n* ``ThreatprotectionRulecategory``\n* ``ThreatprotectionRuleset``\n* ``ThreatprotectionRuletemplate``\n* ``ThreatprotectionStatinfo``\n* ``ThreatprotectionStatistics``\n* ``Thresholdtrap``\n* ``TlsaRecord``\n* ``Trapnotification``\n* ``UnknownRecord``\n* ``Updatesdownloadmemberconfig``\n* ``Upgradegroup``\n* ``UpgradegroupMember``\n* ``UpgradegroupSchedule``\n* ``Upgradeschedule``\n* ``Upgradestatus``\n* ``Upgradestep``\n* ``Userprofile``\n* ``Vdiscoverytask``\n* ``Vlan``\n* ``Vlanlink``\n* ``Vlanrange``\n* ``Vlanview``\n* ``Vtftpdirmember``\n* ``ZoneAuthDiscrepancy``\n* ``ZoneRp``\n* ``ZoneStub``\n* ``Zoneassociation``\n* ``Zonenameserver``\n\nUntil 0.4.25 this project supported\n\n* ``NetworkView`` for 'networkview'\n* ``DNSView`` for 'view'\n* ``DNSZone`` for 'zone_auth'\n* ``Member`` for 'member'\n* ``Network`` (V4 and V6)\n\n * ``NetworkV4`` for 'network'\n * ``NetworkV6`` for 'ipv6network'\n\n* ``IPRange`` (V4 and V6)\n\n * ``IPRangeV4`` for 'range'\n * ``IPRangeV6`` for 'ipv6range'\n\n* ``HostRecord`` (V4 and V6)\n\n * ``HostRecordV4`` for 'record:host'\n * ``HostRecordV6`` for 'record:host'\n\n* ``FixedAddress`` (V4 and V6)\n\n * ``FixedAddressV4`` for 'fixedaddress'\n * ``FixedAddressV6`` for 'ipv6fixedaddress'\n\n* ``IPAddress`` (V4 and V6)\n\n * ``IPv4Address`` for 'ipv4address'\n * ``IPv6Address`` for 'ipv6address'\n\n* ``ARecordBase``\n\n * ``ARecord`` for 'record:a'\n * ``AAAARecord`` for 'record:aaaa'\n\n* ``PtrRecord`` (V4 and V6)\n\n * ``PtrRecordV4`` for 'record:ptr'\n * ``PtrRecordV6`` for 'record:ptr'\n\n* ``EADefinition`` for 'extensibleattributedef'\n* ``CNAMERecord`` for 'record:cname'\n* ``MXRecord`` for 'record:mx'\n\n\nSearch by regular expression\n----------------------------\n\nSearch for partial match is supported only by low-level API for now.\nUse '~' with field name to search by regular expressions. Not all\nfields support search by regular expression. Refer to wapidoc to find\nout complete list of fields that can be searched this way. Examples:\n\nFind all networks that starts with '10.10.':\n\n.. code:: python\n\n conn = connector.Connector(opts)\n nw = conn.get_object('network', {'network~': '10.10.'})\n\n\nFind all host records that starts with '10.10.':\n\n.. code:: python\n\n conn = connector.Connector(opts)\n hr = conn.get_object('record:host', {'ipv4addr~': '10.10.'})\n\n\nMore examples\n-------------\n\nUtilizing extensible attributes and searching on them can easily be done with the ``get_object`` function.\nThe ``default`` field in ``return_fields`` acts like the ``+`` does in WAPI.\n\n > ``_return_fields+`` Specified list of fields (comma separated) will be returned in addition\n to the basic fields of the object (documented for each object).\n\nThis enables you to always get the default values in return, in addition to what you specify whether\nyou search for a ``network`` or a ``networkcontainer``,\ndefined as ``place_to_check`` in the code below.\n\n\n.. code:: python\n\n from infoblox_client.connector import Connector\n\n\n def default_infoblox_connection():\n opts = {'host': '192.168.1.10', 'username': 'admin', 'password': 'admin'}\n conn = Connector(opts)\n return conn\n\n def search_extensible_attribute(connection, place_to_check: str, extensible_attribute: str, value: str):\n \"\"\"\n Find extensible attributes.\n :param connection: Infoblox connection\n :param place_to_check: Can be `network`, `networkcontainer` or `record:host` and so on.\n :param extensible_attribute: Which extensible attribute to search for. Can be `CustomerCode`, `Location`\n and so on.\n :param value: The value you want to search for.\n :return: result\n \"\"\"\n extensible_args = [\n place_to_check,\n {\n f\"*{extensible_attribute}:~\": value,\n }\n ]\n kwargs = {\n 'return_fields': [\n 'default',\n 'extattrs',\n ]\n }\n result = {\"type\": f\"{place_to_check}\", \"objects\": connection.get_object(*extensible_args, **kwargs)}\n return result\n\n connection = default_infoblox_connection()\n\n search_network = search_extensible_attribute(connection, \"network\", \"CustomerCode\", \"Infoblox\")\n # Print the output:\n print(search_network)\n {\n \"type\": \"network\",\n \"objects\": [\n {\n \"_ref\": \"network/ZG5zLmhvc3QkLjQuY29tLm15X3pvbmUubXlfaG9zdF9yZWNvcmQ:192.168.1.1/28/default\",\n \"comment\": \"Infoblox Network\",\n \"extattrs\": {\n \"CustomerCode\": {\n \"value\": \"Infoblox\"\n }\n },\n \"network\": \"192.168.1.0/28\",\n \"network_view\": \"default\"\n }\n ]\n }\n\n search_host = search_extensible_attribute(connection, \"record:host\", \"CustomerCode\", \"Infoblox\")\n # Print the output:\n print(search_host)\n {\n \"type\": \"record:host\",\n \"objects\": [\n {\n \"_ref\": \"record:host/ZG5zLm5ldHdvcmtfdmlldyQw:InfobloxHost\",\n \"extattrs\": {\n \"CustomerCode\": {\n \"value\": \"Infoblox\"\n }\n },\n \"ipv4addrs\": [\n {\n \"_ref\": \"record:host_ipv4addr/ZG5zLm5ldHdvcmtfdmlldyQwdvcmtfdmlldyQw:192.168.1.1/InfobloxHost\",\n \"configure_for_dhcp\": false,\n \"host\": \"InfobloxHost\",\n \"ipv4addr\": \"192.168.1.1\"\n }\n ],\n \"name\": \"InfobloxHost\",\n \"view\": \" \"\n }\n ]\n }\n\nFeatures\n--------\n\n* TODO\n\n\n\n\nHistory\n-------\n\n0.6.1 (2024-11-15)\n__________________\n* Resolved the problem with cookie management and re-authentication upon cookie expiration #384;\n* Dropped support for Python versions below 3.6 #384;\n\n\n0.6.0 (2022-11-18)\n__________________\n* Added support for Python version 3.9 #352;\n* Removed support for Python version below 3.0 #352;\n\n0.5.2 (2022-10-12)\n__________________\n* Added Certificate based authentication logic #330;\n* Fixed use of EA inheritance in IP Objects #318;\n* Fixed missing fields ('ipv4addr', 'ipv6addr') for 'class Member()' #345;\n\n0.5.1 (2022-03-14)\n__________________\n* Updated connector's urlencoding logic for proper array encoding #287;\n* Updated InfobloxObject's fetch method to raise `InfobloxFetchGotMultipleObjects` exception #288;\n* Fix a bug when calling abstracted class from_dict with V4 & V6 subclass #282;\n* Fix a bug when updating DNSZone object exception was raised and field not allowed to update #331;\n* Fix a bug when ARecord and AAAARecord object skips updating the updatable fields #334, #328;\n* Raised an exception while searching with non searchable fields #339;\n* Fix errors generated for the client using sphinx with make docs #343;\n\n**0.5.0 (2020-05-14)**\n______________________\n* Majorly Updated objects with around 380+ NIOS object calls supported now.(Find the infoblox_client/objects.py file to list the supported objects and its descriptions)\n* Bug Fixes\n* python-six dependency set to >=1.11.0\n\n0.4.25 (2020-03-12)\n___________________\n* Bug Fixes\n\n0.4.24 (2020-02-25)\n___________________\n* Added some extra fields(ms_server) for Fixed Address\n* Supporting MX record\n* Bug Fixes - PTR records now return an IP\n\n0.4.23 (2019-09-10)\n___________________\n\n* Added some extra fields for network class\n* Fixed update option for A Record\n* Adding fields for fixed address\n\n0.4.22 (2019-02-21)\n___________________\n\n* Supported returning default fileds plus user required fields reflecting WAPI\n* Supporting 'aliases' parameter of HOST record for DNS\n\n0.4.21 (2019-01-18)\n___________________\n\n* Supporting wapi version 2.10 or above\n\n0.4.20 (2018-03-27)\n___________________\n\n* Updated default WAPI version from 1.4 to 2.1\n\n0.4.19 (2018-02-06)\n___________________\n\n* Changed logging of failure on object search from Error to Warning\n\n0.4.18 (2017-11-20)\n___________________\n\n* Fix bug related to temporary unavailable status code\n\n0.4.17 (2017-11-09)\n___________________\n\n* Added pagination support for wapi calls\n\n0.4.15 (2017-07-18)\n___________________\n\n* Changed logic of generate duid using only mac address\n\n0.4.14 (2017-05-18)\n___________________\n\n* Add function to check object is created or reused\n\n0.4.13 (2017-03-01)\n___________________\n* Add TTL field to HostRecordV*\n* Add CNAME record support\n* Specify return fields for an SRV record\n\n0.4.12 (2016-12-08)\n___________________\n* Allow search all fields\n* Remove ptrdname from PTR record search attributes\n\n0.4.11 (2016-10-31)\n___________________\n* Add search HostRecords by MAC\n\n0.4.10 (2016-10-24)\n___________________\n* Updated history and author\n\n0.4.9 (2016-10-24)\n__________________\n* Add function to get fixed addresses by mac\n\n0.4.8 (2016-10-10)\n__________________\n* Add ptrdname search option to PtrRecord objects\n\n0.4.7 (2016-07-14)\n__________________\n* Add zones extensible attribute update support\n\n0.4.6 (2016-07-01)\n__________________\n* Add network_view support for host records\n\n0.4.5 (2016-06-13)\n__________________\n* Allow raising exception in create_ea_definition\n* Add pep8 check to tox\n* Add pep8 check to Travis CI\n* Add examples of searching by regular expression\n\n0.4.4 (2016-05-11)\n__________________\n* Pass only_ref option to update_from_dict\n* Do not fail on processing unknown fields\n* Fetch only object reference for service restart\n* Update README with example of using EA\n\n0.4.3 (2016-03-28)\n__________________\n* Add default fields for Member\n* Update docstring for create_network\n* Add fields to FixedAddressV4 and IPAddress\n\n0.4.2 (2016-03-04)\n__________________\n* Add max_retries option to connector\n* Log failure on get with Error log level\n\n0.4.1 (2016-02-26)\n__________________\n* Add 'max_results' as connector option\n\n**0.4.0 (2016-02-19)**\n______________________\n* Add max_results option to connector and objects\n* Add Tenant object\n* Update README.rst with more examples\n\n\n0.3.9 (2016-02-18)\n__________________\n* Add 'configure_for_dns' field for HostRecord\n\n0.3.8 (2016-02-17)\n__________________\n* Add 'extattrs' to DNSZone/DNSView return_fields\n\n0.3.7 (2016-02-12)\n__________________\n* Add return_fields to NetworkView\n\n0.3.6 (2016-01-28)\n__________________\n* Add support for list and tuple values to EA object\n* Remove _value_to_bool\n\n0.3.5 (2016-01-22)\n__________________\n* No changes\n\n0.3.4 (2016-01-21)\n__________________\n* Do not override verify flag on request level\n\n0.3.3 (2016-01-20)\n__________________\n* create_required_ea_definitions return created list\n* Add 'start_addr', 'end_addr' to ip detection list\n* Add request type to connector logger\n* Flake8 fixes\n\n0.3.2 (2016-01-19)\n__________________\n* Convert strings into booleans for ssl_verify\n* Update AUTHORS.rst, add contributors\n* Remove unused methods from utils.py\n\n0.3.1 (2016-01-14)\n__________________\n* Add 'zone' to search fields of Host Record\n\n\n**0.3.0 (2016-01-14)**\n______________________\n* Update development status from Pre-Alpha to Alpha\n* Feature/tox testing (huge changes in testing env)\n* Add 'network' to search fields of FixedAddress\n* Allow domain-name-servers for ipv6\n* Update existent EA for network instead of replace\n\n\n0.2.3 (2016-01-06)\n__________________\n* Return None if search failed instead of exception\n* Add ip_version as a public property for objects\n\n0.2.2 (2015-12-23)\n__________________\n* Fix updating object from create method\n* Rework delete_all_associated_objects logic\n* Fix error handling in create_object\n* Do not catch exception on create_dns_zone level\n* Update feature version for member_ipv6_setting\n\n0.2.1 (2015-12-18)\n__________________\n* Add InfobloxMemberAlreadyAssigned exception\n* Update dns record if already exists\n* Add 'log_api_calls_as_info' option for connector\n* Check for empty values in EA\n\n**0.2.0 (2015-12-17)**\n______________________\n* Deprecate network_exists method in object_manager\n* Add _global_field_processing for objects\n* Add parsing 'extattrs' into EA objects for all InfobloxObject childs\n* Add docs badge to README.rst\n* Reworked get_network in object_manager\n* Move _eq_ to BaseObject\n* Check if fixed address is found before delete\n\n\n0.1.4 (2015-12-08)\n__________________\n* Field updates for Member object\n* Log all api calls in connector on debug level\n\n0.1.3 (2015-12-04)\n__________________\n* Add 'network' field to ip versioned fields\n* Skip adding DHCP options for IPv6 network\n* Do not search IPRange before creating\n\n0.1.2 (2015-12-02)\n__________________\n* Do not fail if object is not found on delete\n* Raise exception with details if reply is not json\n* Add 'silent_ssl_warnings' option to connector\n\n0.1.1 (2015-12-01)\n__________________\n* Fix unbind_name_from_record_a\n\n0.1.0 (2015-12-01)\n__________________\n* Add new field type '_updateable_search_field' to objects and fix HostRecord search\n* Fix 'make docs'\n* Update README.rst (fixed formatting)\n\n0.0.11 (2015-11-25)\n___________________\n* Fix adding second ip to HostRecord\n* Fix failing in pdb\n* Convert EA values into boolean if possible\n* Added 'ips' allias for ip field in HostRecord\n\n0.0.10 (2015-11-19)\n___________________\n* Add utility to determine supported feature\n* Update README.rst with objects interface\n\n0.0.9 (2015-11-13)\n__________________\n* Add allowed_object_types field for EA Definition\n* Allow to return default fields for object\n* Update README.rst with list of supported objects\n\n0.0.8 (2015-11-12)\n___________________\n* Add Extensible Attributes Definition support\n* Fixed options processing for create_network in object_manager\n* Fixed missed DNSZone object in create_dns_zone\n\n0.0.7 (2015-10-27)\n____________________\n* Added 'network' to IPRange search fields\n* Modified `get` method of the EA class to allow return default values\n\n0.0.6 (2015-10-26)\n____________________\n* Added initial support of Extensible Attributes as sub objects\n* Added search by Extensible Attributes\n* Improved validation in connector\n* Added delete_object_by_ref to object manager\n\n0.0.5 (2015-10-12)\n____________________\n* Fixed issues in working with objects\n* Added missed _get_object_type_from_ref\n* Added code coverage\n* Updated links to point to infobloxopen repository\n\n0.0.4 (2015-09-23)\n____________________\n* Added object abstraction for interacting with NIOS objects\n* Added object_manager to simplify some operations on objects\n\n0.0.3 (2015-09-15)\n____________________\n* Added dependencies to package.\n\n\n0.0.2 (2015-09-11)\n____________________\n* Fixed using dashes in package directory names that prevented package import after install.\n\n\n**0.0.1 (2015-09-11)**\n______________________\n* Added connector to send wapi requests to NIOS, does not includes NIOS object model at this point.\n* First release on PyPI.\n\n\n",
"bugtrack_url": null,
"license": "Apache",
"summary": "Client for interacting with Infoblox NIOS over WAPI",
"version": "0.6.1",
"project_urls": {
"Homepage": "https://github.com/infobloxopen/infoblox-client"
},
"split_keywords": [
"infoblox-client"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8122463dab58fe5cff978225a11a5534f825dcc842b599858d64dc1b1cd071ca",
"md5": "79d8c395f6d622e69f648695a5b5a842",
"sha256": "fd98b85ecb44114ab71515d0abac4541a67f12e3a48c278d0f1832cae5c549a8"
},
"downloads": -1,
"filename": "infoblox-client-0.6.1.tar.gz",
"has_sig": false,
"md5_digest": "79d8c395f6d622e69f648695a5b5a842",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 222288,
"upload_time": "2024-11-15T13:28:29",
"upload_time_iso_8601": "2024-11-15T13:28:29.119650Z",
"url": "https://files.pythonhosted.org/packages/81/22/463dab58fe5cff978225a11a5534f825dcc842b599858d64dc1b1cd071ca/infoblox-client-0.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-15 13:28:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "infobloxopen",
"github_project": "infoblox-client",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "infoblox-client"
}
JSON
