Conectar funções a serviços do Azure usando associações

Quando você cria uma função, um código de gatilho específico a um idioma é adicionado no projeto de um conjunto de modelos de gatilho. Se você quiser conectar sua função a outros serviços usando associações de entrada ou saída, você precisará adicionar definições de associação específicas em sua função. Para saber mais sobre associações, confira Conceitos de gatilhos e de associações do Azure Functions.

Desenvolvimento local

Ao desenvolver funções localmente, você precisa atualizar o código da função para adicionar associações. Para linguagens que usam function.json, o Visual Studio Code fornece ferramentas para adicionar associações a uma função.

Adicionar associações manualmente com base em exemplos

Ao adicionar uma associação a uma função existente, você precisa adicionar atributos específicos de associação à definição de função no código.

Ao adicionar uma associação a uma função existente, você precisa adicionar anotações específicas de associação à definição de função no código.

Ao adicionar uma associação a uma função existente, você precisa atualizar o código de função e adicionar uma definição ao arquivo de configuração function.json.

Ao adicionar uma associação a uma função existente, você precisa atualizar a definição de função, dependendo do modelo:

v2

Você precisa adicionar anotações específicas de associação à definição de função no código.

v1

Você precisa atualizar o código de função e adicionar uma definição ao arquivo de configuração function.json.

O exemplo a seguir mostra a definição de função depois de adicionar uma associação de saída do Armazenamento de Filas a uma função de gatilho HTTP:

Em processo

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, 
    [Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg, 
    ILogger log)

Processo isolado

Como uma função de gatilho HTTP também retorna uma resposta HTTP, a função retorna um objeto MultiResponse, que representa a saída da fila e HTTP.

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

Veja a seguir a definição do objeto MultiResponse que inclui a associação de saída.

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

A maneira como você define a associação de saída depende do seu modelo de processo. Para obter mais informações, incluindo links para o código de associação de exemplo ao qual você pode se referir, consulte Adicionar associações a uma função.

@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) {

Para obter mais informações, incluindo links para o código de associação de exemplo ao qual você pode se referir, consulte Adicionar associações a uma função.

v3

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

v4

Associação de exemplo para o Node.js v4 (versão prévia) ainda não disponível.

A maneira como você define a associação de saída depende da versão do modelo do Node.js. Para obter mais informações, incluindo links para o código de associação de exemplo ao qual você pode se referir, consulte Adicionar associações a uma função.

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

Para obter mais informações, incluindo links para o código de associação de exemplo ao qual você pode se referir, consulte Adicionar associações a uma função.

v2

@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.')

v1

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

A maneira como você define a associação de saída depende da versão do modelo do Python. Para obter mais informações, incluindo links para o código de associação de exemplo ao qual você pode se referir, consulte Adicionar associações a uma função.

v3

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

v4

Associação de exemplo para o Node.js v4 (versão prévia) ainda não disponível.

A maneira como você define a associação de saída depende da versão do modelo do Node.js. Para obter mais informações, incluindo links para o código de associação de exemplo ao qual você pode se referir, consulte Adicionar associações a uma função.

Use a tabela a seguir para encontrar exemplos de tipos de ligação específicos que você pode usar para orientá-lo na atualização de uma função existente. Primeiro, escolha a guia da linguagem que corresponde ao seu projeto.

O código de associação para C# depende do modelo do processo específico.

Processo isolado

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
Azure Data Explorer	Entrada Saída	Link
SQL do Azure	Gatilho Entrada Saída	Link
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

Em processo

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
Azure Data Explorer	Entrada Saída	Link
SQL do Azure	Gatilho Entrada Saída	Link
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
Azure Data Explorer	Entrada Saída	Link
SQL do Azure	Gatilho Entrada Saída
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
Azure Data Explorer	Entrada Saída
SQL do Azure	Gatilho Entrada Saída	Link
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
SQL do Azure	Gatilho Entrada Saída
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

O código de associação para Python depende da versão do modelo Python.

v2

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
Azure Data Explorer	Entrada Saída
SQL do Azure	Gatilho Entrada Saída	Link
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

v1

Serviço	Exemplos	Exemplos
Armazenamento de blob	Gatilho Entrada Saída	Link
Azure Cosmos DB	Gatilho Entrada Saída	Link
Azure Data Explorer	Entrada Saída
SQL do Azure	Gatilho Entrada Saída	Link
Grade de Eventos	Gatilho Saída	Link
Hubs de Eventos	Gatilho Saída
Hub IoT	Gatilho Saída
HTTP	Gatilho	Link
Armazenamento de filas	Gatilho Saída	Link
RabbitMQ	Gatilho Saída
SendGrid	Saída
Barramento de Serviço	Gatilho Saída	Link
SignalR	Gatilho Entrada Saída
Armazenamento de tabela	Entrada Saída
Temporizador	Gatilho	Link
Twilio	Saída	Link

Visual Studio Code

Quando você usa o Visual Studio Code para desenvolver sua função e sua função usa um arquivo “function.json”, a extensão Azure Functions pode adicionar automaticamente uma associação a um arquivo “function.json” existente. Para saber mais, veja Adicionar associações de entrada e saída.

Portal do Azure

Ao desenvolver as funções no portal do Azure, você adiciona associações de entrada e saída na guia Integrar para uma determinada função. As novas associações são adicionadas ao arquivo “function.json” ou aos atributos do método, dependendo de sua linguagem. Os artigos a seguir mostram exemplos de como adicionar associações a uma função existente no Portal:

• Associação de saída de armazenamento de filas
• Associação de saída do Microsoft Azure Cosmos DB

Próximas etapas

• Conceitos de gatilhos e de associações do Azure Functions