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

Les bibliothèques C# In-process et leProcessu Worker isolé ne nécessitent pas d’attribut. Le script C# utilise à la place un fichier de configuration function.json comme décrit dans le guide de script C#.

Aucun attribut de valeur renvoyée n’est requis. 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.

Le type de réponse dépend du mode C# :

La fonction déclenchée par HTTP retourne un objet HttpResponseData ou Task<HttpResponseData>. Si l’application utilise l’intégration ASP.NET Core dans .NET isolé, elle peut également utiliser IActionResult, Task<IActionResult>, HttpResponse ou Task<HttpResponse>.

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