Merge pull request #77 from CiscoDevNet/replace-apic-em

Replace APIC-EM and provide consistency edits on all labs

Author: agentlecisco

labs/coding-101-rest-basics-ga/1.md

@@ -1,4 +1,3 @@
-
 # Coding 101 - REST API Basics
 
 This Learning Lab explains the basics of using a REST API. It also shows how to use Postman to explore a REST API.
@@ -18,7 +17,7 @@ This Learning Lab explains the basics of using a REST API. It also shows how to
       * **username:** devnetuser
       * **password:** Cisco123!
 
-## Step 1. Find the DNA Center API Resources and Documentation
+## Step 1: Find the DNA Center API Reference documentation
 
 A good starting point to understand any API is to look at the documentation for the API. Now, find documentation for the DNA Center API.
 
@@ -27,11 +26,13 @@ A good starting point to understand any API is to look at the documentation for
    * Click the **Technologies** link to see the submenu.
    * Click **Networking**.
    * From the list of technologies, click **DNA Center Platform**.
-![](/posts/files/coding-101-rest-basics-ga/assets/images/Menu.png)
+![](assets/images/Menu.png)
 
 1. On the DNA Center Platform page, click the `Docs` link.
 1. Click `API Reference`.
 1. Select the latest API version.
 1. Keep the DNA Center API Reference documentation open in a separate tab. This page provides a useful reference while you work on this lab.
 
-### Next Step: Learn about the REST web service
+### Next step
+
+Proceed to Step 2: So what is a REST web service?

labs/coding-101-rest-basics-ga/2.md

@@ -1,11 +1,11 @@
 ## Step 2: So what is a REST web service?
 
-### What is a Web Service?
+### What is a web service?
 
 A web service is a way for two systems to communicate through a defined interface.
 There are two major types of web services – **REST** and **SOAP**.
 
-### What is a *REST* Web Service?
+### What is a REST web service?
 
 REST is an architecture style for designing networked applications.
 A REST web service is as easy to call as making an HTTP request.
@@ -14,9 +14,9 @@ To know more about REST in general, this is a great [REST definition](https://en
 
 ### What are the benefits of REST?
 
-***REST is easy to use on any platform***
+***REST is easy to use on any platform.***
 
-![](/posts/files/coding-101-rest-basics-ga/assets/images/RESTisGreat.jpg)
+![](assets/images/RESTisGreat.jpg)
 
 ### DNA Center API is a REST API
 
@@ -30,7 +30,7 @@ Look at the [DNA Center documentation](https://developer.cisco.com/site/dna-cent
 
 ### How does this work?
 
-![](/posts/files/coding-101-rest-basics-ga/assets/images/howitworks.jpg "How it Works")
+![](assets/images/howitworks.jpg)
 
 REST is centered around the HTTP request and response model. Consuming an API is as simple as making an HTTP request.
 
@@ -40,4 +40,6 @@ In this example, you request the list of hosts, and that information is returned
 
 * [XML](https://www.w3schools.com/xml/xml_whatis.asp) - XML, or eXtensible Markup Language, a language designed to store and transport data.
 
-### Next Step: HTTP response and request facts
+### Next step
+
+Proceed to Step 3: What do I need to know to make a request?

labs/coding-101-rest-basics-ga/3.md

@@ -24,7 +24,7 @@ Choose one of the following http methods:
 - **Request Body**
 	* If required, include a JSON- or XML-formatted request body that contains any data that is needed.
 
-### About Authentication
+### About authentication
 
 Authentication controls whether a user user can access a specific API endpoint and how they can access it. For example, one user might have read-only privileges, which they can only make API calls that read data. Another user might have read and change (add, edit, delete) privileges to every endpoint, which means they can make any API call. These access rights are typically-based upon assigned user roles such as *Administrator*, which grants a user full rights to change data, and *User*, which grants read-only access.
 
@@ -34,7 +34,7 @@ REST APIs have three common methods to authenticate users:
 * **OAuth:** Open standard for HTTP authentication and session management. Creates an access token associated with a specific user that also specifies the user rights. The token identifies the user and rights when making API calls to verify access and control. See [OAuth](https://en.wikipedia.org/wiki/OAuth) for more information.
 3. **Token:** As with OAuth, a token is created and passed with each API call, but there is no session management and tracking of clients. This simplifies interaction between the server and client. See [Token Based Authentication](https://scotch.io/tutorials/the-ins-and-outs-of-token-based-authentication) for more information.
 
-APIC-EM uses token-based authentication. So the first request you need to make creates a token. In DNA Center, this string is called a *token*. The controller uses the token to determine which endpoints you can access. The token must be included in every API call.
+DNA Center uses token-based authentication. So the first request you need to make creates a token. In DNA Center, this string is called a *token*. The controller uses the token to determine which endpoints you can access. The token must be included in every API call.
 
 The steps for using the DNA Center authentication token are:
 
@@ -46,11 +46,11 @@ The steps for using the DNA Center authentication token are:
 
 The API Reference Documentation is where you can find the list of the API methods and the details for information on how to make each request. When you are starting to work with a new API, the API Reference is one of the most important sources of information.
 
-Study the Ticket API in APIC-EM:
+Study the Ticket API in DNA Center:
 
 * Open the [DNA Center API reference docs](https://developer.cisco.com/site/dna-center-rest-api/). Pick the proper version of API. The entire API is presented in scrollable format.
 
-    ![](/posts/files/coding-101-rest-basics-ga/assets/images/refguide1.png)
+    ![](assets/images/refguide1.png)
 
 * The API Reference includes attributes to be sent and returned. The Response portion defines the returned data, including HTTP status codes.
 
@@ -63,10 +63,12 @@ Study the Ticket API in APIC-EM:
 
 * Review the content to see what data is expected to be sent to the server and returned to your application. In the example response for the network devices request, you can see that the response string contains a `hostName` attribute with a value of type Array[string].
 
-  ![](/posts/files/coding-101-rest-basics-ga/assets/images/refguide4.png)
+  ![](assets/images/refguide4.png)
 
 ### Things to try
 
 * Look at the other network devices endpoints in the API Reference Guide. How do they differ from one another?
 
-### Next Step: Make HTTP calls using REST
+### Next step
+
+Proceed to Step 4: Construct a REST call.

labs/coding-101-rest-basics-ga/4.md

@@ -1,6 +1,6 @@
-## Step 4. Construct a REST Call
+## Step 4: Construct a REST call
 
-### DNA Center Example: POST Create a Token
+### DNA Center example: Create a token
 
 Now, look at how to use the API to create a token for authentication.
 
@@ -36,4 +36,6 @@ To get the token your request will look like this:
 	 * Provide the username and password for logging into the DNA Center in JSON format.
 
 
-### Next Step: Making a REST API call
+### Next step  
+
+Proceed to Step 5: Make a REST API call.

labs/coding-101-rest-basics-ga/5.md

@@ -1,4 +1,4 @@
-## Step 5. Make a REST API Call
+## Step 5: Make a REST API call
 
 There are HTTP clients you can use to quickly test web services. They provide a way to construct/send requests to REST APIs and view the responses:
 
@@ -30,7 +30,7 @@ On OS X, to use Python 3.4, you may need to accept the SSL certificate before ca
 
 2. Set up your request to retrieve a token. In the Postman fields, enter the following information:
 
-   ![](/posts/files/coding-101-rest-basics-ga/assets/images/postman1.png)
+   ![](assets/images/postman1.png)
 
 	* **Method**
 		* ``A.``  Select **POST**.
@@ -54,4 +54,6 @@ On OS X, to use Python 3.4, you may need to accept the SSL certificate before ca
 
 #### Congratulations! You made a first REST API call to DNA Center!
 
-### Next Step: Hosts API URL
+### Next step
+
+Proceed to Step 6: Use a token to make REST API calls.

labs/coding-101-rest-basics-ga/6.md

@@ -1,10 +1,10 @@
-## Step 6. Use a token to make REST API calls
+## Step 6: Use a token to make REST API calls
 
-### Example: Get Hosts
+### DNA Center GET Example: Get hosts
 
-Now, look at the Get Hosts endpoint. A host is an end device attached to the network, such as a computer connected to a wireless device. Your goal is to find the hosts and display information about them.
+Now, look at the GET HOSTS API. A host is an end device attached to the network, such as a computer connected to a wireless device. Your goal is to find the hosts and display information about them.
 
-To construct a request that retrieves a list of hosts, refer to the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api/). Click on Inventory under Services to find Get /host. These provide the following information:
+To construct a request that retrieves a list of hosts, refer to the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api/). Click on Inventory under Services to find GET /host. These provide the following information:
 
 * Method
 * URL
@@ -18,7 +18,7 @@ As specified earlier, you can see that the base URL for DNA Center is:
 https://{DNA-Center-Server}/api/v1
 ```
 
-The following call retrieves all of hosts on the specified server
+The following call retrieves all of hosts on the specified server:
 
 ```
 GET https://{DNA-Center-Server}/api/v1/host
@@ -42,6 +42,8 @@ To get the entire list of hosts, your request contains these items:
 * **Body**
 	 * Not required for this request.
 
-![](assets/images/apic-emHostRequest.png)
+![](assets/images/HostRequest.png)
 
-### Next Step: Get Network Hosts
+### Next step
+
+Proceed to Step 7: Get the network hosts.

labs/coding-101-rest-basics-ga/7.md

@@ -1,8 +1,8 @@
-## Step 7. Getting the Network Hosts
+## Step 7: Get the network hosts
 
 1. Set up the API call in Postman.
 	* Now, use the token to authorize a request to GET the hosts from the controller.
-	![](/posts/files/coding-101-rest-basics-ga/assets/images/postman4.png)
+	![](assets/images/postman4.png)
 
 2. Enter the following information:
 	* **Method**
@@ -14,21 +14,23 @@
 		* `C.` Enter the 'Content-Type' and value 'application/json'.
 		* `C.` Enter the 'X-Auth-Token' and the token created earlier. The 'X-Auth-Token' is required for all DNA Center API calls.
 	* **Authentication**
-		* Handled in the Headers
+		* Handled in the header.
 	* **Body**
-	 	* not required for this request
+	 	* Not required for this request.
 3. Click **Send**. Postman sends the request to the server.
 
 4. Review the response.
 	* The **Response Code** in the **Status** field should be `200 OK`.
 	* The **JSON** should display a list of hosts.
 
-    ![](/posts/files/coding-101-rest-basics-ga/assets/images/postman5.png "Response")
+    ![](assets/images/postman5.png "Response")
 
-## Things to Try
+## Things to try
 1. In Postman, append '?limit=1&offset=1' to the URL https://sandboxdnac/api/v1/host so reads as 'https://sandboxdnac/api/v1/host?limit=1&offset=1'. Click the **Send** button. How does the return data differ?  Check the API Reference Guide for more information about the Get Host API call.
 <br/><br/>
 
-#### Congratulations! You made your first REST API call using the APIC-EM Service Ticket!
+#### Congratulations! You made your first REST API call using the DNA Center Service Ticket!
 
-### Next Step: Get Network Devices
+### Next step  
+
+Proceed to Step 8: Get the network devices.

labs/coding-101-rest-basics-ga/8.md

@@ -1,12 +1,12 @@
-## Step 8. Getting the Network Devices
+## Step 8: Get the network devices
 
-Now, look at the Get Network Devices endpoint. A Network Device transports data to/from host devices or other network devices. A network device is typically a hub, switch, or router. It can be connected to the network by an Ethernet cable or wireless connection. Your goal is to find the network devices and display information about them.
+Now, look at the GET Network Devices API. A network device transports data to and from host devices or other network devices. A network device is typically a hub, switch, or router. It can be connected to the network by an Ethernet cable or wireless connection. Your goal is to find the network devices and display information about them.
 
-For details about the Get Network Device API, consult the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api//).
+For details about the GET Network Devices API, consult the [DNA Center API Docs](https://developer.cisco.com/site/dna-center-rest-api/).
 
 1. Set up the API Call in Postman. Use the token to authorize a request to GET the network devices from the controller.
 
-	![](/posts/files/coding-101-rest-basics-ga/assets/images/postman6.png)<br/><br/>
+	![](assets/images/postman6.png)<br/><br/>
 
 2. To retrieve the list of network devices, enter the information in the appropriate Postman fields, as shown here:
 	* **Method**
@@ -25,9 +25,9 @@ For details about the Get Network Device API, consult the [DNA Center API Docs](
 
 The output should look similar to the example in this screenshot. For display purposes, some records have been removed.
 
-![](/posts/files/coding-101-rest-basics-ga/assets/images/postman7.png "Response")
+![](assets/images/postman7.png "Response")
 
-### Things to Try
+### Things to try
 * In Postman, append `/1/2` so the call becomes `https://sandboxdnac/api/v1/network-device/1/2` and click **Send**. How does the output differ?
 * Compare the change you made in *Get Network Devices API* call with the change you made in the *Get Hosts* call in the previous exercise (Step 7). How are they different and why?  Hint:  Check the API Reference Guide for each of these API calls.
 * In Postman, change the API call `https://sandboxdnac/api/v1/network-device/1/2` to `https://sandboxdnac/api/v1/user` and click **Send**. How is the returned data different and what does it represent?  Hint:  Check the API Reference Guide

labs/coding-101-rest-basics-ga/coding-101-rest-basics-ga.json

@@ -5,27 +5,28 @@
   "time": 20,
   "byod": true,
   "files": [
-    {"title": "Coding 101 - REST API Basics",
+    {"title": "Step 1: Find the DNA Center API Reference documentation",
     "file": "1.md"},
-    {"title": "Step 2. So what is a REST web service?",
+    {"title": "Step 2: So what is a REST web service",
      "file": "2.md"},
-    {"title": "Step 3. What do I need to know to make a Request?",
+    {"title": "Step 3: What do I need to know to make a request?",
      "file": "3.md"},
-    {"title": "Step 4. Constructing a REST Call",
+    {"title": "Step 4: Construct a REST call",
      "file": "4.md"},
-    {"title": "Step 5. Make a REST API Call",
+    {"title": "Step 5: Make a REST API call",
      "file": "5.md"},
-    {"title": "Step 6. Using the Service Ticket to Make APIC-EM REST API Calls",
+    {"title": "Step 6: Use a token to make REST API calls",
      "file": "6.md"},
-    {"title": "Step 7. Getting the Network Hosts",
+    {"title": "Step 7: Get the network hosts",
      "file": "7.md"},
-    {"title": "Step 8. Getting the Network Devices",
+    {"title": "Step 8: Get the network devices",
      "file": "8.md"}
   ],
   "tags": [
     {"title": "Coding"},
     {"title": "REST"},
     {"title": "Postman"},
+    {"title": "DNA Center"},
     {"title": "JSON"},
     {"title": "Sandbox"}
   ],

labs/coding-102-rest-python-ga/1.md

@@ -1,11 +1,9 @@
-# Coding 102: Calling REST APIs from Python #
+# Coding 102: Calling REST APIs from Python
 
 In this Learning Lab, you learn the basics of how to call a REST API in Python.
 
 
-## Objective ##
-
-Completion Time: 35 minutes
+## Objectives
 
 * Understand how to call a REST API from Python.
 * Explore ways to parse and use the JSON returned from the REST API.
@@ -42,31 +40,31 @@ For more information, click the "How to Set Up Your Computer" link at the top of
 * **If you are working on a DevNet Learning Lab computer at a DevNet event**,
     * Open the Git Command window by clicking the *Git CMD* icon on the Task Bar or click the Start button. Then, in the Run bar, enter: `git cmd`.
 * **If you are working from your computer**, on your computer open a command terminal.
-![](/posts/files/coding-102-rest-python-ga/assets/images/create_directory.png)<br/><br/>
+![](assets/images/create_directory.png)<br/><br/>
 * Clone the coding skills sample code from GitHub. Enter the following command. This will copy Cisco DevNet's coding samples directory down to your computer so you may work with it locally.
 ```
 git clone https://github.com/CiscoDevNet/coding-skills-sample-code
 ```
-![](/posts/files/coding-102-rest-python-ga/assets/images/github-clone.png)<br/><br/>
+![](assets/images/github-clone.png)<br/><br/>
 Inside the directory you created, , you should see a new directory, 'coding-skills-sample-code'.<br/><br/>
-![](/posts/files/coding-102-rest-python-ga/assets/images/github-clone-listing.png)<br/><br/>
+![](assets/images/github-clone-listing.png)<br/><br/>
+
+## Step 1: Find the DNA Center API Reference documentation
 
+A good starting point to understand any API is to look at the documentation for the API. Now, find documentation for the DNA Center API.
 
-## Step 1. Find the DNA Center API Resources
+1. In a browser, navigate to the [DevNet](https://developer.cisco.com/) home page.
+1. Use the menu at the top to navigate to the DNA Center Platform page.
+   * Click the **Technologies** link to see the submenu.
+   * Click **Networking**.
+   * From the list of technologies, click **DNA Center Platform**.
+![](assets/images/Menu.png)
 
-You are going to use the DNA Center API as an example of a REST API in this lab. So before you begin, locate the APIC-EM resources on DevNet.
+1. On the DNA Center Platform page, click the `Docs` link.
+1. Click `API Reference`.
+1. Select the latest API version.
+1. Keep the DNA Center API Reference documentation open in a separate tab. This page provides a useful reference while you work on this lab.
 
-1. In the browser, navigate to <a href="https://developer.cisco.com" target="_blank">DevNet</a>
-    * Click the **Login** link located at the top right of the webpage.
-    ![](/posts/files/coding-102-rest-python-ga/assets/images/login.png)<br/><br/>
-    * On the Log In webpage, enter your log in credentials (CCO ID) and click the **Log In** button
-    ![](/posts/files/coding-102-rest-python-ga/assets/images/register.png)<br/>
-       * If you do not have a Cisco Connection Online ID (CCO ID), click the **Register Now** button and follow the instructions. When done, return to the Log In webpage and enter your credentials.
-<br/><br/>
-2. Use the menu at the top to navigate directly to the APIC-EM developer resources.
-   * Click the **Technologies** link to access the Technology menu. Inside the menu, click **Networking**  followed by **APIC-EM**<br/>
-![](/posts/files/coding-102-rest-python-ga/assets/images/Menu.png)
-    <br/><br/>
+### Next step
 
-3. You are now at the DNA Center Platform. Open the API reference doc in a separate tab while you are working on this lab.<br/>
-![](/posts/files/coding-102-rest-python-ga/assets/images/Ref.png)
+Proceed to Step 2: Make your first REST call from Python.