您可以透過 Curl 或程式設計語言直接存取 ONTAP REST API 。在這種情況下、基本 URL 與您在存取 ONTAP 線上文件或系統管理員時所使用的 URL 不同。

直接存取 API 時、您需要將 API 附加到網域或 IP 位址。例如：

https://ontap.demo-example.com/api

請參閱 "如何存取ONTAP 靜態API" 以取得更多資訊。

大多數 REST API 呼叫通常會使用數個輸入參數。這些參數通常未在個別工作流程中說明。您應該熟悉這些參數。請參閱 "控制API要求的輸入變數" 以取得更多資訊。

如果特定 REST API 呼叫需要其他參數、則會包含在每個工作流程的捲曲範例 * 的 * 額外輸入參數一節中。

工作流程範例所使用的 ID 值和其他變數是不透明的、可能會因每個 ONTAP 叢集而異。為了改善範例的可讀性、不使用實際值。而是使用變數。這種方法以一致的格式和一組保留名稱為基礎、有幾項優點：

這些變數已格式化為用於 Bash Shell 環境。每個變數都以美元符號開頭、並視需要以雙引號括住。這讓 Bash 能夠辨識他們的能力。大寫字母會持續用於名稱。

以下是一些常見的變數關鍵字。此清單並非詳盡無遺、並視需要使用其他變數。其意義應根據背景而明確。

某些 REST API 呼叫（例如使用 POST 或修補程式的呼叫）需要在要求主體中輸入 JSON 。JSON 輸入範例與捲曲範例分開呈現、以供清楚說明。您可以將 JSON 輸入範例與下列其中一種技術搭配使用。

您可以將 JSON 輸入範例複製到檔案中、並將其儲存在本機上。Curl 命令是使用來參照檔案 --data 參數、其值會以 a 表示檔案名稱 @ 前置碼：

首先、您需要將捲曲範例複製並貼到終端機殼層。然後編輯範例以完全移除 --data 最後的參數、並以取代 --data-raw 參數。最後、在 JSON 範例中複製並貼上、使其跟隨具有更新參數的 Curl 命令。您應該使用單引號來包裝 JSON 輸入範例。

使用基本驗證時、每個 HTTP 要求都必須包含使用者認證。傳送認證有兩個選項。

您可以手動建構授權標頭、並將其納入 HTTP 要求中。這可以在 CLI 中使用 cURL 命令或使用自動化程式碼的程式設計語言時完成。高階步驟包括：

工作流程捲曲範例包括此標頭及變數 $basic_AUTH 、您必須先更新才能使用。

使用 Curl 時的另一個選項是移除授權標頭、改用 Curl * user* 參數。例如：

--user username:password

您必須為環境替換適當的認證。認證並未在 base64 中編碼。使用此參數執行 cURL 命令時、會編碼字串、並為您產生授權標頭。

使用 OAuth 2.0 時、您需要向外部授權伺服器要求存取權杖、並將其納入每個 HTTP 要求中。基本的高階步驟如下所述。另請參閱 "ONTAP OAuth 2.0 實作總覽" 如需 OAuth 2.0 及如何搭配 ONTAP 使用的詳細資訊、請參閱。

在使用 REST API 存取 ONTAP 之前、您需要準備和設定 ONTAP 環境。在較高層級、步驟包括：

透過 ONTAP 和授權伺服器的定義和作用中、您可以使用 OAuth 2.0 權杖進行 REST API 呼叫。第一步是向授權伺服器要求存取權杖。這是在 ONTAP 以外使用多種不同技術的伺服器上進行的。ONTAP 不會發出存取權杖或執行重新導向。

取得存取權杖之後、您可以建構授權標頭、並將其納入 HTTP 要求中。無論您是使用 Curl 或程式設計語言來存取 REST API 、每個用戶端要求都必須包含標頭。您可以如下建構標頭：

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSld …​