共用方式為

從數據處理者管線呼叫 HTTP 端點

  • 發行項

重要

已啟用 Azure Arc 的 Azure IoT 操作預覽版目前為預覽狀態。 請勿在生產環境使用此預覽版軟體。

當正式發行可供使用時，您將需要部署新的 Azure IoT 作業安裝，您將無法升級預覽安裝。

請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

使用「HTTP 呼叫」階段可呼叫具有選擇性要求本文的外部 HTTP 端點，並接收選擇性回應。 呼叫階段可協助您將自訂資料處理邏輯 (例如執行機器學習模型) 整合至管線處理。

  • 管線中每個分割區都會以平行方式獨立執行 HTTP 呼叫。
  • HTTP 呼叫會同步執行，而階段會等待呼叫傳回後，再繼續執行下一步管線處理。

必要條件

若要設定並使用彙總管線階段，則需要：

  • 包含選擇性數據處理者元件的已部署數據處理者實例。
  • 可從數據處理者實例存取的 HTTP 伺服器。

設定 HTTP 呼叫階段

HTTP 呼叫階段 JSON 設定負責定義階段的詳細資料。 若要編寫階段，可透過與表單架構使用者介面互動，或在 [進階] 索引標籤上提供 JSON 設定：

名稱 類型​​ 描述 是必要欄位 預設 範例
名稱 字串 要顯示在數據處理者 UI 中的名稱。 Yes - MLCall1
描述 string 使用者易記的呼叫階段功能描述。 No Call ML endpoint 1
方法 字串列舉 HTTP 方法。 No POST GET
URL string HTTP URL。 Yes - http://localhost:8080
驗證 string 要使用的驗證類型。 None/Username/Password/Header. Yes None None
使用者名稱 string 當 Authentication 設定為 Username/Password 時使用的使用者名稱。 No - myusername
祕密 string 當 Authentication 設定為 Username/Password 時密碼使用的祕密參考。 No - mysecret
標頭索引鍵 string 當 Authentication 設定為 Header 時使用的標頭索引鍵。 值必須是 authorization。 No authorization authorization
祕密 string 當 Authentication 設定為 Header 時使用的祕密參考。 No - mysecret
API 要求 > 資料格式 string 要求本文應採用的格式，以及任何序列化詳細資訊。 No - JSON
API 要求 > 路徑 路徑 作為要求本文發送之傳入訊息的屬性路徑。 如果不須傳送要求本文，請保持空白。 No - .payload.httpPayload
API 要求 > 標頭 > 索引鍵1 靜態/動態欄位 要設定於要求中的標頭索引鍵。 No 靜態/動態欄位
API 要求 > 標頭 > 值1 靜態/動態欄位 要設定於要求中的標頭值。 No 靜態/動態欄位
API 回應 > 資料格式 string 回應本文採用的格式，以及任何還原序列化詳細資訊。 No - JSON
API 回應 > 路徑 路徑 傳出訊息中用於儲存回應之屬性的路徑。 如果不需要回應本文，請保持空白。 No - .payload.httpResponse
API 回應 > 標頭 路徑 傳出訊息中用於儲存回應標頭之屬性的路徑。 如果不需要回應中繼資料，請保持空白。 No - .payload.httpResponseHeader
API 回應 > 狀態 路徑 傳出訊息中用於儲存回應狀態之屬性的路徑。 如果不需要回應狀態，請保持空白。 No - .payload.httpResponseStatus

1API 要求 > 標頭：標頭陣列中的每個元素都是索引鍵值組。 您可以根據傳入訊息的內容動態設定為索引鍵或值，或設定為靜態字串。

訊息格式

您能以任何資料格式使用 HTTP 呼叫階段。 若要序列化和還原序列化支援的資料格式，可使用內建序列化程式與還原序列化程式。 若要處理其他資料格式，則可使用 Raw。

驗證

目前僅支援標頭型驗證。

相關內容