Azure Functions에 대 한 Azure Event Grid 바인딩Azure Event Grid bindings for Azure Functions

이 참조는 Azure Functions에서 Event Grid 이벤트를 처리 하는 방법을 설명 합니다.This reference explains how to handle Event Grid events in Azure Functions. HTTP 끝점에서 Event Grid 메시지를 처리 하는 방법에 대 한 자세한 내용은 http 끝점으로 이벤트 수신을 참조 하세요.For details on how to handle Event Grid messages in an HTTP end point, see Receive events to an HTTP endpoint.

Event Grid는 게시자에서 발생하는 이벤트를 알리기 위해 HTTP 요청을 전송하는 Azure 서비스입니다.Event Grid is an Azure service that sends HTTP requests to notify you about events that happen in publishers. 게시자는 이벤트를 시작하는 서비스 또는 리소스입니다.A publisher is the service or resource that originates the event. 예를 들어, Azure Blob Storage 계정은 게시자이고 Blob 업로드 또는 삭제는 이벤트입니다.For example, an Azure blob storage account is a publisher, and a blob upload or deletion is an event. 일부 Azure 서비스에는 Event Grid에 이벤트를 게시하는 방식을 기본적으로 지원합니다.Some Azure services have built-in support for publishing events to Event Grid.

이벤트 처리기는 이벤트를 수신하고 처리합니다.Event handlers receive and process events. Azure Functions는 Event Grid 이벤트를 처리를 기본적으로 지원하는 Azure 서비스 중 하나입니다.Azure Functions is one of several Azure services that have built-in support for handling Event Grid events. 이 참조에서는 Event Grid에서 이벤트를 받을 때 Event Grid 트리거를 사용 하 여 함수를 호출 하 고 출력 바인딩을 사용 하 여 Event Grid 사용자 지정 토픽에 이벤트를 보내는 방법에 대해 알아봅니다.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.

원하는 경우 HTTP 트리거를 사용 하 여 Event Grid 이벤트를 처리할 수 있습니다. HTTP 끝점으로 이벤트 수신을참조 하세요.If you prefer, you can use an HTTP trigger to handle Event Grid Events; see Receive events to an HTTP endpoint. 현재 CloudEvents 스키마에서 이벤트가 전달 될 때 Azure Functions 앱에 대 한 Event Grid 트리거를 사용할 수 없습니다.Currently, you can't use an Event Grid trigger for an Azure Functions app when the event is delivered in the CloudEvents schema. 대신, HTTP 트리거를 사용합니다.Instead, use an HTTP trigger.

작업Action TypeType
Event Grid 이벤트가 디스패치되 면 함수를 실행 합니다.Run a function when an Event Grid event is dispatched 트리거Trigger
Event Grid 이벤트를 보냅니다.Sends an Event Grid event 출력 바인딩Output binding

이 참조의 코드는 버전 2.x 이상에서 사용 되는 .NET Core 구문을 기본값으로 사용 합니다.The code in this reference defaults to .NET Core syntax, used in Functions version 2.x and higher. 1.x 구문에 대한 자세한 내용은 1.x 기능 템플릿을 참조하세요.For information on the 1.x syntax, see the 1.x functions templates.

함수 앱에 추가Add to your Functions app

함수 2.x 이상Functions 2.x and higher

트리거와 바인딩을 사용 하려면 적절 한 패키지를 참조 해야 합니다.Working with the trigger and bindings requires that you reference the appropriate package. NuGet 패키지는 .NET 클래스 라이브러리에 사용 되는 반면 확장 번들은 다른 모든 응용 프로그램 형식에 사용 됩니다.The NuGet package is used for .NET class libraries while the extension bundle is used for all other application types.

언어Language 추가 방법 ...Add by... 설명Remarks
C#C# NuGet 패키지설치, 버전 3(sp3)Installing the NuGet package, version 3.x
C # 스크립트, Java, JavaScript, Python, PowerShellC# Script, Java, JavaScript, Python, PowerShell 확장 번들 등록Registering the extension bundle Azure Tools 확장 은 Visual Studio Code와 함께 사용 하는 것이 좋습니다.The Azure Tools extension is recommended to use with Visual Studio Code.
C # 스크립트 (온라인 전용 Azure Portal)C# Script (online-only in Azure portal) 바인딩 추가Adding a binding 함수 앱을 다시 게시 하지 않고 기존 바인딩 확장을 업데이트 하려면 확장 업데이트를 참조 하세요.To update existing binding extensions without having to republish your function app, see Update your extensions.

Functions 1.xFunctions 1.x

함수 1.x 앱은 WebJobs NuGet 패키지 버전 2.x를 자동으로 참조 합니다.Functions 1.x apps automatically have a reference the Microsoft.Azure.WebJobs NuGet package, version 2.x.

다음 단계Next steps