REST API（主動）

您可使用 REST API 主動監控工具來監控任何支援匿名和基本身分驗證的 REST API，此外您也可以透過 JSONPath 查詢來驗證 JSON 回應。

如要設定 REST API 主動監控工具：

名稱：輸入監控工具的專屬名稱。此名稱會顯示在「主動監控工具資料庫」中。
說明：輸入監控工具的其他資訊。這段說明會顯示在「主動監控工具資料庫」中監控工具名稱的旁邊。
用於重新掃描：此選項表示 WhatsUp Gold 應在探索偵測到需要此操作的任何新條件時，嘗試套用此主動監控工具。
逾時：輸入 WhatsUp Gold 等候 REST API 回應的時間應該為多久，一旦超出就結束連線並傳回逾時錯誤訊息。所允許的最小值是 1 秒，而最大值是 120 秒。
REST API
- 編輯自訂標頭：輸入最多 10 個存取 REST API 端點所需的自訂標頭。系統提供一個預設的「Accept」標頭並將其指定為「application/json」。
Note: 如要監控 OpenEdge OEManager REST API 端點的 Progress 應用程式伺服器，「Accept」標頭必須設定為「application/vnd.progress+json」或「*/*」。
- REST API URL：您想要監控的 REST API 端點的 URL。
Note: REST API URL 中支援系統 (%System)、裝置 (%Device) 和應用程式 (%Application) 的參考變數（又稱為百分比變數）。如需詳細資訊，請參閱〈百分比變數〉。
- 方法：為 REST API 端點選取一個支援的 HTTP 方法。目前僅支援 GET 方法。
- 忽略憑證錯誤：啟用此核取方塊來強制 WhatsUp Gold 略過任何憑證錯誤。
- 使用匿名存取：如果 REST API 端點不需要身分驗證，那麼請勾選此方塊。
離線條件：若傳回任何所列出的 HTTP 回應碼，那麼監控工具將會回報為「離線」。您可以控制哪些回應碼表示監控工具為離線，還可以提供一個 JSONPath 査詢以及表示監控工具是否為離線的條件。監控工具可以使用一個離線條件、一個 JSONPath 查詢或者兩者皆使用來傳回一個離線回應。
JSONPATH 查詢：設計一個邏輯測試來評估 REST API 端點傳回的條件：
1. 選取新增圖示來輸入一個使用 JSONPath 查詢的條件測試。預設將會在行內顯示「未設定比較」的文字。
2. 在 JSONPath 查詢輸入內按兩下，然後選取放大鏡標誌。如果為沒有勾選「使用匿名存取」的話，那麼這將會提示您輸入一個 REST API 認證。REST API 認證通過驗證之後，將會開啟 JSONPath 建置工具視窗。
3. 選取要監控的端點。
4. 建置一個邏輯測試來表示所監控的 REST API 端點為離線的條件。支援的值類型為布林值、數字、字串和其他。若值為空 (Null)，則將會勾選「其他」資料類型。支援空白字串。
5. 按一下 [儲存]。

Note: 如要深入了解 JSONPath 和 JSONPath 建置工具，請參閱〈JSONPath 查詢〉和〈JSONPath 建置工具〉。