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 Content con el cuerpo vacío en Functions 2.x y posterior
• HTTP 200 OK con el cuerpo vacío en Functions 1.x

Attribute

Modelo de trabajo aislado

No se requiere un atributo de valor devuelto al usar HttpResponseData. Sin embargo, cuando se usa una integración de ASP.NET Core y objetos de salida de varios enlaces, el [HttpResultAttribute] atributo debe aplicarse a la propiedad de objeto. El atributo no toma parámetros. Para obtener más información, consulte Uso.

Modelo de proceso

Importante

El soporte técnico del modelo en proceso finalizará el 10 de noviembre de 2026. Se recomienda encarecidamente migrar las aplicaciones al modelo de trabajo aislado para obtener soporte técnico completo.

No se requiere un atributo de valor devuelto para una biblioteca de clases. 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#. 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:

• dataType
• name

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

Model v4

El objeto options pasado al método output.http() actualmente no admite ninguna propiedad para el modelo v4.

Model v3

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.

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.

En .NET, el tipo de respuesta depende del modo de C#:

Modelo de trabajo aislado

La función desencadenada por HTTP devuelve un objeto de uno de los siguientes tipos:

• IActionResult¹ (o Task<IActionResult>)
• HttpResponse¹ (o Task<HttpResponse>)
• HttpResponseData (o Task<HttpResponseData>)
• Tipos serializables JSON que representan el cuerpo de la respuesta de una 200 OK respuesta.

¹ Este tipo solo está disponible cuando se usa la integración de ASP.NET Core.

Cuando uno de estos tipos se usa como parte de objetos de salida de varios enlaces, el [HttpResult] atributo se debe aplicar a la propiedad de objeto. El atributo no toma parámetros.

Modelo de proceso

La función desencadenada por HTTP devuelve un tipo de IActionResult o Task<IActionResult>.

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.

Pasos siguientes

• Ejecución de una función desde una solicitud HTTP