共用方式為

將數據傳送至 HTTP 端點

  • 發行項

重要

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

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

使用 HTTP 目的地將已處理的數據寫入 HTTP 端點，以便進一步處理。

當您從目的地階段將數據傳送至 HTTP 端點時，會捨棄任何回應。

必要條件

若要設定及使用此目的地管線階段，您需要：

  • 已部署的 Azure IoT 數據處理者預覽實例，其中包含選擇性的數據處理者元件。
  • 可從資料處理器執行個體存取的 HTTP 伺服器。

設定目的地階段

HTTP 目的地階段 JSON 組態會定義階段的詳細數據。 若要編寫階段，可透過與表單架構使用者介面互動，或在 [進階] 索引標籤上提供 JSON 設定：

欄位 類型 描述 是必要的嗎? 預設 範例
url 字串 要求的 URL。 支援 HTTP 和 HTTPS。 Yes https://contoso.com/some/url/path
method 字串列舉 要使用的 HTTP 方法。 其中一個： POST、 PUT Yes POST
request 要求 物件，表示要求本文和標頭。 No (空白) 請參閱 要求
retry 重試 呼叫失敗時要使用的重試機制。 No (空白) {"type": "fixed"}
authentication 驗證類型 端點的驗證資訊。 支援 none、 usernamePassword和 header 驗證類型。 No {"type": "none"} {"type": "none"}

Request

欄位 類型 描述 是必要的嗎? 預設 範例
body 反對。 格式化資訊，包括本文位於訊息中的位置。 No (空白) {"type": "json", "path": ".payload"}
headers 物件的陣列。 要隨要求一起傳送的標頭清單。 索引鍵和值可以是 靜態或動態。 No [] 請參閱 範例

範例設定

下列 JSON 顯示 HTTP 目的地階段的範例定義：

{
    "displayName": "HTTP Output Example",
    "description": "Sample HTTP output stage",
    "type": "output/http@v1",
    "url": "https://contoso.com/some/url/path",
    "method": "POST",
    "request": {
        "body": {
            "format": "json",
            "path": ".payload",
        },
        "headers": [
            {
                "key": {
                    "type": "static",
                    "value": "asset"
                },
                "value": {
                    "type": "dynamic",
                    "value": ".payload.assetId"
                }
            },
            {
                "key": {
                    "type": "static",
                    "value": "revision"
                },
                "value": {
                    "type": "static",
                    "value": "12"
                }
            }
        ]
    },
    "retry": {
        "type": "fixed",
        "interval": "20s",
        "maxRetries": 4
    },
    "next": ["next-stage-id"]
}

相關內容