Appeler un point de terminaison HTTP à partir d’un pipeline de processeur de données
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.
Vous devrez déployer une nouvelle installation d’Azure IoT Operations lorsqu’une version en disponibilité générale est mise à disposition, vous ne pourrez pas mettre à niveau une installation en préversion.
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 l’index appel HTTP pour appeler un point de terminaison HTTP externe avec un corps de requête facultatif et recevoir une réponse facultative. L’index d’appel vous permet d’incorporer une logique de traitement des données personnalisée, telle que l’exécution de modèles Machine Learning, dans le traitement du pipeline.
- Chaque partition d’un pipeline exécute indépendamment les appels HTTP en parallèle.
- Les appels HTTP sont synchrones, l’index attend le retour de l’appel avant de poursuivre le traitement du pipeline.
Prérequis
Pour configurer et utiliser un index de pipeline d’agrégat, vous avez besoin des éléments suivants :
- Instance déployée du processeur de données qui inclut le composant facultatif du processeur de données.
- Serveur HTTP accessible à partir de l’instance du processeur de données.
Configurer un index d’appel HTTP
La configuration JSON de l’index d’appel 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 Advanced (Avancé) :
| Nom | Type | Description | Obligatoire | Par défaut | Exemple |
|---|---|---|---|---|---|
| Nom | chaîne | Nom à afficher dans l’interface utilisateur du processeur de données. | Oui | - | MLCall1 |
| Description | string | Une description conviviale de ce que fait l’index d’appel. | Non | Call ML endpoint 1 |
|
| Méthode | énumération de chaînes | Méthode HTTP. | Non | POST |
GET |
| URL | string | L’adresse URL HTTP. | Oui | - | http://localhost:8080 |
| Authentification | string | Type d’authentification à utiliser. None/Username/Password/Header. |
Oui | None |
None |
| Nom d’utilisateur | string | Nom d’utilisateur à utiliser quand Authentication est défini sur Username/Password. |
Non | - | myusername |
| Secret | string | La référence secrète du mot de passe à utiliser lorsque Authentication est défini sur Username/Password. |
Non | - | mysecret |
| Clé d’en-tête | string | La clé d’en-tête à utiliser quand Authentication est définie sur Header. La valeur doit être authorization. |
Non | authorization |
authorization |
| Secret | string | La référence secrète à utiliser lorsque Authentication est défini sur Header. |
Non | - | mysecret |
| Format de données > de la requête d’API | string | Le format du corps de la demande et tous les détails de la sérialisation. | Non | - | JSON |
| Chemin d’accès > de la requête d’API | Chemin d’accès | Le chemin d’accès à la propriété dans le message entrant à envoyer comme corps de la demande. Laissez vide si vous n’avez pas besoin d’envoyer un corps de demande. | Non | - | .payload.httpPayload |
| Clé > d’en-tête > de la requête d’API1 | Champ statique/dynamique | La clé d’en-tête à définir dans la requête. | Non | Champ statique/dynamique | |
| Valeur > d’en-tête > de la requête d’API1 | Champ statique/dynamique | La valeur d’en-tête à définir dans la requête. | Non | Champ statique/dynamique | |
| Format de données > de la réponse d’API | string | Le format du corps de la réponse et tous les détails de la désérialisation. | Non | - | JSON |
| Chemin d’accès > de la réponse d’API | Chemin d’accès | Le chemin d’accès à la propriété dans le message sortant dans lequel stocker la réponse. Laissez vide si vous n’avez pas besoin du corps de la réponse. | Non | - | .payload.httpResponse |
| En-tête > de la réponse d’API | Chemin d’accès | Le chemin d’accès à la propriété dans le message sortant dans lequel stocker l’en-tête de la réponse. Laissez vide si vous n’avez pas besoin des métadonnées de la réponse. | Non | - | .payload.httpResponseHeader |
| Réponse API > État | Chemin d’accès | Le chemin d’accès à la propriété dans le message sortant dans lequel stocker l’état de la réponse. Laissez vide si vous n’avez pas besoin de l’état de la réponse. | Non | - | .payload.httpResponseStatus |
1Requête API > Entête : Chaque élément du tableau d'en-tête est une paire clé-valeur. Vous pouvez définir dynamiquement la clé ou la valeur en fonction du contenu du message entrant ou sous forme de chaîne statique.
Formats des messages
Vous pouvez utiliser l’index d’appel HTTP avec n’importe quel format de données. Utilisez le sérialiseur et le désérialiseur intégrés pour sérialiser et désérialiser les formats de données pris en charge. Utilisez Raw pour gérer d’autres formats de données.
Authentification
Actuellement, seule l’authentification basée sur l’en-tête est prise en charge.