Connessione funzioni ai servizi di Azure tramite associazioni

  • Articolo

Quando si crea una funzione, il codice trigger specifico del linguaggio viene aggiunto nel progetto da un set di modelli di trigger. Se si vuole connettere la funzione ad altri servizi usando associazioni di input o output, è necessario aggiungere definizioni di binding specifiche nella funzione. Per altre informazioni sui binding, vedere Concetti su trigger e binding di Funzioni di Azure.

Sviluppo locale

Quando si sviluppano funzioni in locale, è necessario aggiornare il codice della funzione per aggiungere associazioni. Per i linguaggi che usano function.json, Visual Studio Code fornisce strumenti per aggiungere associazioni a una funzione.

Aggiungere manualmente associazioni basate su esempi

Quando si aggiunge un'associazione a una funzione esistente, è necessario aggiungere attributi specifici dell'associazione alla definizione della funzione nel codice.

Quando si aggiunge un'associazione a una funzione esistente, è necessario aggiungere annotazioni specifiche dell'associazione alla definizione della funzione nel codice.

Quando si aggiunge un'associazione a una funzione esistente, è necessario aggiornare il codice della funzione e aggiungere una definizione al file di configurazione function.json.

Quando si aggiunge un'associazione a una funzione esistente, è necessario aggiornare la definizione della funzione, a seconda del modello:

È necessario aggiungere annotazioni specifiche dell'associazione alla definizione della funzione nel codice.

L'esempio seguente illustra la definizione della funzione dopo l'aggiunta di un'associazione di output queue Archiviazione a una funzione attivata tramite HTTP:

Poiché una funzione attivata da HTTP restituisce anche una risposta HTTP, la funzione restituisce un MultiResponse oggetto , che rappresenta sia l'output HTTP che quello della coda.

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequest req,
    FunctionContext executionContext)
{

Questo esempio è la definizione dell'oggetto che include l'associazione MultiResponse di output:

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public IActionResult HttpResponse { get; set; }
}

Quando si applica tale esempio al proprio progetto, potrebbe essere necessario passare a e a HttpResponseData, a seconda che si usi o meno l'integrazione di ASP.NET IActionResult Core.HttpRequestDataHttpRequest

I messaggi vengono inviati alla coda al termine della funzione. Il modo in cui si definisce l'associazione di output dipende dal modello di processo. Per altre informazioni, inclusi i collegamenti al codice di associazione di esempio a cui è possibile fare riferimento, vedere Aggiungere associazioni a una funzione.

@FunctionName("HttpExample")
public HttpResponseMessage run(
        @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) 
        HttpRequestMessage<Optional<String>> request, 
        @QueueOutput(name = "msg", queueName = "outqueue", 
        connection = "AzureWebJobsStorage") OutputBinding<String> msg, 
        final ExecutionContext context) {

Per altre informazioni, inclusi i collegamenti al codice di associazione di esempio a cui è possibile fare riferimento, vedere Aggiungere associazioni a una funzione.

Associazione di esempio per Node.js modello v4 non ancora disponibile.

Il modo in cui si definisce l'associazione di output dipende dalla versione del modello di Node.js. Per altre informazioni, inclusi i collegamenti al codice di associazione di esempio a cui è possibile fare riferimento, vedere Aggiungere associazioni a una funzione.

$outputMsg = $name
Push-OutputBinding -name msg -Value $outputMsg

Per altre informazioni, inclusi i collegamenti al codice di associazione di esempio a cui è possibile fare riferimento, vedere Aggiungere associazioni a una funzione.

@app.route(route="HttpExample")
@app.queue_output(arg_name="msg", queue_name="outqueue", connection="AzureWebJobsStorage")
def HttpExample(req: func.HttpRequest, msg: func.Out [func.QueueMessage]) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

Il modo in cui si definisce l'associazione di output dipende dalla versione del modello Python. Per altre informazioni, inclusi i collegamenti al codice di associazione di esempio a cui è possibile fare riferimento, vedere Aggiungere associazioni a una funzione.

Associazione di esempio per Node.js modello v4 non ancora disponibile.

Il modo in cui si definisce l'associazione di output dipende dalla versione del modello di Node.js. Per altre informazioni, inclusi i collegamenti al codice di associazione di esempio a cui è possibile fare riferimento, vedere Aggiungere associazioni a una funzione.

Usare la tabella seguente per trovare esempi di tipi di associazione specifici che è possibile usare per guidare l'aggiornamento di una funzione esistente. Scegliere prima di tutto la scheda della lingua corrispondente al progetto.

Il codice di associazione per C# dipende dal modello di processo specifico.

Servizio Esempi Esempi
Archiviazione BLOB Trigger
Input
Output		 Collegamento
Azure Cosmos DB Trigger
Input
Output		 Collegamento
Esplora dati di Azure Input
Output		 Collegamento
Azure SQL Trigger
Input
Output		 Collegamento
Griglia di eventi Trigger
Output		 Collegamento
Hub eventi Trigger
Output
Hub IoT Trigger
Output
HTTP Trigger Collegamento
Archiviazione code Trigger
Output		 Collegamento
RabbitMQ Trigger
Output
SendGrid Output
Bus di servizio Trigger
Output		 Collegamento
SignalR Trigger
Input
Output
Archiviazione tabelle Input
Output
Timer Trigger Collegamento
Twilio Output Collegamento
Servizio Esempi Esempi
Archiviazione BLOB Trigger
Input
Output		 Collegamento
Azure Cosmos DB Trigger
Input
Output		 Collegamento
Esplora dati di Azure Input
Output		 Collegamento
Azure SQL Trigger
Input
Output
Griglia di eventi Trigger
Output		 Collegamento
Hub eventi Trigger
Output
Hub IoT Trigger
Output
HTTP Trigger Collegamento
Archiviazione code Trigger
Output		 Collegamento
RabbitMQ Trigger
Output
SendGrid Output
Bus di servizio Trigger
Output		 Collegamento
SignalR Trigger
Input
Output
Archiviazione tabelle Input
Output
Timer Trigger Collegamento
Twilio Output Collegamento
Servizio Esempi Esempi
Archiviazione BLOB Trigger
Input
Output		 Collegamento
Azure Cosmos DB Trigger
Input
Output		 Collegamento
Esplora dati di Azure Input
Output
Azure SQL Trigger
Input
Output		 Collegamento
Griglia di eventi Trigger
Output		 Collegamento
Hub eventi Trigger
Output
Hub IoT Trigger
Output
HTTP Trigger Collegamento
Archiviazione code Trigger
Output		 Collegamento
RabbitMQ Trigger
Output
SendGrid Output
Bus di servizio Trigger
Output		 Collegamento
SignalR Trigger
Input
Output
Archiviazione tabelle Input
Output
Timer Trigger Collegamento
Twilio Output Collegamento
Servizio Esempi Esempi
Archiviazione BLOB Trigger
Input
Output		 Collegamento
Azure Cosmos DB Trigger
Input
Output		 Collegamento
Azure SQL Trigger
Input
Output
Griglia di eventi Trigger
Output		 Collegamento
Hub eventi Trigger
Output
Hub IoT Trigger
Output
HTTP Trigger Collegamento
Archiviazione code Trigger
Output		 Collegamento
RabbitMQ Trigger
Output
SendGrid Output
Bus di servizio Trigger
Output		 Collegamento
SignalR Trigger
Input
Output
Archiviazione tabelle Input
Output
Timer Trigger Collegamento
Twilio Output Collegamento

Il codice di associazione per Python dipende dalla versione del modello Python.

Servizio Esempi Esempi
Archiviazione BLOB Trigger
Input
Output		 Collegamento
Azure Cosmos DB Trigger
Input
Output		 Collegamento
Esplora dati di Azure Input
Output
Azure SQL Trigger
Input
Output		 Collegamento
Griglia di eventi Trigger
Output		 Collegamento
Hub eventi Trigger
Output
Hub IoT Trigger
Output
HTTP Trigger Collegamento
Archiviazione code Trigger
Output		 Collegamento
RabbitMQ Trigger
Output
SendGrid Output
Bus di servizio Trigger
Output		 Collegamento
SignalR Trigger
Input
Output
Archiviazione tabelle Input
Output
Timer Trigger Collegamento
Twilio Output Collegamento

Visual Studio Code

Quando si usa Visual Studio Code per sviluppare la funzione e la funzione usa un file function.json, l'estensione Funzioni di Azure può aggiungere automaticamente un'associazione a un file di function.json esistente. Per altre informazioni, vedere Aggiungere associazioni di input e output.

Azure portal

Quando si sviluppano le funzioni nella portale di Azure, si aggiungono associazioni di input e output nella scheda Integrazione per una determinata funzione. Le nuove associazioni vengono aggiunte al file function.json o agli attributi del metodo, a seconda della lingua. Gli articoli seguenti illustrano esempi di come aggiungere associazioni a una funzione esistente nel portale:

Passaggi successivi