了解 ONTAP tools REST API
ONTAP tools for VMware vSphere 10 是一套用於虛擬機器生命週期管理的工具。它包含一個強大的 REST API,您可以將其用作自動化流程的一部分。
REST Web 服務基礎
表述性狀態轉移(REST)是一種用於建立分散式 Web 應用程式(包括 Web 服務 API 設計)的風格。它建立了一套用於公開伺服器資源並管理其狀態的技術。
資源是 REST Web 服務應用程式的基礎組成部分。設計 REST API 時有兩個重要的初始任務:
-
識別系統或伺服器上的資源
-
定義資源狀態和相關的狀態轉換操作
用戶端應用程式可以透過定義完善的訊息流顯示和變更資源狀態。
超文字傳輸協定 (HTTP) 是 Web 服務用戶端和伺服器用於交換資源訊息的協定。它遵循基於建立、讀取、更新和刪除這四個通用操作的 CRUD 模型。HTTP 協定包含請求標頭、回應標頭以及回應狀態碼。
雖然有多種訊息格式可供選擇,但最常用的是 JavaScript 物件表示法 (JSON)。JSON 是一種產業標準,用於以純文字形式表示簡單的資料結構,並用於傳輸描述資源和所需動作的狀態資訊。
安全性是 REST API 的一個重要面向。除了用於保護網路 HTTP 流量的傳輸層安全性協定 (TLS) 之外,ONTAP tools for VMware vSphere 10 REST API 也使用存取權杖進行驗證。您需要取得存取權杖並在後續 API 呼叫中使用它。
ONTAP tools for VMware vSphere 10 REST API 會同步執行大多數要求,並在作業完成後傳回狀態碼。它也支援非同步處理,適用於需要較長時間才能完成的工作。
ONTAP tools Manager 環境
您應該考慮 ONTAP tools Manager 環境的幾個面向。
ONTAP tools for VMware vSphere 10 採用 vSphere 遠端外掛架構進行部署。該軟體(包括對 REST API 的支援)在分隔的虛擬機器中執行。
ONTAP tools for VMware vSphere 10 會公開單一 IP 位址,該位址作為存取虛擬機器功能的閘道。您需要在初始組態期間提供此位址,它將被指派給一個內部負載平衡器元件。ONTAP tools Manager 使用者介面以及直接存取 Swagger 文件頁面和 REST API 都使用此位址。
除了 ONTAP tools for VMware vSphere 10 REST API 之外,ONTAP 叢集本身也擁有自己的 REST API。ONTAP tools Manager 使用 ONTAP REST API 作為用戶端來執行儲存設備相關任務。請務必注意,這兩個 API 是分隔且不同的。如需更多資訊,請參閱 "ONTAP 自動化"。