Enlaces de salida HTTP de Azure Functions
Use el enlace de salida HTTP para responder al remitente de la solicitud HTTP (desencadenador HTTP). Este enlace requiere un desencadenador HTTP y le permite personalizar la respuesta asociada con la solicitud del desencadenador.
El valor devuelto predeterminado para una función desencadenada por HTTP es:
HTTP 204 No Contentcon el cuerpo vacío en Functions 2.x y posteriorHTTP 200 OKcon el cuerpo vacío en Functions 1.x
Atributo
Las bibliotecas de C# tanto dentro de proceso como de proceso de trabajo aislado no requieren un atributo. En su lugar, el script de C# usa un archivo de configuración function.json como se describe en la Guía de scripting de C#.
No se requiere un atributo de valor devuelto. Para obtener más información, consulte Uso.
anotaciones
En la biblioteca en tiempo de ejecución de funciones de Java, use la anotación HttpOutput para definir una variable de salida que no sea la variable predeterminada devuelta por la función. Esta anotación admite los valores siguientes:
Importante
En este artículo se usan pestañas para admitir varias versiones del modelo de programación de Node.js. El modelo v4 está disponible de forma general y está diseñado para que los desarrolladores de JavaScript y TypeScript tengan una experiencia más flexible e intuitiva. Para más detalles acerca de cómo funciona el modelo v4, consulte la Guía para desarrolladores de Node.js de Azure Functions. Para obtener más información acerca de las diferencias entre v3 y v4, consulte la Guía de migración.
Configuración
Configuración
En la siguiente tabla se explican las propiedades de configuración de enlace que se establecen en el archivo function.json.
| Propiedad | Descripción |
|---|---|
| type | Se debe establecer en http. |
| direction | Se debe establecer en out. |
| name | Nombre de la variable usado en el código de la función para la respuesta, o $return para usar el valor devuelto. |
Uso
Para enviar una respuesta HTTP, use los patrones de respuesta estándar del lenguaje.
El tipo de respuesta depende del modo de C#:
La función desencadenada por HTTP devuelve un objeto HttpResponseData o Task<HttpResponseData>. Si la aplicación usa la integración de ASP.NET Core en .NET Aislado, también podría usar IActionResult, Task<IActionResult>, HttpResponse o Task<HttpResponse>.
Para Java, use HttpResponseMessage.Builder para crear una respuesta al desencadenador HTTP. Para obtener más información, consulte HttpRequestMessage y HttpResponseMessage.
Para ver respuestas de ejemplo, consulte los ejemplos de desencadenador.