Teilen über

Senden von Daten an einen HTTP-Endpunkt

  • Artikel

Wichtig

Die von Azure Arc aktivierte Azure IoT Operations Preview befindet sich derzeit in der VORSCHAU. Sie sollten diese Vorschausoftware nicht in Produktionsumgebungen verwenden.

Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Verwenden Sie das HTTP Ziel zum Schreiben verarbeiteter und sauberer Daten in einen HTTP-Endpunkt zur weiteren Verarbeitung.

Wenn Sie Daten von einer Zielstufe an einen HTTP-Endpunkt senden, wird jede Antwort verworfen.

Voraussetzungen

Um diese Zielpipelinephase zu konfigurieren und zu verwenden, benötigen Sie Folgendes:

  • Eine bereitgestellte Instanz von Azure IoT Data Processor (Vorschau), die die optionale Datenverarbeitungskomponente enthält.
  • Einen HTTP-Server, auf den über die Datenprozessorinstanz zugegriffen werden kann.

Konfigurieren der Zielphase

Die HTTP-Konfiguration der JSON-Zielstufe definiert die Details der Phase. Um die Phase zu erstellen, können Sie entweder mit der formularbasierten Benutzeroberfläche interagieren oder die JSON-Konfiguration auf der Registerkarte Erweitert bereitstellen:

Feld Typ Description Erforderlich? Standard Beispiel
url Zeichenfolge URL für die Anforderung. Sowohl HTTP als auch HTTPS werden unterstützt. Ja https://contoso.com/some/url/path
method Zeichenfolgenenumeration Die zu verwendende HTTP-Methode. Einer der folgenden Werte: POST, PUT Ja POST
request Anforderung Ein Objekt, das den Anforderungstext und die Kopfzeilen darstellt. No (leer) Siehe Anforderung
retry Wiederholen Der Wiederholungsmechanismus, der verwendet werden soll, wenn der Aufruf fehlschlägt. No (leer) {"type": "fixed"}
authentication Authentication type Authentifizierungsinformationen für den Endpunkt. Unterstützt none, usernamePasswordund header Authentifizierungstypen. No {"type": "none"} {"type": "none"}

Anfordern

Feld Typ Description Erforderlich? Standard Beispiel
body Widerspruchsrecht: Formatierungsinformationen, einschließlich des Speicherorts, an dem sich der Textkörper in der Nachricht befindet. No (leer) {"type": "json", "path": ".payload"}
headers Ein Array von -Objekten. Liste der Header, die mit der Anfrage gesendet werden sollen. Schlüssel und Werte können statisch oder dynamisch sein. No [] Siehe Beispiele

Beispielkonfiguration

Der folgende JSON-Code zeigt eine Beispieldefinition für eine HTTP-Zielstufe:

{
    "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"]
}

Zugehöriger Inhalt