Volání koncového bodu HTTP z kanálu zpracovatele dat
Důležité
Azure IoT Operations Preview – Služba Azure Arc je aktuálně ve verzi PREVIEW. Tento software ve verzi Preview byste neměli používat v produkčních prostředích.
Pokud je dostupná obecně dostupná verze, budete muset nasadit novou instalaci operací Azure IoT, nebudete moct upgradovat instalaci ve verzi Preview.
Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.
Fáze volání PROTOKOLU HTTP slouží k volání externího koncového bodu HTTP s volitelným textem požadavku a přijetí volitelné odpovědi. Fáze volání umožňuje začlenit do zpracování kanálu vlastní logiku zpracování dat, například spouštění modelů strojového učení.
- Každý oddíl v kanálu nezávisle spouští paralelní volání HTTP.
- Volání HTTP jsou synchronní, fáze čeká na vrácení volání, než bude pokračovat v dalším zpracování kanálu.
Požadavky
Ke konfiguraci a použití fáze agregovaného kanálu potřebujete:
- Nasazená instance zpracovatele dat, která zahrnuje volitelnou součást zpracovatele dat.
- Server HTTP, který je přístupný z instance zpracovatele dat.
Konfigurace fáze volání PROTOKOLU HTTP
Konfigurace JSON s popisem volání HTTP definuje podrobnosti fáze. Pokud chcete vytvořit fázi, můžete pracovat s uživatelským rozhraním založeným na formuláři nebo zadat konfiguraci JSON na kartě Upřesnit :
| Name | Typ | Popis | Požaduje se | Výchozí | Příklad |
|---|---|---|---|---|---|
| Název | string | Název, který se má zobrazit v uživatelském rozhraní zpracovatele dat. | Ano | - | MLCall1 |
| Popis | string | Uživatelsky přívětivý popis toho, co fáze volání dělá. | No | Call ML endpoint 1 |
|
| metoda | string – výčet | Metoda HTTP. | No | POST |
GET |
| URL | string | Adresa URL PROTOKOLU HTTP. | Ano | - | http://localhost:8080 |
| Ověřování | string | Typ ověřování, který se má použít. None/Username/Password/Header. |
Ano | None |
None |
| Username | string | Uživatelské jméno, které se má použít, pokud Authentication je nastaveno .Username/Password |
No | - | myusername |
| Tajný | string | Referenční informace k tajnému kódu pro heslo, které se má použít, pokud Authentication je nastavena na Username/Passwordhodnotu . |
No | - | mysecret |
| Klíč záhlaví | string | Klíč záhlaví, který se má použít, pokud Authentication je nastaven na Headerhodnotu . Hodnota musí být authorization. |
No | authorization |
authorization |
| Tajný | string | Odkaz na tajný kód, který se má použít, pokud Authentication je nastaven na Headerhodnotu . |
No | - | mysecret |
| Formát dat požadavků > rozhraní API | string | Formát textu požadavku by měl být v podrobnostech o serializaci. | No | - | JSON |
| Cesta požadavku > rozhraní API | Cesta | Cesta k vlastnosti příchozí zprávy, která se má odeslat jako text požadavku. Pokud nepotřebujete posílat text požadavku, nechejte prázdný. | No | - | .payload.httpPayload |
| Klíčhlavičky > požadavku > rozhraní API 1 | Statické nebo dynamické pole | Klíč hlavičky, který se má nastavit v požadavku. | No | Statické nebo dynamické pole | |
| Hodnotahlavičky > požadavku > rozhraní API 1 | Statické nebo dynamické pole | Hodnota hlavičky, která se má v požadavku nastavit. | No | Statické nebo dynamické pole | |
| Formát dat odpovědi > rozhraní API | string | Formát textu odpovědi je v podrobnostech o deserializaci. | No | - | JSON |
| Cesta odpovědi > rozhraní API | Cesta | Cesta k vlastnosti v odchozí zprávě pro uložení odpovědi. Pokud text odpovědi nepotřebujete, nechte prázdný. | No | - | .payload.httpResponse |
| Hlavička odpovědi > rozhraní API | Cesta | Cesta k vlastnosti v odchozí zprávě pro uložení hlavičky odpovědi. Pokud nepotřebujete metadata odpovědi, ponechte pole prázdné. | No | - | .payload.httpResponseHeader |
| Stav odpovědi > rozhraní API | Cesta | Cesta k vlastnosti v odchozí zprávě pro uložení stavu odpovědi. Pokud stav odpovědi nepotřebujete, nechejte prázdný. | No | - | .payload.httpResponseStatus |
1Hlavička požadavku > rozhraní API: Každý prvek v poli hlavičky je pár klíč-hodnota. Klíč nebo hodnotu můžete dynamicky nastavit na základě obsahu příchozí zprávy nebo jako statický řetězec.
Formáty zpráv
Fázi volání HTTP můžete použít s libovolným formátem dat. K serializaci a deserializaci podporovaných datových formátů použijte integrovaný serializátor a deserializátor. Slouží Raw ke zpracování jiných formátů dat.
Ověřování
V současné době se podporuje pouze ověřování na základě hlaviček.