Funzioni di Azure associazioni di output HTTP

Usare l'associazione di output HTTP per rispondere al mittente della richiesta HTTP (trigger HTTP). Questa associazione richiede un trigger HTTP e consente di personalizzare la risposta associata alla richiesta del trigger.

Il valore restituito predefinito per una funzione attivata tramite HTTP è:

• HTTP 204 No Content con un corpo vuoto in Funzioni 2.x e versioni successive
• HTTP 200 OK con un corpo vuoto in Funzioni 1.x

Attributo

Modello di lavoro isolato

Un attributo valore restituito non è obbligatorio quando si usa HttpResponseData. Tuttavia, quando si usa un ASP.NET Core integration and multi-binding output objects, l'attributo deve essere applicato alla proprietà dell'oggetto [HttpResultAttribute] . L'attributo non accetta parametri. Per altre informazioni, vedere Utilizzo.

Modello di processo

Importante

Il supporto terminerà per il modello in-process il 10 novembre 2026. È consigliabile eseguire la migrazione delle app al modello di lavoro isolato per il supporto completo.

Un attributo valore restituito non è necessario per una libreria di classi. Lo script C# usa invece un file di configurazione function.json come descritto nella guida per gli script C#. Per altre informazioni, vedere Utilizzo.

Annotazioni

Nella libreria di runtime delle funzioni Java usare l'annotazione HttpOutput per definire una variabile di output diversa dalla variabile predefinita restituita dalla funzione. Questa annotazione supporta le impostazioni seguenti:

• dataType
• name

Importante

Questo articolo usa schede per supportare più versioni del modello di programmazione Node.js. Il modello v4 è disponibile a livello generale ed è progettato per offrire un'esperienza più flessibile e intuitiva per gli sviluppatori JavaScript e TypeScript. Per altre informazioni sul funzionamento del modello v4, vedere la guida per sviluppatori di Funzioni di Azure Node.js. Per altre informazioni sulle differenze tra v3 e v4, vedere la guida alla migrazione.

Impostazione

Modello v4

L'oggetto options passato al output.http() metodo attualmente non supporta alcuna proprietà per il modello v4.

Modello v3

Nella tabella seguente sono illustrate le proprietà di configurazione dell'associazione impostate nel file function.json.

Proprietà	Descrizione
type	Deve essere impostato su http.
direction	Deve essere impostato su out.
name	Nome della variabile usato nel codice della funzione per la risposta, o $returnper usare il valore restituito.

Impostazione

Nella tabella seguente sono illustrate le proprietà di configurazione dell'associazione impostate nel file function.json.

Proprietà	Descrizione
type	Deve essere impostato su http.
direction	Deve essere impostato su out.
name	Nome della variabile usato nel codice della funzione per la risposta, o $returnper usare il valore restituito.

Utilizzo

Per inviare una risposta HTTP, usare modelli di risposta standard del linguaggio.

In .NET il tipo di risposta dipende dalla modalità C#:

Modello di lavoro isolato

La funzione attivata da HTTP restituisce un oggetto di uno dei tipi seguenti:

• IActionResult¹ (o Task<IActionResult>)
• HttpResponse¹ (o Task<HttpResponse>)
• HttpResponseData (o Task<HttpResponseData>)
• Tipi serializzabili JSON che rappresentano il corpo della risposta per una 200 OK risposta.

¹ Questo tipo è disponibile solo quando si usa l'integrazione di ASP.NET Core.

Quando uno di questi tipi viene usato come parte di oggetti di output con più associazioni, l'attributo deve essere applicato alla proprietà dell'oggetto [HttpResult] . L'attributo non accetta parametri.

Modello di processo

La funzione attivata da HTTP restituisce un tipo di IActionResult o Task<IActionResult>.

Per Java, usare un httpResponseMessage.Builder per creare una risposta al trigger HTTP. Per altre informazioni, vedere HttpRequestMessage e HttpResponseMessage.

Per esempi di risposte, vedere gli esempi di trigger.

Passaggi successivi

• Eseguire una funzione da una richiesta HTTP