Utilisation de la valeur de retour Azure Functions

Cet article explique comment fonctionnent les valeurs de retour dans une fonction. Dans les langages qui proposent une valeur renvoyée, vous pouvez lier une liaison de sortie de fonction à la valeur renvoyée.

Définissez la propriété name dans function.json sur $return. S’il existe plusieurs liaisons de sortie, utilisez la valeur de retour pour un seul d’entre eux.

La façon dont les valeurs renvoyées sont utilisées dépend du mode C# que vous utilisez dans votre application de fonction :

Modèle de worker isolé

Pour plus d’informations et des exemples, consultez Liaisons de sortie dans le guide worker .NET.

Modèle in-process

Important

Le support prendra fin pour le modèle in-process le 10 novembre 2026. Nous vous recommandons vivement de migrer vos applications vers le modèle worker isolé pour une prise en charge complète.

Dans une bibliothèque de classes C#, appliquez l’attribut de liaison de sortie à la valeur de retour de la méthode. En C# et dans les scripts C#, les autres méthodes pour envoyer des données à une liaison de sortie sont les paramètres out et les objets collecteurs.

Voici du code C# qui utilise la valeur de retour pour une liaison de sortie, suivie d’un exemple asynchrone :

[FunctionName("QueueTrigger")]
[return: Blob("output-container/{id}")]
public static string Run([QueueTrigger("inputqueue")]WorkItem input, ILogger log)
{
    string json = string.Format("{{ \"id\": \"{0}\" }}", input.Id);
    log.LogInformation($"C# script processed queue message. Item={json}");
    return json;
}

[FunctionName("QueueTrigger")]
[return: Blob("output-container/{id}")]
public static Task<string> Run([QueueTrigger("inputqueue")]WorkItem input, ILogger log)
{
    string json = string.Format("{{ \"id\": \"{0}\" }}", input.Id);
    log.LogInformation($"C# script processed queue message. Item={json}");
    return Task.FromResult(json);
}

Voici la liaison de sortie dans le fichier function.json :

{
    "name": "$return",
    "type": "blob",
    "direction": "out",
    "path": "output-container/{id}"
}

Voici le code JavaScript :

module.exports = function (context, input) {
    var json = JSON.stringify(input);
    context.log('Node.js script processed queue message', json);
    return json;
}

Voici la liaison de sortie dans le fichier function.json :

{
    "name": "Response",
    "type": "blob",
    "direction": "out",
    "path": "output-container/{blobname}"
}

Voici le code PowerShell qui utilise la valeur de retour pour une liaison de sortie http :

Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = $blobname
    })

Voici la liaison de sortie dans le fichier function.json :

{
    "name": "$return",
    "type": "blob",
    "direction": "out",
    "path": "output-container/{id}"
}

Voici le code Python :

def main(input: azure.functions.InputStream) -> str:
    return json.dumps({
        'name': input.name,
        'length': input.length,
        'content': input.read().decode('utf-8')
    })

Appliquez l’annotation de la liaison de sortie à la méthode de la fonction. S’il existe plusieurs liaisons de sortie, utilisez la valeur de retour pour un seul d’entre eux.

Voici du code Java qui utilise la valeur de retour pour une liaison de sortie :

@FunctionName("QueueTrigger")
@StorageAccount("AzureWebJobsStorage")
@BlobOutput(name = "output", path = "output-container/{id}")
public static String run(
  @QueueTrigger(name = "input", queueName = "inputqueue") WorkItem input,
  final ExecutionContext context
) {
  String json = String.format("{ \"id\": \"%s\" }", input.id);
  context.getLogger().info("Java processed queue message. Item=" + json);
  return json;
}

Étapes suivantes

Gérer les erreurs liées aux liaisons Azure Functions