Delen via

Gegevens verzenden naar een HTTP-eindpunt

  • Artikel

Belangrijk

Azure IoT Operations Preview: ingeschakeld door Azure Arc is momenteel in PREVIEW. Gebruik deze preview-software niet in productieomgevingen.

Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

Gebruik de HTTP-bestemming om verwerkte en schone gegevens naar een HTTP-eindpunt te schrijven voor verdere verwerking.

Wanneer u gegevens vanuit een doelfase naar een HTTP-eindpunt verzendt, wordt een antwoord verwijderd.

Vereisten

Als u deze doelpijplijnfase wilt configureren en gebruiken, hebt u het volgende nodig:

  • Een geïmplementeerd exemplaar van Azure IoT-gegevensprocessor (preview).
  • Een HTTP-server die toegankelijk is vanuit het dataprocessorexemplaren.

De doelfase configureren

De JSON-configuratie van de HTTP-doelfase definieert de details van de fase. Als u de fase wilt ontwerpen, kunt u communiceren met de gebruikersinterface op basis van formulieren of de JSON-configuratie opgeven op het tabblad Geavanceerd :

Veld Type Description Vereist? Standaardinstelling Opmerking
url tekenreeks URL voor de aanvraag. Zowel HTTP als HTTPS worden ondersteund. Ja https://contoso.com/some/url/path
method enum van tekenreeks De HTTP-methode die moet worden gebruikt. Een van: POST, PUT Ja POST
request Aanvragen Een object dat de hoofdtekst en headers van de aanvraag vertegenwoordigt. Nee (leeg) Aanvraag bekijken
retry Opnieuw proberen Het mechanisme voor opnieuw proberen dat moet worden gebruikt als de aanroep mislukt. Nee (leeg) {"type": "fixed"}
authentication Authentication type Verificatiegegevens voor het eindpunt. Ondersteunt none, usernamePassworden header verificatietypen. Nee {"type": "none"} {"type": "none"}

Aanvraag

Veld Type Description Vereist? Standaardinstelling Opmerking
body Object. Opmaakgegevens, inclusief de locatie waar de hoofdtekst zich in het bericht bevindt. Nee (leeg) {"type": "json", "path": ".payload"}
headers Een matrix met objecten. Lijst met headers die moeten worden verzonden met de aanvraag. Sleutels en waarden kunnen statisch of dynamisch zijn. Nee [] Voorbeelden bekijken

Voorbeeldconfiguratie

In de volgende JSON ziet u een voorbeelddefinitie voor een HTTP-doelfase:

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

Gerelateerde inhoud