Partager via

Envoyer des données sur un point de terminaison HTTP

  • Article

Important

Opérations Azure IoT (préversion) – activé parc Azure Arc est actuellement en PRÉVERSION. Vous ne devez pas utiliser ce logiciel en préversion dans des environnements de production.

Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

Utilisez la destination HTTP pour écrire des données traitées et propres dans un point de terminaison HTTP pour un traitement plus approfondi.

Lorsque vous envoyez des données sur un point de terminaison HTTP à partir d’un index de destination, toute réponse est ignorée.

Prérequis

Pour configurer et utiliser cet index de pipeline de destination, vous avez besoin des éléments suivants :

  • Une instance déployée d’Azure IoT Data Processor (préversion) qui inclut le composant Data Processor facultatif.
  • Un serveur HTTP accessible à partir de l’instance de Data Processor .

Configuration l’index de destination

La configuration JSON de l’index de destination HTTP définit les détails de l’index. Pour créer l’index, vous pouvez interagir avec l’interface utilisateur basée sur le formulaire ou fournir la configuration JSON sous l’onglet Avancé :

Champ Type Description Requis ? Par défaut Exemple
url string URL de la requête. HTTP et HTTPS sont pris en charge. Oui https://contoso.com/some/url/path
method énumération de chaînes Méthode HTTP à utiliser. Valeurs possibles : POST, PUT Oui POST
request Requête Objet qui représente le corps et les en-têtes de la requête. Non (empty) Voir Requête
retry Réessayer Mécanisme de nouvelle tentative à utiliser si l’appel échoue. Non (empty) {"type": "fixed"}
authentication Type d'authentification Informations d’authentification pour le point de terminaison. Prend en charge les types d’authentification none, usernamePassword et header. Non {"type": "none"} {"type": "none"}

Requête

Champ Type Description Requis ? Par défaut Exemple
body Objet. Informations de mise en forme, y compris l’emplacement où se trouve le corps dans le message. Non (empty) {"type": "json", "path": ".payload"}
headers Tableau d'objets . List des en-têtes à envoyer avec la requête. Les clés et les valeurs peuvent être statiques ou dynamiques. Non [] Voir des exemples

Exemple de configuration

Le code JSON suivant montre un exemple de définition pour un index de destination 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"]
}

Contenu connexe