Partage via

Liaisons de sortie HTTP Azure Functions

  • Article

Utilisez la liaison de sortie HTTP pour répondre à l’expéditeur de la demande HTTP (déclencheur HTTP). Cette liaison nécessite un déclencheur HTTP et vous permet de personnaliser la réponse associée à la requête du déclencheur.

La valeur de retour par défaut pour une fonction déclenchée par HTTP est :

  • HTTP 204 No Content avec un corps vide dans Functions 2.x et versions ultérieures
  • HTTP 200 OK avec un corps vide dans Functions 1.x

Attribut

Un attribut de valeur de retour n’est pas obligatoire lors de l’utilisation de HttpResponseData. Toutefois, lors de l’utilisation d’une intégration ASP.NET Core et d’objets de sortie multi-liaison, l’attribut [HttpResultAttribute] doit être appliqué à la propriété d’objet. L’attribut ne prend aucun paramètre. Pour en savoir plus, consultez Utilisation.

Annotations

Dans la bibliothèque runtime des fonctions Java, utilisez l’annotation HttpOutput pour définir une variable de sortie autre que la variable par défaut retournée par la fonction. L’annotation prend en charge les paramètres suivants :

Important

Cet article utilise des onglets pour prendre en charge plusieurs versions du modèle de programmation Node.js. Le modèle v4 est en disponibilité générale. Il est conçu pour offrir une expérience plus flexible et intuitive aux développeurs JavaScript et TypeScript. Pour plus d’informations sur le fonctionnement du modèle v4, reportez-vous au guide du développeur Azure Functions Node.js. Pour en savoir plus sur les différences entre v3 et v4, consultez le guide de migration.

Configuration

L’objet options passé à la méthode output.http() ne prend actuellement en charge aucune propriété pour le modèle v4.

Configuration

Le tableau suivant décrit les propriétés de configuration de liaison que vous définissez dans le fichier function.json.

Propriété Description
type Cette propriété doit être définie sur http.
direction Cette propriété doit être définie sur out.
name Nom de variable utilisé dans le code de fonction pour la réponse, ou $return pour utiliser la valeur renvoyée.

Utilisation

Pour envoyer une réponse HTTP, utilisez les modèles de réponse standard du langage.

Dans .NET, le type de réponse dépend du mode C# :

La fonction déclenchée PAR HTTP retourne un objet de l’un des types suivants :

  • IActionResult1 (ou Task<IActionResult>)
  • HttpResponse1 (ou Task<HttpResponse>)
  • HttpResponseData (ou Task<HttpResponseData>)
  • Types sérialisables JSON représentant le corps de la réponse pour une 200 OK réponse.

1 Ce type est disponible uniquement lors de l’utilisation de l’intégration ASP.NET Core.

Quand l’un de ces types est utilisé dans le cadre d’objets de sortie multi-liaison, l’attribut [HttpResult] doit être appliqué à la propriété d’objet. L’attribut ne prend aucun paramètre.

Pour Java, utilisez un HttpResponseMessage.Builder pour créer une réponse adressée au déclencheur HTTP. Pour plus d’informations, consultez HttpRequestMessage et HttpResponseMessage.

Par obtenir des exemples de réponse, consultez l’exemple de déclencheur.

Étapes suivantes