File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/infoblox.cpython-310.pyc
Back
o ;jF � @ s| d Z ddlZdZzddlZW n ey$ Z z ee�ZW Y dZ[ndZ[ww dZdd� Zi Z dd� Z dd � Z d d � Z d d � Z dd� Zdd� Zdd� Zdd� Z dDdd�Zdd� ZdEdd �Zd d � ZdFd d �ZdGd!d"�ZdEd#d$�ZdHd%d&�ZdHd'd(�ZdId)d*�ZdJd+d,�Z dGd-d.�Z dGd/d0�Z dEd1d2�Z dEd3d4�Z d5d6� Z!dEd7d8�Z"dFd9d:�Z#d;d<� Z$d=d>� Z%dKd@dA�Z&dJdBdC�Z'dS )La� 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 � N�infobloxc C s t d u t fS �N)� IMPORT_ERR� r r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/infoblox.py� __virtual__- s r c K sd ddddd�}dt � v rt� d�}|�td |i �� t|�� �t| �� �@ D ]}| | ||< q'|S )zU Return configuration user passed api_opts override salt config.get vars Tz https://INFOBLOX/wapi/v1.2.1� �� api_sslverify�api_url�api_user�api_key�__salt__z.configz config.get)�globals�__virtualname__�updater �set�keys)�api_opts�configZ config_key�kr r r � _get_config4 s � r c K s� t d i | ��}d�|d |d |d �}|tv r4tt�� �t| d }t| d r4|dk r4t| d S i }tt�� �|d< tj|d |d |d |d d �|d< |t|< |d S ) Nzinfoblox_session_{},{},{}r r r �time�obj�< r r r )r �format�cache�intr � libinfobloxZSession)r r Z cache_key� timedelta�cr r r � _get_infobloxH s$ � �r! c C � t �| |�S )z� 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 Zdiff_obj)ZobjaZobjbr r r � diff_objects^ s r# c C r" )z� 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 �is_ipaddr_in_ipfunc_range)ZipaddrZipfuncr r r r$ i s r$ c K s* t dd| i|��}td|d |d�|��S )z� 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={} �name�_ref��objref�dataNr )�get_host� update_object�r% r) r �or r r � update_hostw s r. c K �: dt � v rtd rdd| � �iS tdi |��}|�| |�S )z� 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={} �__opts__�test�Testz Would attempt to update object: Nr )r r0 r! r+ )r( r) r r r r r r+ � � r+ c K s8 dt � v rtd rdd| � �iS tdi |��}|�| �S )z� Delete infoblox object. This is a low level api call. CLI Example: .. code-block:: bash salt-call infoblox.delete_object objref=[ref_of_object] r0 r1 r2 z Would attempt to delete object: Nr )r r0 r! � delete_object)r( r r r r r r4 � s r4 c K r/ )z� 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={} r0 r1 r2 z Would attempt to create object: Nr )r r0 r! � create_object)Z object_typer) r r r r r r5 � r3 r5 Fc K s( |si }t di |��}|�| ||||�S )z� 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] Nr )r! � get_object)r( r) � return_fieldsZ max_resultsZensure_none_or_one_resultr r r r r r6 � s �r6 c K s t di |��}|j| d�}|S )aZ 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) Nr )r! � create_cname)r) r r �hostr r r r8 � s r8 c K s" t di |��}|j| ||d�}|S )z� 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% � canonicalr7 Nr )r! � get_cname)r% r: r7 r r r- r r r r; � s r; c K s6 t dd| i|��}|std��td|d |d�|��S )a� 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% zCNAME record not foundr& r' Nr )r; � Exceptionr+ r, r r r � update_cname� s r= c K s0 t d| |d�|��}|rt|d fi |��S dS )a" 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: r& TNr )r; r4 )r% r: r Zcnamer r r � delete_cname s r> c K s$ t di |��}|j| |||d�}|S )z� 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% �mac�ipv4addrr7 Nr )r! r* )r% r@ r? r7 r r r9 r r r r* s �r* c K s" t di |��}|j| ||d�}|S )z� Get all host information CLI Example: .. code-block:: bash salt-call infoblox.get_host_advanced hostname.domain.ca )r% r? r@ Nr )r! �get_host_advanced)r% r@ r? r r r9 r r r rA 1 s rA c K s� | � � �d�} |s2tdd| i|��}|r d|v r |d � � S | �d�dkr0| | �d�d d� S | S d}|D ]}|� � �d�}| �|�rNt|�t|�krN|}q6|rS|S dS )a� 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 �.r% �zone� Nr r )�lower�rstripr* �count�find�endswith�len)r% �domainsr r) �match�dr r r �get_host_domainname@ s � rN c K sT | � � �d�} |s| �d�d S t| |fi |��}|r(|| v r(| �d| �d S | S )a� 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 rB r )rE rF �splitrN �rsplit)r% rK r �domainr r r �get_host_hostnameg s rR c K s^ t dd| i|��}|r-d|v r-g }|d D ] }d|v r"|�|d � q|r'|S |r-|d S dS )z� 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% � ipv4addrsr? r Nr �r* �append)r% � allow_arrayr r) �l�ar r r � get_host_mac� s �rY c K s` t d| |d�|��}|r.d|v r.g }|d D ] }d|v r#|�|d � q|r(|S |r.|d S dS )a 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? rS r@ r Nr rT )r% r? rV r r) rW rX r r r � get_host_ipv4� s �rZ c K � t di |��}|�| |||�S )aY 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' Nr )r! Zget_host_ipv4addr_object)r@ r? �discovered_datar7 r r r r r �get_host_ipv4addr_info� s �r] c K r[ )z� 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 Nr )r! Zget_host_ipv6addr_object)Zipv6addrr? r\ r7 r r r r r �get_host_ipv6addr_info� s �r^ c K s t di |��}|j| ||d�S )aN 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 )r@ �networkr7 Nr )r! � get_network)r@ r_ r7 r r r r r r` � s �r` c K s6 dt � v r td r ddiS tdi |��}|�| ||�S )a 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 r0 r1 r2 z Would attempt to delete hostNr )r r0 r! � delete_host)r% r? r@ r r r r r ra � s ra c K � t d| fi |��S )a 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': [], } z record:host�r5 �r) r r r r � create_host s re c K s t di |��}|�| ||�S )z� Get ip range CLI Example: .. code-block:: bash salt-call infoblox.get_ipv4_range start_addr=123.123.122.12 Nr )r! Z get_range)� start_addr�end_addrr7 r r r r r �get_ipv4_range+ s rh c K s. t | |fi |��}|rt|d fi |��S dS )z� Delete ip range. CLI Example: .. code-block:: bash salt-call infoblox.delete_ipv4_range start_addr=123.123.122.12 r& T)rh r4 )rf rg r �rr r r �delete_ipv4_range9 s rj c K rb )a4 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'} �rangerc rd r r r �create_ipv4_rangeJ s rl c K rb )an 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 �record:arc rd r r r �create_a\ s rn Tc K sN i }| r| |d< |r||d< t dd|i|��}|r%t|�dkr%|s%td��|S ) z� 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 r% r@ rm r) rD z8More than one result, use allow_array to return the dataN)rm )r6 rJ r< )r% r@ rV r r) ri r r r �get_ap s ro c K sb t | |fddi|��}|sdS t|�dkr|std��g }|D ]}|�t|d fi |��� q |S )a� 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 rV FTrD z1More than one result, use allow_array to overrider& )ro rJ r< rU r4 )r% r@ rV r ri �retZrir r r �delete_a� s rq )NNNF)NNN)NN)NNNNr )NF)NNF)NNT)(�__doc__r r r r< �exc�strr r r r r! r# r$ r. r+ r4 r5 r6 r8 r; r= r> r* rA rN rR rY rZ r] r^ r` ra re rh rj rl rn ro rq r r r r �<module> s` " �� � ' " � � !
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings