Compartir vía

Llamada a un punto de conexión HTTP desde una canalización del procesador de datos de Azure IoT (versión preliminar)

  • Artículo

Importante

Operaciones de IoT de Azure, habilitado por Azure Arc, está actualmente en VERSIÓN PRELIMINAR. No se debería usar este software en versión preliminar en entornos de producción.

Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

Use la fase de llamada HTTP para llamar a un punto de conexión HTTP externo con un cuerpo de solicitud opcional y recibir una respuesta opcional. La fase de llamada permite incorporar lógica de procesamiento de datos personalizada, como la ejecución de modelos de aprendizaje automático, en el procesamiento de canalizaciones.

  • Cada partición de una canalización ejecuta independientemente las llamadas HTTP en paralelo.
  • Las llamadas HTTP son sincrónicas, la fase espera a que se devuelva la llamada antes de continuar con el procesamiento adicional de la canalización.

Requisitos previos

Para configurar y usar una fase de canalización de agregado, necesita lo siguiente:

  • Una instancia implementada de la versión preliminar del procesador de datos de Azure IoT que incluye el componente opcional del procesador de datos.
  • Un servidor HTTP al que se puede acceder desde la instancia del procesador de datos.

Configuración de una fase de llamada HTTP

La configuración JSON de la fase de llamada HTTP define sus detalles. Para crear la fase, puede interactuar con la interfaz de usuario basada en formularios o proporcionar la configuración JSON en la pestaña Opciones avanzadas:

Nombre Escribir Descripción Necesario Valor predeterminado Ejemplo
Nombre cadena Un nombre para mostrar en la interfaz de usuario del procesador de datos. Sí - MLCall1
Descripción cadena Una descripción sencilla de lo que hace la fase de llamada. No Call ML endpoint 1
Método string enum Método HTTP. No POST GET
Dirección URL cadena Dirección URL HTTP. Sí - http://localhost:8080
Autenticación cadena Tipo de autenticación que se debe usar. None/Username/Password/Header. Sí None None
Nombre de usuario cadena Nombre de usuario que se va a usar cuando Authentication se establece en Username/Password. No - myusername
Secreto cadena La referencia secreta para la contraseña que se va a usar cuando Authentication se establezca en Username/Password. No - mysecret
Clave del encabezado cadena Clave de encabezado que se va a usar cuando Authentication se establezca en Header. El valor tiene que ser authorization. No authorization authorization
Secreto cadena Referencia secreta que se va a usar cuando Authentication se establezca en Header. No - mysecret
Formato de datos > de la solicitud de la API cadena El formato que debe tener el cuerpo de la solicitud debe estar en cualquier detalle de serialización. No - JSON
Ruta de acceso > de la solicitud de la API Path Ruta de acceso a la propiedad del mensaje entrante que se va a enviar como cuerpo de la solicitud. Deje este campo vacío si no necesita enviar un cuerpo de solicitud. No - .payload.httpPayload
> Encabezado > clave1 de la solicitud de la API Campo estático/dinámico Clave de encabezado que se va a establecer en la solicitud. No Campo estático/dinámico
> Encabezado > valor1 de la solicitud de la API Campo estático/dinámico Valor de encabezado que se va a establecer en la solicitud. No Campo estático/dinámico
Formato de datos > de la respuesta de la API cadena El formato en el que se encuentra el cuerpo de la respuesta y los detalles de deserialización. No - JSON
Ruta de acceso > de la respuesta de la API. Path Ruta de acceso a la propiedad del mensaje saliente en el que se va a almacenar la respuesta. Deje este campo vacío si no necesita el cuerpo de la respuesta. No - .payload.httpResponse
Encabezado > de la respuesta de la API Path Ruta de acceso a la propiedad del mensaje saliente en el que se va a almacenar el encabezado de respuesta. Deje este campo vacío si no necesita los metadatos de respuesta. No - .payload.httpResponseHeader
Estado > de la respuesta de la API Path Ruta de acceso a la propiedad del mensaje saliente en el que se va a almacenar el estado de la respuesta. Deje este campo vacío si no necesita el estado de respuesta. No - .payload.httpResponseStatus

1Solicitud de API > encabezado: cada elemento de la matriz del encabezado es un par clave-valor. Puede establecer la clave o el valor dinámicamente en función del contenido del mensaje entrante o como una cadena estática.

Formatos de mensajes

Puede usar la fase de llamada HTTP con cualquier formato de datos. Use el serializador integrado y el deserializador para serializar y deserializar los formatos de datos admitidos. Use Raw para controlar otros formatos de datos.

Autenticación

Actualmente, solo se admite la autenticación basada en encabezados.

Contenido relacionado