REST API（主動）

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

• 名稱 ：輸入監控工具的專屬名稱。此名稱會顯示在「主動監控工具資料庫」中。
• 說明 ：輸入監控工具的其他資訊。這段說明會顯示在「主動監控工具資料庫」中監控工具名稱的旁邊。
• 用於重新掃描 ：此選項表示 WhatsUp Gold 應在探索偵測到需要此操作的任何新條件時，嘗試套用此主動監控工具。
• 逾時 ：輸入 WhatsUp Gold 等候 REST API 回應的時間應該為多久，一旦超出就結束連線並傳回逾時錯誤訊息。所允許的最小值是 1 秒，而最大值是 120 秒。
• REST API
  • 編輯自訂標頭 ：輸入最多 10 個存取 REST API 端點所需的自訂標頭。系統提供一個預設的「Accept」標頭並將其指定為「 application/json 」。
    註: 如要監控 OpenEdge OEManager REST API 端點的 Progress 應用程式伺服器，「Accept」標頭必須設定為「 application/vnd.progress+json 」或「 */* 」。
  • REST API URL ：您想要監控的 REST API 端點的 URL。
    註: 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. 按一下 [儲存] 。