Merge branch 'master' into master

Author: jclarke-csco

RC-get-serial-numbers/RC-get-sns.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python
+#
+# Copyright (c) 2019  Joe Clarke <[email protected]>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+# SUCH DAMAGE.
+#
+# This script retrieves inventory from devices with RESTCONF and prints all serial
+# numbers per device.
+#
+
+import requests
+from argparse import ArgumentParser
+
+
+def main():
+
+    parser = ArgumentParser(description='Select options.')
+
+    # Input parameters
+    parser.add_argument('-hosts', '--hosts', type=str, required=True,
+                        help="Comma-separated list of devices")
+    parser.add_argument('-user', '--username', type=str, default='cisco',
+                        help="User credentials for the request")
+    parser.add_argument('-passwd', '--password', type=str, default='cisco',
+                        help="It's the password")
+
+    args = parser.parse_args()
+    url = 'https://{}/restconf/data/Cisco-IOS-XE-device-hardware-oper:device-hardware-data/device-hardware'
+    inv_cache = {}
+
+    hosts = args.hosts.split(',')
+
+    for host in hosts:
+
+        u = url.format(host)
+
+        headers = {
+            'Accept': "application/yang-data+json",
+        }
+
+        response = None
+
+        try:
+            response = requests.request('GET', u, auth=(
+                args.username, args.password), headers=headers, verify=False)
+            response.raise_for_status()
+        except Exception as e:
+            print('Failed to get inventory from device: {}'.format(e))
+            continue
+
+        inv = response.json()
+
+        for asset in inv['Cisco-IOS-XE-device-hardware-oper:device-hardware']['device-inventory']:
+            if host not in inv_cache:
+                inv_cache[host] = []
+
+            if asset['serial-number'] == '':
+                continue
+
+            inv_cache[host].append(
+                {'sn': asset['serial-number'], 'pn': asset['part-number']})
+
+    for host, comps in inv_cache.items():
+        print('Host {} serial numbers:'.format(host))
+        for comp in comps:
+            print('\t{}'.format(comp['sn']))
+
+
+if __name__ == '__main__':
+    main()

RC-get-serial-numbers/README.md

@@ -0,0 +1,10 @@
+# RESTCONF get-serial-numbers
+
+This is an example Python script that retrieves the serial numbers of IOS-XE devices and prints
+each device with its collection of serial numbers.
+
+# requirements
+-- IOS-XE running >/= 16.3.1 also enabled for RESTCONF
+
+# running
+-- Can run on-box or off-box.

acitoolkit_show_tenants/README.md

@@ -12,7 +12,7 @@ To run this script, you'll need to have installed the ACI Toolkit in your workin
 
 This script targets the Always On ACI Simulator DevNet Sandbox. 
 
-Find details on the Sandbox [here](https://developer.cisco.com/site/devnet/sandbox/available-labs/data-center/index.gsp).
+Find details on the Sandbox [here](https://developer.cisco.com/docs/sandbox/#!data-center).
 
 To execute this script against a different device, update the variables that list the URL, User and Password for the APIC.  
 
@@ -26,7 +26,7 @@ To execute this script against a different device, update the variables that lis
 * Clone the Python Examples and change into the directory.  
 
     ```bash 
-    git clone //github.com/CiscoDevNet/python_code_samples_network
+    git clone https://github.com/CiscoDevNet/python_code_samples_network
     cd acitoolkit_show_tenants
     ```
 

acitoolkit_show_tenants/aci-show-tenants.py

@@ -4,7 +4,7 @@
 of the Tenants.  
 
 Leverages the DevNet Sandbox - APIC Simulator Always On 
-    Information at https://developer.cisco.com/site/devnet/sandbox/available-labs/data-center/index.gsp 
+    Information at https://developer.cisco.com/docs/sandbox/#!data-center
     
 Code sample based off the ACI-Toolkit Code sample
 
@@ -41,4 +41,4 @@ def main():
         print(tenant.name)
 
 if __name__ == '__main__':
-    main()
+    main()

apic-em_get_hosts/README.md

@@ -8,7 +8,7 @@ This script has been tested with Python 3.5, however may work with other version
 
 This script targets the Always On APIC-EM DevNet Sandbox. 
 
-Find details on the Sandbox [here](https://developer.cisco.com/site/devnet/sandbox/available-labs/networking/).
+Find details on the Sandbox [here](https://developer.cisco.com/docs/sandbox/#!networking).
 
 To execute this script against a different device, update the variables that list the APIC-EM IP, User and Password.  
 
@@ -23,7 +23,7 @@ Python
 * Clone the Python Examples and change into the directory.  
 
     ```bash 
-    git clone //github.com/CiscoDevNet/python_code_samples_network
+    git clone https://github.com/CiscoDevNet/python_code_samples_network
     cd apic-em_get_hosts
     ```
 

apic-em_get_hosts/gethosts.py

@@ -4,7 +4,7 @@
 of the clients connected.  
 
 Leverages the DevNet Sandbox - APIC-EM Always On 
-    Information at https://developer.cisco.com/site/devnet/sandbox/available-labs/networking/
+    Information at https://developer.cisco.com/docs/sandbox/#!networking
     
 """
 

restconf_update_ipaddress/README.md

@@ -16,7 +16,7 @@ This script has been tested with Python 3.5, however may work with other version
 
 This script targets the RESTCONF DevNet Sandbox that leverages a CSR1000v as a target.  
 
-Find details on the Sandbox [here](https://developer.cisco.com/site/devnet/sandbox/available-labs/networking/).
+Find details on the Sandbox [here](https://developer.cisco.com/docs/sandbox/#!networking).
 
 To execute this script against a different device, update the variables that list the connectivity, management interface, and url_base for RESTCONF.  
 
@@ -31,7 +31,7 @@ Python
 * Clone the Python Examples and change into the directory.  
 
     ```bash 
-    git clone //github.com/CiscoDevNet/python_code_samples_network
+    git clone https://github.com/CiscoDevNet/python_code_samples_network
     cd restconf_update_ipaddress
     ```