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

Le librerie C# sia in-process che isolate non richiedono un attributo. Lo script C# usa invece un file di configurazione function.json come descritto nella guida per gli script C#.

Un attributo valore restituito non è obbligatorio. 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:

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

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

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.

Il tipo di risposta dipende dalla modalità C#:

La funzione attivata da HTTP restituisce un oggetto HttpResponseData o .Task<HttpResponseData> Se l'app usa l'integrazione di ASP.NET Core in .NET Isolated, può usare anche IActionResult, Task<IActionResult>, HttpResponse o Task<HttpResponse>.

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