Вызов конечной точки HTTP из конвейера обработчика данных
Внимание
Предварительная версия операций Интернета вещей Azure, включенная Azure Arc в настоящее время находится в предварительной версии. Не следует использовать это программное обеспечение предварительной версии в рабочих средах.
Вам потребуется развернуть новую установку Операций Интернета вещей Azure, когда общедоступная версия станет доступной, вы не сможете обновить предварительную установку.
Юридические условия, применимые к функциям Azure, которые находятся в состоянии бета-версии, предварительной версии или иным образом еще не выпущены в общедоступной версии, см. на странице Дополнительные условия использования предварительных версий в Microsoft Azure.
Используйте этап вызова HTTP, чтобы вызвать внешнюю конечную точку HTTP с необязательным текстом запроса и получить необязательный ответ. Этап вызова позволяет включить пользовательскую логику обработки данных, например запуск моделей машинного обучения, в обработку конвейера.
- Каждая секция в конвейере независимо выполняет вызовы HTTP параллельно.
- HTTP-вызовы синхронны, этап ожидает возврата вызова, прежде чем продолжить дальнейшую обработку конвейера.
Необходимые компоненты
Чтобы настроить и использовать этап агрегатного конвейера, вам потребуется:
- Развернутый экземпляр обработчика данных, который включает необязательный компонент обработчика данных.
- HTTP-сервер, доступный из экземпляра обработчика данных.
Настройка этапа вызова HTTP
Конфигурация JSON для вызова HTTP определяет сведения о стадии. Чтобы создать этап, вы можете взаимодействовать с пользовательским интерфейсом на основе форм или предоставить конфигурацию JSON на вкладке "Дополнительно ":
Имя. | Тип | Описание | Обязательное поле | По умолчанию. | Пример |
---|---|---|---|---|---|
Имя. | строка | Имя, отображаемое в пользовательском интерфейсе обработчика данных. | Да | - | MLCall1 |
Description | строка | Понятное описание того, что делает этап вызова. | No | Call ML endpoint 1 |
|
Способ | string enum | Метод HTTP. | No | POST |
GET |
URL | строка | URL-адрес HTTP. | Да | - | http://localhost:8080 |
Проверка подлинности | строка | Тип проверки подлинности. None /Username/Password /Header . |
Да | None |
None |
Username | строка | Имя пользователя, используемое, если Authentication задано значение Username/Password . |
No | - | myusername |
Секретный | строка | Ссылка на секрет, используемая паролем, если Authentication задано значение Username/Password . |
No | - | mysecret |
Ключ заголовка | строка | Ключ заголовка, используемый, если Authentication задано значение Header . Значение должно быть равно authorization . |
No | authorization |
authorization |
Секретный | строка | Ссылка на секрет, используемая, если Authentication задано значение Header . |
No | - | mysecret |
Формат данных запроса > API | строка | Формат текста запроса должен находиться в любом формате сериализации. | No | - | JSON |
Путь запроса > API | Путь | Путь к свойству входящего сообщения для отправки в виде текста запроса. Оставьте пустым, если вам не нужно отправлять текст запроса. | No | - | .payload.httpPayload |
Ключзаголовка > запроса > API 1 | Статическое или динамическое поле | Ключ заголовка, заданный в запросе. | No | Статическое или динамическое поле | |
Значениезаголовка > запроса > API 1 | Статическое или динамическое поле | Значение заголовка, заданное в запросе. | No | Статическое или динамическое поле | |
Формат данных ответа > API | строка | Формат текста отклика находится и все детали десериализации. | No | - | JSON |
Путь ответа > API | Путь | Путь к свойству в исходящем сообщении для хранения ответа. Оставьте пустым, если текст ответа не нужен. | No | - | .payload.httpResponse |
Заголовок ответа > API | Путь | Путь к свойству в исходящем сообщении для хранения заголовка ответа. Оставьте пустым, если метаданные ответа не нужны. | No | - | .payload.httpResponseHeader |
Состояние ответа > API | Путь | Путь к свойству в исходящем сообщении для хранения состояния ответа. Оставьте пустым, если не требуется состояние ответа. | No | - | .payload.httpResponseStatus |
1Заголовок запроса > API: каждый элемент в массиве заголовков является парой значений ключа. Ключ или значение можно задать динамически на основе содержимого входящего сообщения или статической строки.
Форматы сообщений
Вы можете использовать этап вызова HTTP с любым форматом данных. Используйте встроенный сериализатор и десериализатор для сериализации и десериализации поддерживаемых форматов данных. Используется Raw
для обработки других форматов данных.
Проверка подлинности
В настоящее время поддерживается только проверка подлинности на основе заголовков.