Current File : //usr/lib/python2.7/site-packages/salt/modules/infoblox.pyc
�
���^c @@ s0 d Z d d l m Z m Z m Z d d l Z d d l m Z d Z y d d l
Z
Wn" e k
rx Z e j
e � Z n Xd Z d � Z i Z d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d d d e d � Z d � Z d d d d � Z d � Z d d d � Z d d d d d � Z d d d d � Z d d � Z! d d � Z" d e d � Z# d d e d � Z$ d d d d d � Z% d d d d d � Z& d d d d � Z' d d d d � Z( d � Z) d d d d � Z* d d d � Z+ d! � Z, d" � Z- d d e. d# � Z/ d d e d$ � Z0 d S(% u�
This module have been tested on infoblox API v1.2.1,
other versions of the API are likly workable.
:depends: libinfoblox, https://github.com/steverweber/libinfoblox
libinfoblox can be installed using `pip install libinfoblox`
API documents can be found on your infoblox server at:
https://INFOBLOX/wapidoc
:configuration: The following configuration defaults can be
defined (pillar or config files '/etc/salt/master.d/infoblox.conf'):
.. code-block:: python
infoblox.config:
api_sslverify: True
api_url: 'https://INFOBLOX/wapi/v1.2.1'
api_user: 'username'
api_key: 'password'
Many of the functions accept `api_opts` to override the API config.
.. code-block:: bash
salt-call infoblox.get_host name=my.host.com api_url: 'https://INFOBLOX/wapi/v1.2.1' api_user=admin api_key=passs
i ( t absolute_importt print_functiont unicode_literalsN( t sixu infobloxc C@ s t d k t f S( N( t
IMPORT_ERRt None( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt __virtual__3 s c K@ s� i t d 6d d 6d d 6d d 6} d t � k r] d j t � } | j t d | i � � n x8 t | j � � t | j � � @D] } | | | | <q� W| S(
uU
Return configuration
user passed api_opts override salt config.get vars
u
api_sslverifyu https://INFOBLOX/wapi/v1.2.1u api_urlu u api_useru api_keyu __salt__u
{0}.configu
config.get( t Truet globalst formatt __virtualname__t updatet __salt__t sett keys( t api_optst configt
config_keyt k( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt _get_config: s
)c K@ s� t | � } d j | d | d | d � } | t k r� t t j � � t | d } t | d r� | d k r� t | d Sn i } t t j � � | d <t j d | d d
| d d | d d | d � | d <| t | <| d S(
Nu infoblox_session_{0},{1},{2}u api_urlu api_useru api_keyu timeu obji< t
api_sslverifyu
api_sslverifyt api_urlt api_usert api_key( R R t cachet intt timet libinfobloxt Session( R R t cache_keyt timedeltat c( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt
_get_infobloxN s
c C@ s t j | | � S( u�
Diff two complex infoblox objects.
This is used from salt states to detect changes in objects.
Using ``func:nextavailableip`` will not cause a diff if the ipaddress is in
range
( R t diff_obj( t objat objb( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt diff_objects_ s c C@ s t j | | � S( u�
Return true if the ipaddress is in the range of the nextavailableip function
CLI Example:
.. code-block:: bash
salt-call infoblox.is_ipaddr_in_ipfunc_range ipaddr="10.0.2.2" ipfunc="func:nextavailableip:10.0.0.0/8"
( R t is_ipaddr_in_ipfunc_range( t ipaddrt ipfunc( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR% j s c K@ s, t d | | � } t d | d d | | � S( u�
Update host record. This is a helper call to update_object.
Find a hosts ``_ref`` then call update_object with the record data.
CLI Example:
.. code-block:: bash
salt-call infoblox.update_host name=fqdn data={}
t namet objrefu _reft data( t get_hostt
update_object( R( R* R t o( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt update_hostx s c K@ sI d t � k r- t d r- i d j | � d 6St | � } | j | | � S( u�
Update raw infoblox object. This is a low level api call.
CLI Example:
.. code-block:: bash
salt-call infoblox.update_object objref=[ref_of_object] data={}
u __opts__u testu# Would attempt to update object: {0}u Test( R t __opts__R R R, ( R) R* R t infoblox( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR, � s
c K@ sF d t � k r- t d r- i d j | � d 6St | � } | j | � S( u�
Delete infoblox object. This is a low level api call.
CLI Example:
.. code-block:: bash
salt-call infoblox.delete_object objref=[ref_of_object]
u __opts__u testu# Would attempt to delete object: {0}u Test( R R/ R R t
delete_object( R) R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR1 � s
c K@ sI d t � k r- t d r- i d j | � d 6St | � } | j | | � S( u�
Create raw infoblox object. This is a low level api call.
CLI Example:
.. code-block:: bash
salt-call infoblox.update_object object_type=record:host data={}
u __opts__u testu# Would attempt to create object: {0}u Test( R R/ R R t
create_object( t object_typeR* R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR2 � s
c K@ s4 | s i } n t | � } | j | | | | | � S( u�
Get raw infoblox object. This is a low level api call.
CLI Example:
.. code-block:: bash
salt-call infoblox.get_object objref=[_ref of object]
( R t
get_object( R) R* t
return_fieldst max_resultst ensure_none_or_one_resultR R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR4 � s
c K@ s" t | � } | j d | � } | S( uZ
Create a cname record.
CLI Example:
.. code-block:: bash
salt-call infoblox.create_cname data={ "comment": "cname to example server", "name": "example.example.com", "zone": "example.com", "view": "Internal", "canonical": "example-ha-0.example.com" }
R* ( R t create_cname( R* R R0 t host( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR8 � s c K@ s. t | � } | j d | d | d | � } | S( u�
Get CNAME information.
CLI Examples:
.. code-block:: bash
salt-call infoblox.get_cname name=example.example.com
salt-call infoblox.get_cname canonical=example-ha-0.example.com
R( t canonicalR5 ( R t get_cname( R( R: R5 R R0 R- ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR; � s c K@ sA t d | | � } | s' t d � � n t d | d d | | � S( u�
Update CNAME. This is a helper call to update_object.
Find a CNAME ``_ref`` then call update_object with the record data.
CLI Example:
.. code-block:: bash
salt-call infoblox.update_cname name=example.example.com data="{
'canonical':'example-ha-0.example.com',
'use_ttl':true,
'ttl':200,
'comment':'Salt managed CNAME'}"
R( u CNAME record not foundR) u _refR* ( R; t ExceptionR, ( R( R* R R- ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt update_cname� s c K@ s3 t d | d | | � } | r/ t | d | � St S( u"
Delete CNAME. This is a helper call to delete_object.
If record is not found, return True
CLI Examples:
.. code-block:: bash
salt-call infoblox.delete_cname name=example.example.com
salt-call infoblox.delete_cname canonical=example-ha-0.example.com
R( R: u _ref( R; R1 R ( R( R: R t cname( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt delete_cname s
c K@ s4 t | � } | j d | d | d | d | � } | S( u�
Get host information
CLI Examples:
.. code-block:: bash
salt-call infoblox.get_host hostname.domain.ca
salt-call infoblox.get_host ipv4addr=123.123.122.12
salt-call infoblox.get_host mac=00:50:56:84:6e:ae
R( t mact ipv4addrR5 ( R R+ ( R( RA R@ R5 R R0 R9 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR+ s $c K@ s. t | � } | j d | d | d | � } | S( u�
Get all host information
CLI Example:
.. code-block:: bash
salt-call infoblox.get_host_advanced hostname.domain.ca
R( R@ RA ( R t get_host_advanced( R( RA R@ R R0 R9 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyRB ) s
c K@ s� | j � j d � } | s~ t d | | � } | rM d | k rM | d j � S| j d � d k rw | | j d � d S| Sn d } xS | D]K } | j � j d � } | j | � r� t | � t | � k r� | } q� q� Wt | � d k r� | Sd S( u�
Get host domain name
If no domains are passed, the hostname is checked for a zone in infoblox,
if no zone split on first dot.
If domains are provided, the best match out of the list is returned.
If none are found the return is None
dots at end of names are ignored.
CLI Example:
.. code-block:: bash
salt-call uwl.get_host_domainname name=localhost.t.domain.com domains=['domain.com', 't.domain.com.']
# returns: t.domain.com
u .R( u zonei u i N( t lowert rstripR+ t countt findt endswitht lenR ( R( t domainsR R* t matcht d( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_host_domainname8 s
'
c K@ si | j � j d � } | s, | j d � d St | | | � } | re | | k re | j d | � d S| S( u�
Get hostname
If no domains are passed, the hostname is checked for a zone in infoblox,
if no zone split on first dot.
If domains are provided, the best match out of the list is truncated from
the fqdn leaving the hostname.
If no matching domains are found the fqdn is returned.
dots at end of names are ignored.
CLI Examples:
.. code-block:: bash
salt-call infoblox.get_host_hostname fqdn=localhost.xxx.t.domain.com domains="['domain.com', 't.domain.com']"
#returns: localhost.xxx
salt-call infoblox.get_host_hostname fqdn=localhost.xxx.t.domain.com
#returns: localhost
u .i ( RC RD t splitRL t rsplit( R( RI R t domain( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_host_hostnamea s c K@ s~ t d | | � } | rz d | k rz g } x2 | d D]& } d | k r5 | j | d � q5 q5 W| ri | S| rz | d Sn d S( u�
Get mac address from host record.
Use `allow_array` to return possible multiple values.
CLI Example:
.. code-block:: bash
salt-call infoblox.get_host_mac host=localhost.domain.com
R( u ipv4addrsu maci N( R+ t appendR ( R( t allow_arrayR R* t lt a( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_host_mac� s c K@ s� t d | d | | � } | r� d | k r� g } x2 | d D]& } d | k r; | j | d � q; q; W| ro | S| r� | d Sn d S( u
Get ipv4 address from host record.
Use `allow_array` to return possible multiple values.
CLI Examples:
.. code-block:: bash
salt-call infoblox.get_host_ipv4 host=localhost.domain.com
salt-call infoblox.get_host_ipv4 mac=00:50:56:84:6e:ae
R( R@ u ipv4addrsu ipv4addri N( R+ RQ R ( R( R@ RR R R* RS RT ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt
get_host_ipv4� s
c K@ s" t | � } | j | | | | � S( uY
Get host ipv4addr information
CLI Examples:
.. code-block:: bash
salt-call infoblox.get_ipv4addr ipv4addr=123.123.122.12
salt-call infoblox.get_ipv4addr mac=00:50:56:84:6e:ae
salt-call infoblox.get_ipv4addr mac=00:50:56:84:6e:ae return_fields=host return_fields='mac,host,configure_for_dhcp,ipv4addr'
( R t get_host_ipv4addr_object( RA R@ t discovered_dataR5 R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_host_ipv4addr_info� s c K@ s" t | � } | j | | | | � S( u�
Get host ipv6addr information
CLI Example:
.. code-block:: bash
salt-call infoblox.get_host_ipv6addr_info ipv6addr=2001:db8:85a3:8d3:1349:8a2e:370:7348
( R t get_host_ipv6addr_object( t ipv6addrR@ RX R5 R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_host_ipv6addr_info� s c K@ s( t | � } | j d | d | d | � S( uN
Get list of all networks. This is helpful when looking up subnets to use
with func:nextavailableip
This call is offen slow and not cached!
some return_fields
comment,network,network_view,ddns_domainname,disable,enable_ddns
CLI Example:
.. code-block:: bash
salt-call infoblox.get_network
RA t networkR5 ( R t get_network( RA R] R5 R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR^ � s c K@ sC d t � k r$ t d r$ i d d 6St | � } | j | | | � S( u
Delete host
CLI Example:
.. code-block:: bash
salt-call infoblox.delete_host name=example.domain.com
salt-call infoblox.delete_host ipv4addr=123.123.122.12
salt-call infoblox.delete_host ipv4addr=123.123.122.12 mac=00:50:56:84:6e:ae
u __opts__u testu Would attempt to delete hostu Test( R R/ R t delete_host( R( R@ RA R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyR_ � s c K@ s t d | | � S( u
Add host record
Avoid race conditions, use func:nextavailableip for ipv[4,6]addrs:
- func:nextavailableip:network/ZG54dfgsrDFEFfsfsLzA:10.0.0.0/8/default
- func:nextavailableip:10.0.0.0/8
- func:nextavailableip:10.0.0.0/8,external
- func:nextavailableip:10.0.0.3-10.0.0.10
See your infoblox API for full `data` format.
CLI Example:
.. code-block:: bash
salt-call infoblox.create_host data =
{'name': 'hostname.example.ca',
'aliases': ['hostname.math.example.ca'],
'extattrs': [{'Business Contact': {'value': 'example@example.ca'}},
{'Pol8 Classification': {'value': 'Restricted'}},
{'Primary OU': {'value': 'CS'}},
{'Technical Contact': {'value': 'example@example.ca'}}],
'ipv4addrs': [{'configure_for_dhcp': True,
'ipv4addr': 'func:nextavailableip:129.97.139.0/24',
'mac': '00:50:56:84:6e:ae'}],
'ipv6addrs': [], }
u record:host( R2 ( R* R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt create_host� s c K@ s t | � } | j | | | � S( u�
Get ip range
CLI Example:
.. code-block:: bash
salt-call infoblox.get_ipv4_range start_addr=123.123.122.12
( R t get_range( t
start_addrt end_addrR5 R R0 ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_ipv4_range s
c K@ s1 t | | | � } | r) t | d | � St Sd S( u�
Delete ip range.
CLI Example:
.. code-block:: bash
salt-call infoblox.delete_ipv4_range start_addr=123.123.122.12
u _refN( Rd R1 R ( Rb Rc R t r( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt delete_ipv4_range- s
c K@ s t d | | � S( u4
Create a ipv4 range
This is a helper function to `create_object`
See your infoblox API for full `data` format.
CLI Example:
.. code-block:: bash
salt-call infoblox.create_ipv4_range data={
start_addr: '129.97.150.160',
end_addr: '129.97.150.170'}
u range( R2 ( R* R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt create_ipv4_range> s c K@ s t d | | � S( un
Create A record.
This is a helper function to `create_object`.
See your infoblox API for full `data` format.
CLI Example:
.. code-block:: bash
salt-call infoblox.create_a data =
name: 'fastlinux.math.example.ca'
ipv4addr: '127.0.0.1'
view: External
u record:a( R2 ( R* R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt create_aP s c K@ ss i } | r | | d <n | r, | | d <n t d d | | �} | ro t | � d k ro | ro t d � � n | S( u�
Get A record
CLI Examples:
.. code-block:: bash
salt-call infoblox.get_a name=abc.example.com
salt-call infoblox.get_a ipv4addr=192.168.3.5
u nameu ipv4addru record:aR* i u8 More than one result, use allow_array to return the data( R4 RH R< ( R( RA RR R R* Re ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt get_ad s
c K@ s� t | | d t | �} | s" t St | � d k r8 t St | � d k r` | r` t d � � n g } x( | D] } | j t | d | � � qm W| S( u�
Delete A record
If the A record is used as a round robin you can set ``allow_array=True`` to
delete all records for the hostname.
CLI Examples:
.. code-block:: bash
salt-call infoblox.delete_a name=abc.example.com
salt-call infoblox.delete_a ipv4addr=192.168.3.5
salt-call infoblox.delete_a name=acname.example.com allow_array=True
RR i i u1 More than one result, use allow_array to overrideu _ref( Ri t FalseR RH R< RQ R1 ( R( RA RR R Re t rett ri( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt delete_az s
(1 t __doc__t
__future__R R R R t salt.extR R R R R< t exct text_typeR
R R R R R$ R% R. R, R1 R2 Rj R4 R8 R; R= R? R+ RB RL RP RU RV RY R\ R^ R_ R` Rd Rf Rg Rh R Ri Rm ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/infoblox.pyt <module>" s\ ) " !
Mini Shell