Концепции триггеров и привязок Azure Functions

2025-06-01

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

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

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

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

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

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

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

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

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

Подсказка

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

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

Функция имеет один триггер и одну или несколько привязок. Тип привязки — входные или выходные данные. Не все службы поддерживают входные и выходные привязки. Ознакомьтесь с конкретным расширением привязки для конкретных примеров кода привязок.

Триггеры и привязки определяются по-разному в зависимости от языка разработки. Выберите язык в верхней части статьи.

Имена триггеров и привязки ограничены буквенно-цифровыми символами и _символами подчеркивания.

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

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

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

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

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

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

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

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

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

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

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

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

Для функций Java триггеры и привязки настраиваются путем аннотирования определенных методов и параметров. Этот триггер HTTP определяется методом @HttpTrigger для функции с именем run, которая записывает в очередь хранилища, определённую аннотацией HttpTriggerQueueOutput параметра @QueueOutput.

@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 для функций:

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

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

Этот пример представляет собой функцию, активированную HTTP, которая создает элемент очереди для каждого полученного HTTP-запроса.

версия 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 для функций:

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

В Python for 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 для функций версии 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".

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

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

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

Тип	1.x¹	2.x и выше²	Триггер	Ввод	Выходные данные
Blob-хранилище	✔	✔	✔	✔	✔
Azure Cosmos DB	✔	✔	✔	✔	✔
Обозреватель данных Azure		✔		✔	✔
Azure SQL		✔	✔	✔	✔
Dapr⁴		✔	✔	✔	✔
Сетка событий	✔	✔	✔		✔
Центры событий	✔	✔	✔		✔
HTTP и вебхуки	✔	✔	✔		✔
Центр IoT	✔	✔	✔
Kafka³		✔	✔		✔
Мобильные приложения	✔			✔	✔
Центры уведомлений	✔				✔
хранилище очередей	✔	✔	✔		✔
Редис		✔	✔	✔	✔
RabbitMQ³		✔	✔		✔
SendGrid	✔	✔			✔
Служебная шина	✔	✔	✔		✔
СигналР		✔	✔	✔	✔
хранилище таблиц	✔	✔		✔	✔
Таймер	✔	✔	✔
Twilio	✔	✔			✔

Примечания:

Поддержка среды выполнения Azure Functions версии 1.x окончится 14 сентября 2026 г. Настоятельно рекомендуется перенести приложения в версию 4.x для полной поддержки.
Начиная с среды выполнения версии 2.x все привязки, кроме ПРОТОКОЛА HTTP и Таймера, должны быть зарегистрированы. См. раздел "Регистрация расширений привязки".
Триггеры не поддерживаются на тарифе «Потребление». Требует триггеров, управляемых во время выполнения.
Поддерживается только в Kubernetes, IoT Edge и других автономных режимах.

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

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

Примеры кода связываний

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

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

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

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Анализатор данных Azure	Входные данные Выходные данные	Ссылка
Azure SQL	Триггер Входные данные Выходные данные	Ссылка
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Анализатор данных Azure	Входные данные Выходные данные	Ссылка
Azure SQL	Триггер Входные данные Выходные данные	Ссылка
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Анализатор данных Azure	Входные данные Выходные данные	Ссылка
Azure SQL	Триггер Входные данные Выходные данные
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Анализатор данных Azure	Входные данные Выходные данные
Azure SQL	Триггер Входные данные Выходные данные	Ссылка
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Azure SQL	Триггер Входные данные Выходные данные
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

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

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

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Анализатор данных Azure	Входные данные Выходные данные
Azure SQL	Триггер Входные данные Выходные данные	Ссылка
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

Услуга	Примеры	Образцы
Хранилище данных типа BLOB	Триггер Входные данные Выходные данные	Ссылка
Azure Cosmos DB (облачная база данных)	Триггер Входные данные Выходные данные	Ссылка
Анализатор данных Azure	Входные данные Выходные данные
Azure SQL	Триггер Входные данные Выходные данные	Ссылка
Сетка событий	Триггер Выходные данные	Ссылка
Центры событий	Триггер Выходные данные
Центр Интернета вещей	Триггер Выходные данные
HTTP	Триггер	Ссылка
Хранение очередей	Триггер Выходные данные	Ссылка
RabbitMQ	Триггер Выходные данные
SendGrid	Выходные данные
Сервис Бус	Триггер Выходные данные	Ссылка
СигналР	Триггер Входные данные Выходные данные
Табличное хранилище данных	Входные данные Выходные данные
Таймер	Триггер	Ссылка
Twilio	Выходные данные	Ссылка

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

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

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

Концепции триггеров и привязок Azure Functions

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

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

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

Примеры кода связываний

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

Связанный контент

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

Дополнительные ресурсы