Current File : //usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyc
�
���^c @@ s d Z d d l m Z d d l Z e j e � Z d d l Z y d d l m
Z
Wn! e k
rt d d l m
Z
n Xd Z
d g Z d Z d � Z d d d � Z d d
� Z d d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d S( s�
PeeringDB Module
================
.. versionadded:: 2019.2.0
Execution module for the basic interaction with the
`PeeringDB <https://www.peeringdb.com/>`_ API.
While for GET operations (the functions prefixed by ``get_``) the credentials
are optional, there are some specific details that are visible only to
authenticated users. Moreover, the credentials are required when adding or
updating information. That means, the module can equally work out of the box
without any further configuration with the limitations imposed by the PeeringDB
API.
For complete API documentation, please refer to https://www.peeringdb.com/apidocs/.
Configuration (in the opts or Pillar):
.. code-block:: yaml
peeringdb:
username: salt
password: 5@1t
i ( t absolute_importN( t clean_kwargst peeringdbt *s https://www.peeringdb.com/apic C@ s t S( N( t __virtualname__( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt __virtual__/ s c C@ sV t d d d i �} | s1 | j d | � } n | sL | j d | � } n | | f S( Ns config.mergeR t defaultt usernamet password( t __salt__t get( R R t
peeringdb_cfg( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt _get_auth3 s c C@ s8 | r" d j d t d | d | � Sd j d t d | � S( Ns {base}/{endp}/{id}t baset endpt ids
{base}/{endp}( t formatt
PEERINGDB_URL( t endpointR ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt
_build_url= s c K@ s� t | j d d � | j d d � � \ } } t | � } t | d | �} i d d 6t d 6d d 6} t j j j | d d d
t d | d | d | �} d | k r� | j
i t d 6| d d 6� | S| d
d | d <| S( NR R R t t commentt resultt outt methodt GETt decodet paramst errort dictt data( R t popt NoneR R t Truet saltt utilst httpt queryt updatet False( R R t kwargsR R t urlt rett res( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt
_get_endpointC s*
c K@ s
t d | � S( s\
Return the details of a network identified using the search filters
specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible networks registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/net/net_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_net id=4224
salt '*' peeringdb.get_net asn=13335
salt '*' peeringdb.get_net city='Salt Lake City'
salt '*' peeringdb.get_net name__startswith=GTT
t net( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_net] s c K@ s
t d | � S( s�
Return the details of the facility identified using the search
filters specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible facilities registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/netfac/netfac_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_fac id=1774
salt '*' peeringdb.get_fac state=UT
t fac( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_facu s c K@ s
t d | � S( s�
Return the details of an IX (Internet Exchange) using the search filters
specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible IXs registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/ix/ix_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_ix id=1
salt '*' peeringdb.get_ix city='Milwaukee'
t ix( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_ix� s c K@ s
t d | � S( s
Return the details of an IX (Internet Exchange) facility using the search
filters specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible IX facilities registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/ixfac/ixfac_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_ixfac id=1
salt '*' peeringdb.get_ixfac city='Milwaukee'
t ixfac( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_ixfac� s c K@ s
t d | � S( sV
Return the details of an IX (Internet Exchange) together with the networks
available in this location (and their details), using the search filters
specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible IX LAN facilities registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/ixlan/ixlan_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_ixlan id=780
salt '*' peeringdb.get_ixlan city='Milwaukee'
t ixlan( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_ixlan� s c K@ s
t d | � S( sW
Return the details of an IX (Internet Exchange) together with the PeeringDB
IDs of the networks available in this location, using the search filters
specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible IX LAN facilities registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/ixpfx/ixpfx_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_ixpfx id=780
salt '*' peeringdb.get_ixpfx city='Milwaukee'
t ixpfx( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_ixpfx� s c K@ s
t d | � S( s!
Return the list of facilities used by a particular network, given the ``id``
or other filters specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible network facilities registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/netfac/netfac_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_netfac id=780
salt '*' peeringdb.get_netfac city='Milwaukee'
t netfac( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt
get_netfac� s c K@ s
t d | � S( s�
Return the IP addresses used by a particular network at all the IXs where it
is available. The network is selected either via the ``id`` argument or the
other filters specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible IP addresses, of all networks, at all IXs, registered in
PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/netixlan/netixlan_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_netixlan asn=13335
salt '*' peeringdb.get_netixlan ipaddr4=185.1.114.25
t netixlan( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_netixlan� s c K@ s
t d | � S( s&
Return the details of an organisation together with the networks
available in this location, using the search filters specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible organisations registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/org/org_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_org id=2
salt '*' peeringdb.get_org city=Duesseldorf
t org( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_org s c K@ s
t d | � S( s
Return the details of a person of contact together using the search filters
specified in the query.
.. note::
If no ``id`` or filter arguments are specified, it will return all the
possible contacts registered in PeeringDB.
The available filters are documented at:
https://www.peeringdb.com/apidocs/#!/poc/poc_list
CLI Example:
.. code-block:: bash
salt '*' peeringdb.get_poc id=6721
salt '*' peeringdb.get_poc email__contains='@cloudflare.com'
t poc( R, ( R( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt get_poc) s ( t __doc__t
__future__R t loggingt getLoggert __name__t logt salt.utils.httpR" t
salt.utilsR t ImportErrort salt.utils.argsR t __proxyenabled__R R R R R R, R. R0 R2 R4 R6 R8 R: R< R> R@ ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/peeringdb.pyt <module> s4
Mini Shell