HTTP エンドポイントにデータを送信する
重要
Azure Arc によって有効にされる Azure IoT Operations Preview は、 現在プレビュー段階です。 運用環境ではこのプレビュー ソフトウェアを使わないでください。
一般公開リリースが利用可能になった場合は、新しい Azure IoT Operations インストールをデプロイする必要があります。プレビュー インストールをアップグレードすることはできません。
ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。
HTTP 変換先を使用し、さらに処理するために処理済みのクリーンなデータを HTTP エンドポイントに書き込みます。
変換先ステージから HTTP エンドポイントにデータを送信すると、応答はすべて破棄されます。
前提条件
この変換先パイプライン ステージを構成して使用するには、次のものが必要です。
- オプションのデータ プロセッサ コンポーネントを含むデータ プロセッサのデプロイされたインスタンス。
- データ プロセッサ インスタンスからアクセスできる HTTP サーバー。
変換先ステージを構成する
HTTP 変換先ステージの JSON 構成で、ステージの詳細が定義されます。 ステージを作成するには、フォーム ベースの UI を使用するか、[詳細設定] タブで次の JSON 構成を指定します。
| フィールド | タイプ | 説明 | 必須 | 既定値 | 例 |
|---|---|---|---|---|---|
url |
string | 要求の URL。 HTTP と HTTPS の両方がサポートされています。 | はい | https://contoso.com/some/url/path |
|
method |
string enum | HTTP メソッドを使用します。 POST と PUT のいずれか |
はい | POST |
|
request |
Request | 要求本文とヘッダーを表すオブジェクト。 | いいえ | (空) | 「要求」を参照してください |
retry |
再試行 | 呼び出しが失敗した場合に使用する再試行メカニズム。 | いいえ | (空) | {"type": "fixed"} |
authentication |
認証の種類 | エンドポイントの認証情報。 none、usernamePassword、および header の認証の種類がサポートされています。 |
いいえ | {"type": "none"} |
{"type": "none"} |
要求
| フィールド | タイプ | 説明 | 必須 | 既定値 | 例 |
|---|---|---|---|---|---|
body |
オブジェクト。 | メッセージ内の本文の位置を含む書式設定情報。 | いいえ | (空) | {"type": "json", "path": ".payload"} |
headers |
オブジェクトの配列です。 | 要求と共に送信されるヘッダーの一覧。 キーと値は静的または動的にすることができます。 | いいえ | [] |
例 を見る |
サンプル構成
次の 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"]
}