Current File : //lib/python2.7/site-packages/salt/modules/netbox.pyc
�
���^c @@ sO d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z y& d d l Z d d l
m Z e Z
Wn e k
r� e Z
n Xe j e � Z d2 Z i d d 6d d
6Z d � Z d � Z e d
� Z d � Z d � Z d � Z d � Z d e d � Z d � Z d � Z d d � Z d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& d � Z' d d d d d � Z( d � Z) d � Z* d d! � Z+ d d" � Z, d d# � Z- d d d d d d d$ � Z. d% � Z/ d& � Z0 d' � Z1 d( � Z2 d d) � Z3 d d d* � Z4 d+ � Z5 d d, � Z6 d d- � Z7 d. � Z8 d d/ � Z9 d d0 d1 � Z: d S(3 u�
NetBox
======
Module to query NetBox
:codeauthor: Zach Moody <zmoody@do.co>
:maturity: new
:depends: pynetbox
The following config should be in the minion config file. In order to
work with ``secrets`` you should provide a token and path to your
private key file:
.. code-block:: yaml
netbox:
url: <NETBOX_URL>
token: <NETBOX_USERNAME_API_TOKEN (OPTIONAL)>
keyfile: </PATH/TO/NETBOX/KEY (OPTIONAL)>
.. versionadded:: 2018.3.0
i ( t absolute_importt unicode_literalst print_functionN( t CommandExecutionError( t RequestErroru secretsu filteru filter_u getu get_c C@ s t s t d f St Sd S( u%
pynetbox must be installed.
uP The netbox execution module cannot be loaded: pynetbox library is not installed.N( t HAS_PYNETBOXt Falset True( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt __virtual__3 s c C@ s) t d d � } | s% t d � � n | S( Nu
config.getu netboxu8 NetBox execution module configuration could not be found( t __salt__R ( t config( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt _configA s
c C@ sW i } t � j d � | d <| r; t � j d � | d <n t j t � j d � | � S( Nu tokenu keyfileu private_key_fileu url( R t gett pynetboxt api( t
auth_requiredt pynb_kwargs( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt _nb_objJ s
c C@ sY d | j � k r | d =n x6 | j � D]( \ } } t | t � r) t | � q) q) W| S( Nu url( t keyst itemst
isinstancet dictt _strip_url_field( t
input_dictt kt v( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyR R s
c C@ s | r t | � Si Sd S( N( R ( t iterable( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt _dict[ s
c C@ sx t d t � } y# t t | | � | � j | � SWn? t k
rs } t j d j | j j j
| j | j � � t SXd S( u
POST a payload
R u
{}, {}, {}N(
R R t getattrt createR t logt errort formatt reqt requestt headerst request_bodyR ( t appt endpointt payloadt nbt e( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt _addb s #+c C@ s4 t j d d | � j � j � } t j d d | � S( u� '
Slugify given value.
Credit to Djangoproject https://docs.djangoproject.com/en/2.0/_modules/django/utils/text/#slugify
u [^\w\s-]u u [-\s]+u -( t ret subt stript lower( t value( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt slugifyn s !c K@ sn t d | � } | r9 t t | | � | � j | � } n1 t d | � } t t | | � | � j | � } | S( u�
Helper function to do a GET request to Netbox.
Returns the actual pynetbox object, which allows manipulation from other functions.
R u args.clean_kwargs( R R R t __utils__( R% R& t idR t kwargsR( t item( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt _getw s $!c C@ s/ | j d � } t | � d k r% | S| d f S( Nu .i u 0( t splitt len( t if_namet
if_name_split( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt
_if_name_unit� s c K@ s� g } t d | t k r t n t � } t t | | � | � j t d | � � } | r� g | D] } t t | � � ^ q_ } n t | � S( uH
Get a list of items from NetBox.
app
String of netbox app, e.g., ``dcim``, ``circuits``, ``ipam``
endpoint
String of app endpoint, e.g., ``sites``, ``regions``, ``devices``
kwargs
Optional arguments that can be used to filter.
All filter keywords are available in Netbox,
which can be found by surfing to the corresponding API endpoint,
and clicking Filters. e.g., ``role=router``
Returns a list of dictionaries
.. code-block:: bash
salt myminion netbox.filter dcim devices status=1 role=router
R u args.clean_kwargs(
R t AUTH_ENDPOINTSR R R t filterR1 R R t sorted( R% R& R3 t retR( t nb_queryt i( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt filter_� s !(c K@ s4 t t | | d | d | t k r' t n t | �� S( u
Get a single item from NetBox.
app
String of netbox app, e.g., ``dcim``, ``circuits``, ``ipam``
endpoint
String of app endpoint, e.g., ``sites``, ``regions``, ``devices``
Returns a single dictionary
To get an item based on ID.
.. code-block:: bash
salt myminion netbox.get dcim devices id=123
Or using named arguments that correspond with accepted filters on
the NetBox endpoint.
.. code-block:: bash
salt myminion netbox.get dcim devices name=my-router
R2 R ( R R5 R; R R ( R% R& R2 R3 ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt get_� s c C@ sk t d d d | �} | r t Si | d 6t | � d 6} t d d | � } | rc i i | d 6d 6St Sd S( u�
.. versionadded:: 2019.2.0
Create a device manufacturer.
name
The name of the manufacturer, e.g., ``Juniper``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_manufacturer Juniper
u dcimu
manufacturerst nameu nameu slugN( RB R R0 R* ( RC t nb_manR' t man( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_manufacturer� s c C@ s� t d d d | �} | r t St d d d | �} d
} | sO t | � } n i | d 6| d d 6t | � d 6} t d d | � } i i | d 6d 6} | r� | d j | d � n | r� | St Sd
S( um
.. versionadded:: 2019.2.0
Create a device type. If the manufacturer doesn't exist, create a new manufacturer.
model
String of device model, e.g., ``MX480``
manufacturer
String of device manufacturer, e.g., ``Juniper``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_device_type MX480 Juniper
u dcimu device-typest modelu
manufacturersRC u modelu idu manufactureru slugN( RB R t NoneRF R0 R* t update( RG t manufacturert nb_typeRD t new_manR' t typt ret_dict( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_device_type� s %c C@ sr t d d d | �} | r t Si | d 6t | � d 6| d 6} t d d | � } | rj i i | d 6d 6St Sd S( u�
.. versionadded:: 2019.2.0
Create a device role
role
String of device role, e.g., ``router``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_device_role router
u dcimu device-rolesRC u nameu slugu colorN( RB R R0 R* ( t rolet colort nb_roleR' ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_device_role s !c C@ sq t d d d t | � �} | r% t Si | d 6t | � d 6} t d d | � } | ri i i | d 6d 6St Sd S( u�
.. versionadded:: 2019.2.0
Create a new device platform
platform
String of device platform, e.g., ``junos``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_platform junos
u dcimu platformst slugu nameu slugN( RB R0 R R* ( t platformt nb_platformR' t plat( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_platform s c C@ sk t d d d | �} | r t Si | d 6t | � d 6} t d d | � } | rc i i | d 6d 6St Sd S( u�
.. versionadded:: 2019.2.0
Create a new device site
site
String of device site, e.g., ``BRU``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_site BRU
u dcimu sitesRC u nameu slugN( RB R R0 R* ( t sitet nb_siteR' ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_site9 s c C@ s+ yu t d d d | �} | s" t St d d d | �} | sA t St d d d | �} | s` t Si d d 6d d
6} Wn? t k
r� } t j d j | j j j | j | j � � t SXi | d 6| d
6t
| � d 6| d d 6| d d 6| d d 6}
t d d |
� } | r#i i |
d 6d 6St Sd S( uU
.. versionadded:: 2019.2.0
Create a new device with a name, role, model, manufacturer and site.
All these components need to be already in Netbox.
name
The name of the device, e.g., ``edge_router``
role
String of device role, e.g., ``router``
model
String of device model, e.g., ``MX480``
manufacturer
String of device manufacturer, e.g., ``Juniper``
site
String of device site, e.g., ``BRU``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_device edge_router router MX480 Juniper BRU
u dcimu device-rolesRC u device-typesRG u sitesu Activeu labeli u valueu
{}, {}, {}u nameu display_nameu slugu idu device_typeu device_roleu siteu devicesN( RB R R R R R R! R" R# R$ R0 R* ( RC RP RG RJ RY RR RK RZ t statusR) R' t new_dev( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt
create_deviceT s( +)c K@ s� t d | � } t d d d t d | �} x* | j � D] \ } } t | | | � q8 Wy | j � i i | d 6d 6SWn? t k
r� } t j d j | j
j j | j
| j � � t SXd S( ud
.. versionadded:: 2019.2.0
Add attributes to an existing device, identified by name.
name
The name of the device, e.g., ``edge_router``
kwargs
Arguments to change in device, e.g., ``serial=JN2932930``
CLI Example:
.. code-block:: bash
salt myminion netbox.update_device edge_router serial=JN2932920
u args.clean_kwargsu dcimu devicesR RC u
{}, {}, {}N( R1 R5 R R t setattrt saveR R R R R! R" R# R$ R ( RC R3 t nb_deviceR R R) ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt
update_device� s
+u c
C@ s� t d d d | �} | s t S| re t d d d | �} | se t | � t d d d | �} qe n i | d d 6| d 6| d 6| d 6| d
6d d 6} | r� | d | d <n t d d
| � } | r� i i | d
6d 6S| Sd S( u�
.. versionadded:: 2019.2.0
Add an inventory item to an existing device.
device_name
The name of the device, e.g., ``edge_router``.
item_name
String of inventory item name, e.g., ``Transceiver``.
manufacturer_name
String of inventory item manufacturer, e.g., ``Fiberstore``.
serial
String of inventory item serial, e.g., ``FS1238931``.
part_id
String of inventory item part id, e.g., ``740-01234``.
description
String of inventory item description, e.g., ``SFP+-10G-LR``.
CLI Example:
.. code-block:: bash
salt myminion netbox.create_inventory_item edge_router Transceiver part_id=740-01234
u dcimu devicesRC u
manufacturersu idu deviceu nameu descriptionu serialu part_idu parentu manufactureru inventory-itemsN( RB R RF RH R* (
t device_namet item_namet manufacturer_namet serialt part_idt descriptionRa RD R' t done( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_inventory_item� s "
#c C@ s> t d d d t d | �} | j � i i i | d 6d 6d 6S( u
.. versionadded:: 2019.2.0
Remove an item from a devices inventory. Identified by the netbox id
item_id
Integer of item to be deleted
CLI Example:
.. code-block:: bash
salt myminion netbox.delete_inventory_item 1354
u dcimu inventory-itemsR R2 u DELETE( R5 R t delete( t item_idt nb_inventory_item( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt delete_inventory_item� s
c C@ sQ i | d 6| d 6} t d d | � } | rI i i i | | d 6d 6d 6S| Sd S( u,
.. versionadded:: 2019.2.0
Create an interface connection between 2 interfaces
interface_a
Interface id for Side A
interface_b
Interface id for Side B
CLI Example:
.. code-block:: bash
salt myminion netbox.create_interface_connection 123 456
u interface_au interface_bu dcimu interface-connectionsu idN( R* ( t interface_at interface_bR' R> ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_interface_connection� s
c K@ sB | s t d } n t d d d | �} t d d d | d | �S( um
.. versionadded:: 2019.2.0
Returns interfaces for a specific device using arbitrary netbox filters
device_name
The name of the device, e.g., ``edge_router``
kwargs
Optional arguments to be used for filtering
CLI Example:
.. code-block:: bash
salt myminion netbox.get_interfaces edge_router name="et-0/0/5"
u idu dcimu devicesRC u
interfacest device_id( t __opts__RB RA ( Rc R3 t
netbox_device( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt get_interfaces
s
c C@ s i } t d | � } t d | � } x�| D]�} t | d � \ } } | | k r| i i | d 6d 6i i d 6d 6| | <n | d k rT| d | | d d <| d r(| | d k r� t | d � | | d d <q(i i i i i t | d � d 6d 6| 6d 6d 6} t d | | | � | | <n | d
r�t | d
� | | d d
<q�q+ i i t | � d 6| d d 6d 6| | d d | <| d r+ t | d � | | d d | d d <q+ q+ Wx.| D]&} | d j d
� \ } }
| d d } t | � \ } } d j | d � } | | | d d k rgi i t | � d 6t d 6d 6| | d d | <n | | | d d | k r�i i i d 6d 6| | d d | | <n i i | d 6t |
� d 6d 6| | d d | | d d | <q�Wi i | d 6d 6S( uv
.. versionadded:: 2019.2.0
Return a dictionary structured as standardised in the
`openconfig-interfaces <http://ops.openconfig.net/branches/master/openconfig-interfaces.html>`_
YANG model, containing physical and configuration data available in Netbox,
e.g., IP addresses, MTU, enabled / disabled, etc.
device_name: ``None``
The name of the device to query the interface data for. If not provided,
will use the Minion ID.
CLI Example:
.. code-block:: bash
salt '*' netbox.openconfig_interfaces
salt '*' netbox.openconfig_interfaces device_name=cr1.thn.lon
Rc u nameu configu subinterfaceu
subinterfacesu 0u enabledu descriptionu dictupdate.updateu mtuu indexu addressu /u interfaceu ipv{}u familyu addressesu ipu
prefix_lengthu
interfaces( Ru t get_ipaddressesR: t strR1 t intR6 R R ( Rc t oc_ift
interfacest ipaddressest interfaceR8 t if_unitt subif_descrt ipaddresst ipt
prefix_lengtht ipvkey( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt openconfig_interfaces% sf
$
"
"
/
! %8c C@ s� i } t d | � } x� | D]� } | d s2 q n t | d � \ } } | d d } | | k r� i i | d 6d d 6d d 6d 6i i d 6d
6| | <n i | | d
d | <q Wi i i | d 6d 6d
6S( uw
.. versionadded:: 2019.2.0
Return a dictionary structured as standardised in the
`openconfig-lacp <http://ops.openconfig.net/branches/master/openconfig-lacp.html>`_
YANG model, with configuration data for Link Aggregation Control Protocol
(LACP) for aggregate interfaces.
.. note::
The ``interval`` and ``lacp_mode`` keys have the values set as ``SLOW``
and ``ACTIVE`` respectively, as this data is not currently available
in Netbox, therefore defaulting to the values defined in the standard.
See `interval <http://ops.openconfig.net/branches/master/docs/openconfig-lacp.html#lacp-interfaces-interface-config-interval>`_
and `lacp-mode <http://ops.openconfig.net/branches/master/docs/openconfig-lacp.html#lacp-interfaces-interface-config-lacp-mode>`_
for further details.
device_name: ``None``
The name of the device to query the LACP information for. If not provided,
will use the Minion ID.
CLI Example:
.. code-block:: bash
salt '*' netbox.openconfig_lacp
salt '*' netbox.openconfig_lacp device_name=cr1.thn.lon
Rc u lagu nameu SLOWu intervalu ACTIVEu lacp_modeu configu memberu membersu interfaceu
interfacesu lacp( Ru R: ( Rc t oc_lacpRz R| R8 R} t parent_if( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt openconfig_lacp� s(
c C@ sW t d d d | �} | s t S| rQ t d d d | d d | �} | sQ t Sn | s` d } n | so d } n i | d d 6| d
6| d 6| d 6d
d 6}
| d k r� | |
d <n | r� d |
d <n | r� | d |
d <n | r� | |
d <n t d d d | d d | �} | s,t d d |
� } n | rOi i i |
| d 6d 6d 6S| Sd S( u�
.. versionadded:: 2019.2.0
Attach an interface to a device. If not all arguments are provided,
they will default to Netbox defaults.
device_name
The name of the device, e.g., ``edge_router``
interface_name
The name of the interface, e.g., ``TenGigE0/0/0/0``
mac_address
String of mac address, e.g., ``50:87:89:73:92:C8``
description
String of interface description, e.g., ``NTT``
enabled
String of boolean interface status, e.g., ``True``
lag:
Boolean of interface lag status, e.g., ``True``
lag_parent
String of interface lag parent name, e.g., ``ae13``
form_factor
Integer of form factor id, obtained through _choices API endpoint, e.g., ``200``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_interface edge_router ae13 description="Core uplink"
u dcimu devicesRC u
interfacesRr u idu u falseu deviceu nameu descriptionu enabledi� u form_factori� u lagu mac_addressN( RB R RH R* ( Rc t interface_namet mac_addressRh t enabledt lagt
lag_parentt form_factorRa t
lag_interfaceR' t nb_interface( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_interface� s6 %
c K@ s� t d d d | �} t d d d t d | d d | �} | sD t S| sN t Sx4 t d | � j � D] \ } } t | | | � qe Wy0 | j � i i i t | � | j 6d 6d 6SWn? t
k
r� } t j d j
| j j j | j | j � � t SXd
S( u�
.. versionadded:: 2019.2.0
Update an existing interface with new attributes.
device_name
The name of the device, e.g., ``edge_router``
interface_name
The name of the interface, e.g., ``ae13``
kwargs
Arguments to change in interface, e.g., ``mac_address=50:87:69:53:32:D0``
CLI Example:
.. code-block:: bash
salt myminion netbox.update_interface edge_router ae13 mac_address=50:87:69:53:32:D0
u dcimu devicesRC u
interfacesR Rr u idu args.clean_kwargsu
{}, {}, {}N( RB R5 R R R1 R R_ R` R R2 R R R R R! R" R# R$ ( Rc R� R3 Ra R� R R R) ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt update_interface s %#
&+c C@ st t d d d | �} t d d d t d | d d | �} | rp | j � i i i i | j | j 6d 6d 6d 6St S( uF
.. versionadded:: 2019.2.0
Delete an interface from a device.
device_name
The name of the device, e.g., ``edge_router``.
interface_name
The name of the interface, e.g., ``ae13``
CLI Example:
.. code-block:: bash
salt myminion netbox.delete_interface edge_router ae13
u dcimu devicesRC u
interfacesR Rr u idu DELETE( RB R5 R Rk RC R2 R ( Rc R� Ra R� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt delete_interface% s %
&c C@ s t | | d d �S( uG
.. versionadded:: 2019.2.0
Update an interface to be a LAG.
device_name
The name of the device, e.g., ``edge_router``.
interface_name
The name of the interface, e.g., ``ae13``.
CLI Example:
.. code-block:: bash
salt myminion netbox.make_interface_lag edge_router ae13
R� i� ( R� ( Rc R� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt make_interface_lag? s c C@ s_ t d d d | �} t d d d | d d | �} | rW | rW t | | d | d �St Sd S( u�
.. versionadded:: 2019.2.0
Set an interface as part of a LAG.
device_name
The name of the device, e.g., ``edge_router``.
interface_name
The name of the interface to be attached to LAG, e.g., ``xe-1/0/2``.
parent_name
The name of the LAG interface, e.g., ``ae13``.
CLI Example:
.. code-block:: bash
salt myminion netbox.make_interface_child xe-1/0/2 ae13
u dcimu devicesRC u
interfacesRr u idR� N( RB R� R ( Rc R� t parent_nameRa t nb_parent( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt make_interface_childT s
c K@ sB | s t d } n t d d d | �} t d d d | d | �S( uk
.. versionadded:: 2019.2.0
Filters for an IP address using specified filters
device_name
The name of the device to check for the IP address
kwargs
Optional arguments that can be used to filter, e.g., ``family=4``
CLI Example:
.. code-block:: bash
salt myminion netbox.get_ipaddresses device_name family=4
u idu dcimu devicesRC u ipamu ip-addressesRr ( Rs RB RA ( Rc R3 Rt ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyRv q s
c
C@ s� d } i | d 6| d 6} | r� | r� t d d d | �} | sE t St d d d | d d | �} | sn t St d d
d | d | d d
| �} | r� t j | � t S| d | d <n t d d
| � } | r� i i | d
6d 6S| Sd S( u
.. versionadded:: 2019.2.0
Add an IP address, and optionally attach it to an interface.
ip_address
The IP address and CIDR, e.g., ``192.168.1.1/24``
family
Integer of IP family, e.g., ``4``
device
The name of the device to attach IP to, e.g., ``edge_router``
interface
The name of the interface to attach IP to, e.g., ``ae13``
CLI Example:
.. code-block:: bash
salt myminion netbox.create_ipaddress 192.168.1.1/24 4 device=edge_router interface=ae13
u familyu addressu dcimu devicesRC u
interfacesRr u idu ipamu ip-addressest qt interface_idt familyu interfaceN( RH RB R R R R* ( t
ip_addressR� t deviceR| t nb_addrR' Ra R� t ipaddr( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_ipaddress� s$ %
c C@ sH t d d d t d | �} | rD | j � i i i | d 6d 6d 6St S( u.
.. versionadded:: 2019.2.0
Delete an IP address. IP addresses in Netbox are a combination of address
and the interface it is assigned to.
id
The Netbox id for the IP address.
CLI Example:
.. code-block:: bash
salt myminion netbox.delete_ipaddress 9002
u ipamu ip-addressesR R2 u
ip-addressu DELETE( R5 R Rk R ( t ipaddr_idt nb_ipaddr( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt delete_ipaddress� s
c C@ s� t d d d | �} i } | rc | d | k r5 t St j d | | � t d j | | � � � nf i | d 6t | � d 6} | r� | | d <n t d d | � } | r� i i i | | d 6d 6d 6S| Sd
S( u
.. versionadded:: 2019.2.0
Create a new Netbox circuit provider
name
The name of the circuit provider
asn
The ASN of the circuit provider
CLI Example:
.. code-block:: bash
salt myminion netbox.create_circuit_provider Telia 1299
u circuitsu providersRC u asnu- Duplicate provider with different ASN: %s: %su- Duplicate provider with different ASN: {}: {}u nameu slugu idN( RB R R R R R R0 R* ( RC t asnt nb_circuit_providerR' t circuit_provider( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_circuit_provider� s"
c C@ s7 | r t d d d | �} n t d d d | �} | S( u1
.. versionadded:: 2019.2.0
Get a circuit provider with a given name and optional ASN.
name
The name of the circuit provider
asn
The ASN of the circuit provider
CLI Example:
.. code-block:: bash
salt myminion netbox.get_circuit_provider Telia 1299
u circuitsu providersR� RC ( RB ( RC R� R� ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt get_circuit_provider� s c C@ s| t d d d t | � �} | r% t Si | d 6t | � d 6} t d d | � } | rt i i i | | d 6d 6d 6S| Sd S( u�
.. versionadded:: 2019.2.0
Create a new Netbox circuit type.
name
The name of the circuit type
CLI Example:
.. code-block:: bash
salt myminion netbox.create_circuit_type Transit
u circuitsu
circuit-typesRT u nameu slugu idN( RB R0 R R* ( RC t nb_circuit_typeR' t circuit_type( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_circuit_type s c C@ s� t d d | � } t d d d t | � �} | r� | r� i | d 6| d d 6| d d 6} | ro | | d <n t d d d
| �} | r� t St d d | � } | r� i i i | | d 6d 6d 6S| Sn t Sd S( u�
.. versionadded:: 2019.2.0
Create a new Netbox circuit
name
Name of the circuit
provider_id
The netbox id of the circuit provider
circuit_type
The name of the circuit type
asn
The ASN of the circuit provider
description
The description of the circuit
CLI Example:
.. code-block:: bash
salt myminion netbox.create_circuit NEW_CIRCUIT_01 Telia Transit 1299 "New Telia circuit"
u circuitsu providersu
circuit-typesRT u cidu idu provideru typeu descriptiont cidN( RB R0 R R* ( RC t provider_idR� Rh R� R� R' t
nb_circuitt circuit( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_circuit. s"
u Ac C@ s t d d d | �} t d d d | d d | �} t d d d | �} | r | r t d d d
| d �} | rx t Si | d d 6| d d
6| d d d 6| d 6| d 6}
| r� | |
d <n t d d |
� } | r� i i i |
| d 6d 6d 6S| Sn d S( u?
.. versionadded:: 2019.2.0
Terminate a circuit on an interface
circuit
The name of the circuit
interface
The name of the interface to terminate on
device
The name of the device the interface belongs to
speed
The speed of the circuit, in Kbps
xconnect_id
The cross-connect identifier
term_side
The side of the circuit termination
CLI Example:
.. code-block:: bash
salt myminion netbox.create_circuit_termination NEW_CIRCUIT_01 xe-0/0/1 myminion 10000 xconnect_id=XCON01
u dcimu devicesRC u
interfacesRr u idu circuitsR� u circuit-terminationsR� u cidu circuitu interfaceu siteu
port_speedu term_sideu xconnect_idN( RB R R* ( R� R| R� t speedt xconnect_idt term_sideRa R� R� t nb_terminationR' t circuit_termination( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt create_circuit_termination\ s*
( u secrets(; t __doc__t
__future__R R R R+ t loggingt salt.exceptionsR R
t pynetbox.libR R R t ImportErrorR t getLoggert __name__R R; t __func_alias__R R R R R R* R0 RH R5 R: RA RB RF RO RS RX R[ R^ Rb Rj Rn Rq Ru R� R� R� R� R� R� R� Rv R� R� R� R� R� R� R� ( ( ( s7 /usr/lib/python2.7/site-packages/salt/modules/netbox.pyt <module> sx
# 6 0 _ : > $ + * .
Mini Shell