Senden von Daten an einen HTTP-Endpunkt
Wichtig
Die von Azure Arc aktivierte Azure IoT Operations Preview befindet sich derzeit in der VORSCHAU. Sie sollten diese Vorschausoftware nicht in Produktionsumgebungen verwenden.
Sie müssen eine neue Azure IoT Operations-Installation bereitstellen, wenn eine allgemein verfügbare Version verfügbar ist, können Sie keine Vorschauinstallation aktualisieren.
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 des Datenauftragsverarbeiters, die die optionale Datenverarbeitungskomponente enthält.
- Ein HTTP-Server, auf den über die Datenverarbeitungsinstanz 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 , usernamePassword und 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"]
}