триггеры и привязки Azure Functions

В этой статье вы узнаете о высокоуровневых понятиях, связанных с триггерами и привязками для функций.

Триггеры вызывают запуск функции. Триггер определяет, как вызывается функция, и функция должна иметь ровно один триггер. Триггеры также могут передавать данные в вашу функцию, аналогично вызовам методов.

Привязка к функции — это способ декларативного подключения функций к другим ресурсам. Привязки либо передают данные в функцию ( входную привязку), либо позволяют записывать данные из функции ( выходная привязка) с помощью параметров привязки. Триггер функции по сути является особым типом входной привязки.

Вы можете комбинировать привязки для достижения оптимального результата в конкретном сценарии функции. Привязки являются необязательными, а функция может иметь одну или несколько входных и/или выходных привязок.

Триггеры и привязки позволяют избежать жестко запрограммированного доступа к другим службам. Функция получает данные (например, содержимое сообщения из очереди) в параметрах функции. Вы отправляете данные (например, для создания сообщения в очереди) с помощью возвращаемого значения функции.

Рассмотрим следующие примеры реализации функций:

Пример сценария	Триггер	Входные привязки	Выходные привязки
В очередь поступает новое сообщение, которое запускает функцию для записи в другую очередь.	Очередь^*	Нет	Очередь^*
Запланированное задание считывает содержимое Azure Blob Storage и создает новый документ Azure Cosmos DB.	Таймер	Blob-хранилище (Blob Storage)	Azure Cosmos DB
Azure Event Grid используется для чтения изображения из Blob Storage и документа из Azure Cosmos DB для отправки сообщения электронной почты.	Сетка событий	Blob Storage и Azure Cosmos DB	SendGrid

^* Представляет разные очереди.

Эти примеры не должны быть исчерпывающими, но они показывают, как можно использовать триггеры и привязки вместе. Чтобы увидеть более полный набор сценариев, см. сценарии Azure Functions.

Подсказка

Azure Functions не требует использования входных и выходных привязок для подключения к службам Azure. Вы всегда можете создать в коде Azure SDK клиента и использовать его для передачи данных. Дополнительные сведения см. в разделе "Подключение к службам".

Определения триггеров и привязок

В следующем примере показана функция с триггером HTTP с выходной привязкой, которая записывает сообщение в очередь Azure Storage.

Для функций библиотеки классов C# можно настроить триггеры и привязки путем декорирования методов и параметров атрибутами C#. Конкретный атрибут, который вы применяете, может зависеть от модели среды выполнения C#:

Изолированная рабочая модель
Модель внутрипроцессного процесса

Триггер HTTP (HttpTrigger) определен в методе Run для функции с именем HttpExample , возвращающей MultiResponse объект:

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

В этом примере показано MultiResponse определение объекта. Определение объекта возвращает HttpResponse в HTTP-запросе и записывает сообщение в очередь хранилища с помощью привязки QueueOutput.

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

Дополнительные сведения см. в руководстве по C# для изолированных рабочих моделей.

Триггер HTTP (HttpTrigger) определен в методе Run для функции с именем HttpExample. Эта функция записывает в очередь хранилища, которую определяют атрибуты Queue и StorageAccount на параметре msg.

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

Дополнительные сведения см. в руководстве по C# для моделей в процессе.

Устаревшие функции скрипта C# используют function.json файл определения. Дополнительные сведения см. в справочнике разработчика Azure Functions скриптов на C# (.csx).

Для функций Java можно настроить триггеры и привязки путем аннотирования определенных методов и параметров. HTTP-триггер @HttpTrigger определяется на методе run для функции с именем HttpExample. Функция записывает в очередь хранилища с именем outqueue, которая определяется аннотацией @QueueOutput на параметре msg:

@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) {
    context.getLogger().info("Java HTTP trigger processed a request.");

Дополнительные сведения см. в руководстве разработчика Java.

Способ определения триггеров и привязок для функций Node.js зависит от конкретной версии Node.js для Azure Functions:

версия 4
версия 3

В Node.js для Azure Functions версии 4 можно настроить триггеры и привязки с помощью объектов, экспортированных из модуля @azure/functions. Дополнительные сведения см. в руководстве разработчика поNode.js.

версия 4
версия 3

Метод http экспортированного app объекта определяет триггер HTTP. Метод storageQueue определяет выходную привязку на этом триггере в output.

const { app, output } = require('@azure/functions');

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: async (request, context) => {
        const body = await request.text();
        context.extraOutputs.set(queueOutput, body);
        return { body: 'Created queue item.' };
    },
});

Этот пример function.json файла определяет функцию триггера HTTP, которая возвращает ответ HTTP и записывает в очередь хранилища:

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

версия 4
версия 3

import { app, HttpRequest, HttpResponseInit, InvocationContext, output } from '@azure/functions';

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

export async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    const body = await request.text();
    context.extraOutputs.set(queueOutput, body);
    return { body: 'Created queue item.' };
}

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: httpTrigger1,
});

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

Этот пример function.json файла определяет функцию:

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

Дополнительные сведения см. в руководстве разработчика PowerShell.

Способ определения функции зависит от версии Python для Azure Functions:

версия 2
версия 1

В Python для Azure Functions версии 2 вы определяете функцию непосредственно в коде с помощью декораторов:

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)

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

В Python для Azure Functions версии 1 в этом примере файл function.json определяет функцию триггера HTTP, которая возвращает http-ответ и записывает в очередь хранилища:

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

Задача добавления привязок в функцию

Функцию можно подключить к другим службам с помощью входных или выходных привязок. Добавьте привязку, добавив в функцию определенные определения. Дополнительные сведения см. в статье Добавление привязок к существующей функции в Azure Functions.

Azure Functions поддерживает несколько привязок, которые должны быть настроены правильно. Например, функция может считывать данные из очереди (входная привязка) и записывать данные в базу данных (выходную привязку).

Поддерживаемые привязки

В этой таблице показаны привязки, поддерживаемые в основных версиях среды выполнения Azure Functions:

Тип	4.x¹	1.x²	Триггер	Ввод	Выходные данные
Blob Storage	✔	✔	✔	✔	✔
Azure Cosmos DB	✔	✔	✔	✔	✔
Azure Data Explorer	✔			✔	✔
Azure SQL	✔		✔	✔	✔
Dapr⁴	✔		✔	✔	✔
Сетка событий	✔	✔	✔		✔
Центры событий	✔	✔	✔		✔
HTTP и веб-перехватчики	✔	✔	✔		✔
IoT Hub	✔	✔	✔
Kafka³	✔		✔		✔
Мобильные приложения		✔		✔	✔
Протокол контекста модели	✔		✔
Центры уведомлений		✔		✔
Хранилище очередей	✔	✔	✔		✔
Редис	✔		✔	✔	✔
RabbitMQ³	✔		✔		✔
SendGrid	✔	✔			✔
Service Bus	✔	✔	✔		✔
Azure SignalR Service	✔		✔	✔	✔
Хранилище таблиц	✔	✔		✔	✔
Таймер	✔	✔	✔
Twilio	✔	✔			✔

Зарегистрируйте все привязки, кроме HTTP и таймера. См. раздел Регистрация расширений привязки Azure Functions. Этот шаг не требуется при использовании среды выполнения Функций версии 1.x.
Support заканчивается для версии 1.x среды выполнения Azure Functions 14 сентября 2026. Перенос приложений в версию 4.x для полной поддержки.
Триггеры не поддерживаются в тарифном плане Consumption. Для этого типа привязки требуются триггеры, управляемые средой выполнения.
Этот тип привязки поддерживается только в Kubernetes, Azure IoT Edge и других автономных режимах.

Сведения о том, какие привязки находятся в предварительной версии или утверждены для использования в рабочей среде, см. поддерживаемые языки.

Определенные версии расширений привязки поддерживаются только в то время как поддерживается базовый пакет SDK службы. Изменения в поддержке в базовой версии пакета SDK службы влияют на поддержку используемого расширения.

Типы пакетов SDK

Расширения привязки для Azure Functions используют SDK для Azure для подключения к службам. Определенные типы пакетов SDK, используемые привязками, могут повлиять на работу с данными в функциях. Некоторые привязки поддерживают типы пакета SDK, обеспечивающие более широкие функциональные возможности и лучшую интеграцию со службой, а другие используют более универсальные типы, такие как строки или массивы байтов. Если они доступны, использование типов, специфичных для SDK, может обеспечить такие преимущества, как лучшая безопасность типов, более простая обработка данных и доступ к функциям, специфичным для службы.

В этой таблице указаны расширения привязки, которые в настоящее время поддерживают типы пакетов SDK:

Extension	Типы	Уровень поддержки
Azure Blob Storage	`BlobClient` `BlobContainerClient` `BlockBlobClient` `PageBlobClient` `AppendBlobClient`	Триггер: GA Входные данные: GA (общедоступная версия)
Azure Cosmos DB	`CosmosClient` `Database` `Container`	Входные данные: GA (общедоступная версия)
Azure Event Grid	`CloudEvent` `EventGridEvent`	Триггер: GA
Azure Event Hubs	`EventData` `EventHubProducerClient`	Триггер: GA
Azure Queue Storage	`QueueClient` `QueueMessage`	Триггер: GA
Azure Service Bus	`ServiceBusClient` `ServiceBusReceiver` `ServiceBusSender` `ServiceBusMessage`	Триггер: GA
Azure Table Storage	`TableClient` `TableEntity`	Входные данные: GA (общедоступная версия)

Рекомендации по типам пакета SDK:

При использовании выражений привязки, использующих данные триггера , нельзя использовать типы пакетов SDK для самого триггера.
В сценариях вывода, в которых можно использовать тип SDK, создайте и работайте с клиентами SDK напрямую, а не с помощью выходной привязки.
Триггер Azure Cosmos DB использует канал изменений Azure Cosmos DB и предоставляет элементы канала изменений в виде типов, сериализуемых в формате JSON. В результате типы SDK не поддерживаются этим триггером.

Дополнительные сведения см. в руководстве разработчика по пакетам SDK для C#.

Extension	Типы	Уровень поддержки	Образцы
Azure Blob Storage	`BlobClient` `ContainerClient` `StorageStreamDownloader`	Триггер: GA Входные данные: GA (общедоступная версия)	Quickstart `BlobClient` `ContainerClient` `StorageStreamDownloader`
Azure Cosmos DB	`CosmosClient` `DatabaseProxy` `ContainerProxy`	Ввод: предварительный просмотр	Quickstart `ContainerProxy` `CosmosClient` `DatabaseProxy`
Azure Event Hubs	`EventData`	Триггер: предварительная версия	Quickstart `EventData`
Azure Service Bus	`ServiceBusReceivedMessage`	Триггер: предварительная версия	Quickstart `ServiceBusReceivedMessage`

Рекомендации по типам пакета SDK:

В сценариях вывода, в которых можно использовать тип SDK, создайте и работайте с клиентами SDK напрямую, а не с помощью выходной привязки.
Триггер Azure Cosmos DB использует канал изменений Azure Cosmos DB и предоставляет элементы канала изменений в виде типов, сериализуемых в формате JSON. В результате типы SDK не поддерживаются этим триггером.

Типы SDK поддерживаются только при использовании модели программирования Python версии 2. Дополнительные сведения см. в разделе SDK type bindings в руководстве разработчика Python.

Extension	Типы	Уровень поддержки
Azure Blob Storage	`BlobClient` `ContainerClient` `ReadableStream`	Preview
Azure Service Bus	`ServiceBusClient` `ServiceBusReceiver` `ServiceBusSender` `ServiceBusMessage`	Preview

Типы SDK поддерживаются только при использовании модели программирования Node версии 4. Дополнительные сведения см. в руководстве разработчика по пакету SDK Node.js.

Extension	Типы	Уровень поддержки
Azure Blob Storage	`BlobClient` `BlobContainerClient`	Preview

Дополнительные сведения см. в разделе типы SDK в руководстве разработчика Java.

Это важно

Типы пакетов SDK в настоящее время не поддерживаются для приложений PowerShell.

Примеры кода для привязок

В следующей таблице приведены дополнительные примеры конкретных типов привязки, которые показывают, как работать с привязками в функциях. Сначала выберите вкладку языка, соответствующую проекту.

Код привязки для C# зависит от конкретной модели процесса.

Изолированный процесс
В процессе

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer	Входные данные Выходные данные	Link
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные	Link
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные	Link
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger	Link
Twilio	Выходные данные	Link

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer	Входные данные Выходные данные	Link
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные	Link
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные	Link
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger	Link
Twilio	Выходные данные	Link

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer	Входные данные Выходные данные	Link
Azure SQL	Trigger Входные данные Выходные данные
Сетка событий	Trigger Выходные данные	Link
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные	Link
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger	Link
Twilio	Выходные данные

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer	Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные	Link
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные
Azure Cosmos DB	Trigger Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Код привязки для Python зависит от версии модели Python.

версия 2
версия 1

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer	Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные	Link
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Услуга	Примеры	Образцы
Blob-хранилище (Blob Storage)	Trigger Входные данные Выходные данные
Azure Cosmos DB	Trigger Входные данные Выходные данные
Azure Data Explorer	Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
IoT Hub	Trigger Выходные данные
HTTP	Trigger
Хранилище очередей	Trigger Выходные данные
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
Service Bus	Trigger Выходные данные
Azure SignalR Service	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Пользовательские привязки

Вы можете создавать пользовательские входные и выходные привязки. Привязки должны создаваться в .NET, но их можно использовать на любом поддерживаемом языке. Дополнительные сведения о создании пользовательских привязок см. в разделе Создание пользовательских входных и выходных привязок.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-11

Поделиться через