Added APIC-EM gethosts example

Author: hpreston

apic-em_get_hosts/README.md

@@ -0,0 +1,53 @@
+# Get Hosts List from APIC-EM 
+
+This example script uses the requests Python library to interact with the APIC-EM and retrieve the list of clients connected. 
+ 
+This script has been tested with Python 3.5, however may work with other versions. 
+ 
+## DevNet Sandbox 
+
+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/).
+
+To execute this script against a different device, update the variables that list the APIC-EM IP, User and Password. 
+ 
+## Requirements
+
+Python 
+
+- requests
+
+# Getting Started 
+
+* Clone the Python Examples and change into the directory. 
+
+ ```bash 
+ git clone //github.com/CiscoDevNet/python_code_samples_network
+ cd apic-em_get_hosts
+ ```
+
+* Create and activate a virtualenv 
+
+ ```bash 
+ virtualenv venv --python=python3.5
+ source venv/bin/activate 
+ ```
+ 
+* Install the requirements 
+
+ ```bash
+ pip install -r requirements.text
+ ```
+
+* Run the script
+
+ ```
+ $ python gethosts.py
+ Client List from APIC-EM
+ IP Address MAC Address Type
+ 10.1.15.117 00:24:d7:43:59:d8 wireless
+ 10.2.1.22 5c:f9:dd:52:07:78 wired
+ 10.1.12.20 e8:9a:8f:7a:22:99 wired 
+ ```
+

apic-em_get_hosts/gethosts.py

@@ -0,0 +1,75 @@
+
+"""
+Simple application that logs on to the APIC-EM and displays all
+of the clients connected. 
+
+Leverages the DevNet Sandbox - APIC-EM Always On 
+ Information at https://developer.cisco.com/site/devnet/sandbox/available-labs/networking/
+ 
+"""
+
+
+# Import necessary modules
+import requests
+
+# Disable warnings
+requests.packages.urllib3.disable_warnings()
+
+# Variables
+apic_em_ip = "https://sandboxapic.cisco.com/api/v1"
+apic_em_user = "devnetuser"
+apic_em_password = "Cisco123!"
+
+def get_token(url):
+
+ # Define API Call
+ api_call = "/ticket"
+
+ # Payload contains authentication information
+ payload = {"username": apic_em_user, "password": apic_em_password}
+
+ # Header information
+ headers = {"content-type": "application/json"}
+
+ # Combine URL, API call and parameters variables
+ url += api_call
+
+ response = requests.post(url, json=payload, headers=headers, verify=False).json()
+
+ # Return authentication token from respond body
+ return response["response"]["serviceTicket"]
+
+def get_hosts(token, url): 
+ # Define API Call
+ api_call = "/host"
+
+ # Header information
+ headers = {"X-AUTH-TOKEN": token}
+
+ # Combine URL, API call and parameters variables
+ url += api_call
+
+ response = requests.get(url, headers=headers, verify=False).json()
+ 
+ # Get hosts list from response and return
+ hosts = response["response"]
+ return hosts
+ 
+
+# Assign obtained authentication token to a variable. Provide APIC-EM's
+# URL address
+auth_token = get_token(apic_em_ip)
+
+# Get list of hosts
+hosts = get_hosts(auth_token, apic_em_ip)
+
+# Display in table
+print("Client List from APIC-EM")
+print("{ip:20} {mac:20} {type:10}".format(ip="IP Address", 
+ mac="MAC Address", 
+ type="Type"))
+
+for host in hosts: 
+ print("{ip:20} {mac:20} {type:10}".format(ip=host["hostIp"], 
+ mac=host["hostMac"], 
+ type=host["hostType"]))

apic-em_get_hosts/requirements.txt

@@ -0,0 +1,5 @@
+appdirs==1.4.0
+packaging==16.8
+pyparsing==2.1.10
+requests==2.13.0
+six==1.10.0