Ligações da Grelha de Eventos Azure para funções azureAzure Event Grid bindings for Azure Functions

Esta referência explica como lidar com eventos da Grelha de Eventos em Funções Azure.This reference explains how to handle Event Grid events in Azure Functions. Para mais detalhes sobre como lidar com as mensagens da Grelha de Eventos num ponto final http, consulte Receber eventos num ponto final http.For details on how to handle Event Grid messages in an HTTP end point, see Receive events to an HTTP endpoint.

Event Grid é um serviço Azure que envia pedidos http para notificá-lo sobre eventos que acontecem em editores.Event Grid is an Azure service that sends HTTP requests to notify you about events that happen in publishers. Uma editora é o serviço ou recurso que origina o evento.A publisher is the service or resource that originates the event. Por exemplo, uma conta de armazenamento de blob Azure é uma editora, e um upload ou eliminação blob é um evento.For example, an Azure blob storage account is a publisher, and a blob upload or deletion is an event. Alguns serviços azure têm apoio integrado para a publicação de eventos à Event Grid.Some Azure services have built-in support for publishing events to Event Grid.

Os manipuladores de eventos recebem e processam eventos.Event handlers receive and process events. A Azure Functions é um dos vários serviços Azure que têm suporte integrado para lidar com eventos da Rede de Eventos.Azure Functions is one of several Azure services that have built-in support for handling Event Grid events. Nesta referência, você aprende a usar um gatilho de Grelha de Eventos para invocar uma função quando um evento é recebido da Grelha de Eventos, e usar a ligação de saída para enviar eventos para um tópico personalizado da Grelha de Eventos.In this reference, you learn to use an Event Grid trigger to invoke a function when an event is received from Event Grid, and to use the output binding to send events to an Event Grid custom topic.

Se preferir, pode utilizar um gatilho HTTP para lidar com eventos da Grelha de Eventos; ver Receber eventos para um ponto final HTTP.If you prefer, you can use an HTTP trigger to handle Event Grid Events; see Receive events to an HTTP endpoint. Atualmente, não é possível utilizar um gatilho da Grelha de Eventos para uma aplicação De Funções Azure quando o evento é entregue no esquema CloudEvents.Currently, you can't use an Event Grid trigger for an Azure Functions app when the event is delivered in the CloudEvents schema. Em vez disso, utilize um gatilho HTTP.Instead, use an HTTP trigger.

AçãoAction TipoType
Executar uma função quando um evento da Grelha de Eventos é despachadoRun a function when an Event Grid event is dispatched AcionadorTrigger
Envia um evento de Grelha de EventosSends an Event Grid event Encadernação de saídaOutput binding

O código nesta referência não se aplica à sintaxe .NET Core, utilizada na versão 2.x e superior das Funções.The code in this reference defaults to .NET Core syntax, used in Functions version 2.x and higher. Para obter informações sobre a sintaxe 1.x, consulte os modelos de funções 1.x.For information on the 1.x syntax, see the 1.x functions templates.

Adicione à sua app FunçõesAdd to your Functions app

Funções 2.x e superiorFunctions 2.x and higher

Trabalhar com o gatilho e encadernações requer que consulte o pacote apropriado.Working with the trigger and bindings requires that you reference the appropriate package. O pacote NuGet é utilizado para bibliotecas de classe .NET enquanto o pacote de extensão é usado para todos os outros tipos de aplicações.The NuGet package is used for .NET class libraries while the extension bundle is used for all other application types.

IdiomaLanguage Adicione por...Add by... ObservaçõesRemarks
C#C# Instalação do pacote NuGet, versão 3.xInstalling the NuGet package, version 3.x
C# Script, Java, JavaScript, Python, PowerShellC# Script, Java, JavaScript, Python, PowerShell Registando o pacote de extensãoRegistering the extension bundle Recomenda-se a extensão Azure Tools para utilizar com o Código do Estúdio Visual.The Azure Tools extension is recommended to use with Visual Studio Code.
C# Script (apenas online no portal Azure)C# Script (online-only in Azure portal) Adicionar uma ligaçãoAdding a binding Para atualizar as extensões de ligação existentes sem ter de voltar a publicar a sua aplicação de funções, consulte [atualizar as suas extensões].To update existing binding extensions without having to republish your function app, see Update your extensions.

Funções 1.xFunctions 1.x

As funções 1.x apps têm automaticamente uma referência ao pacote Microsoft.Azure.WebJobs NuGet, versão 2.x.Functions 1.x apps automatically have a reference the Microsoft.Azure.WebJobs NuGet package, version 2.x.

Passos seguintesNext steps