? ? ? ?思科ACI提供了很多可編程的方式，本文章來分享一下如何使用Postman通過REST API對思科ACI進(jìn)行自動化編程聊替。由于內(nèi)容很多谊娇，所以分成多個(gè)文章來分享症革。
? ? ? ?下面首先來介紹一下如何搭建Postman對思科ACI APIC策略控制器進(jìn)行登錄和獲取token。
I. 介紹
? ? ? ? ? 本文章簡單介紹一下如何使用Postman對思科ACI APIC進(jìn)行自動化操作仔掸。本文里脆贵，我們講討論思科ACI APIC里的Distinguished name 和Class，以及我們要使用的REST API工具Postman, 以及如何使用Postman登錄思科ACI APIC起暮。后續(xù)我們會陸續(xù)介紹如何操作APIC下面的可管理對象卖氨。
II. Postman
1. Postman是什么？
Postman 是一個(gè)第三方REST API工具负懦。它可以用來進(jìn)行創(chuàng)建和獲取思科ACI APIC里的對象筒捺。
2. Postman下載
III. ACI APIC下的2個(gè)重要概念：Distinguish Name 和?Managed Object
在ACI里的所有的組件都可以在ACI的管理信息樹(Management information Tree)中有循可依，每一個(gè)節(jié)點(diǎn)就是一個(gè)可管理的對象（Managed object)纸厉”好可管理對象（MO)通過他們唯一的獨(dú)特的名字（distinguished name)來標(biāo)識。這個(gè)獨(dú)特的名字（DN）里包含一個(gè)從對象樹的根開始残腌，一直到這個(gè)對象本身的完整路徑村斟，其中每一個(gè)部分都稱為相對名稱（Relative Name). 比如：
dn = {rn}/{rn}/{rn}/{rn}…
思科ACI APIC REST API是一個(gè)針對APIC控制器的可編程接口。有可以用任何編程語言通過JSON或XML格式的數(shù)據(jù)對APIC 管理信息樹里的可管理對象進(jìn)行REST呼叫抛猫。
IV.完成Postman初始化準(zhǔn)備工作
1. 在Postman下定義變量
點(diǎn)擊Settings > Manage Environments
點(diǎn)擊add, 完成環(huán)境變量的配置蟆盹，配置環(huán)境變量是為了節(jié)省每次都需要手工輸入的繁瑣工作。后面做REST API呼叫時(shí)可以直接調(diào)用這個(gè)環(huán)境變量闺金。
請注意：上圖中的環(huán)境變量來自思科DevNet sandbox always-on lab環(huán)境逾滥，你也可以用來進(jìn)行思科ACI APIC的可編程學(xué)習(xí)。有興趣點(diǎn)擊思科DevNet官網(wǎng)了解詳情：https://developer.cisco.com/
2. 在Postman下創(chuàng)建一個(gè)Collections.
Collection是Postman下用于整理REST API的一個(gè)目錄文件，可以講相關(guān)的REST API操作放到同一個(gè)Collection下寨昙，方便管理和使用讥巡。
輸入名字和描述后，點(diǎn)擊Create完成Colllection的創(chuàng)建舔哪。
V. 使用Postman創(chuàng)建登錄ACI APIC的REST API請求
點(diǎn)擊新建Request
在會話框里輸入APIC登錄link:
選擇POST欢顷，然后輸入：? ? https://{{apic}}/api/aaaLogin.json
在Body中選擇Raw,貼入下面內(nèi)容：
{ "aaaUser" : { "attributes":{"name":"{{username}}","pwd":"{{password}}"} } }
最后點(diǎn)擊send 按鈕。
如下圖：
在圖中你可以看到{{apic}} {{username}} {{password}} 這三個(gè)參數(shù)就是對你前面創(chuàng)建的環(huán)境變量的調(diào)用捉蚤。
Once Send, you can see the response at the bottom of the Postmanthat shows you the token generated.
點(diǎn)擊完send按鈕后抬驴，你將可以在Postman的下方看到REST API呼叫的回應(yīng)。里面可以看到生成的APIC 登錄的Token. 請注意這個(gè)token有效期為10分鐘缆巧，如上圖：RefreshTimeoutSeconds:"600".意思是如果你接下來對APIC的操作在生成登錄token的10分鐘內(nèi)是不需要再登錄了布持。如果超過了10分鐘了，就需要再次完成登錄請求來獲取有效的token. 老版本的APIC token有效期默認(rèn)為5分鐘陕悬。
點(diǎn)擊保存Save按鈕题暖，將本次登錄請求保存剛創(chuàng)建的Collection里。
本次文章先介紹到這里捉超。接下來我們繼續(xù)探索使用Postman來完成對ACI APIC的REST API操作芙委。比如創(chuàng)建Tenant, EPG等自動化配置工作。
