Руководство разработчиков Функций Azure

Статья
06/26/2024

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

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

Если вы предпочитаете перейти вправо, вы можете выполнить краткое руководство по работе с помощью Visual Studio, Visual Studio Code или из командной строки.

Если вы предпочитаете перейти вправо, вы можете выполнить краткое руководство по началу работы с помощью Maven (командной строки), Eclipse, IntelliJ IDEA, Gradle, Quarkus , Spring Cloud или Visual Studio Code.

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

Проект кода

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

Способ размещения проекта кода и способ указания методов в проекте зависит от языка разработки проекта. Подробные рекомендации по языку см. в руководстве разработчиков C#.

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

Способ размещения проекта кода и способ указания методов в проекте зависит от языка разработки проекта. Инструкции по языку см. в руководстве разработчиков Node.js.

Способ размещения проекта кода и способ указания методов в проекте зависит от языка разработки проекта. Инструкции по языку см. в руководстве разработчиков PowerShell.

Способ размещения проекта кода и способ указания методов в проекте зависит от языка разработки проекта. Инструкции для конкретных языков см. в руководстве разработчиков Python.

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

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

Средства разработки

Следующие средства предоставляют интегрированный интерфейс разработки и публикации для Функции Azure на предпочитаемом языке:

Visual Studio

Visual Studio Code
Функции Azure Core Tools (командная строка)

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

В портал Azure также есть редактор, который позволяет обновлять код и файл определения function.json непосредственно на портале. Этот редактор следует использовать только для небольших изменений или создания функций проверки концепции. Вы всегда должны разрабатывать свои функции локально, когда это возможно. Дополнительные сведения см. в статье Создание первой функции на портале Azure.

Редактирование портала поддерживается только для Node.js версии 3, которая использует файл function.json.

Развертывание

При публикации проекта кода в Azure вы фактически развертываете проект в существующем ресурсе приложения-функции. Приложение-функция предоставляет контекст выполнения в Azure, в котором выполняются функции. Таким образом, это единица развертывания и управления для ваших функций. С точки зрения ресурсов Azure приложение-функция эквивалентно ресурсу сайта (Microsoft.Web/sites) в службе приложение Azure, что эквивалентно веб-приложению.

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

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

Во время публикации Visual Studio

Использование Visual Studio Code
Программное использование Azure CLI, Azure PowerShell, шаблонов ARM или шаблонов Bicep
На портале Azure:

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

Подключение к службам

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

Независимо от того, используете ли вы расширения привязки, предоставляемые Функциями, или работаете с клиентскими пакетами SDK напрямую, вы безопасно храните данные подключения и не включаете его в код. Дополнительные сведения см. в разделе Соединения.

Привязки

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

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

Если у вас возникли проблемы с ошибками, поступающими из привязок, ознакомьтесь с документацией по Функции Azure кодов ошибок привязки.

Клиентские пакеты SDK

Хотя Функции предоставляют привязки для упрощения доступа к данным в коде функции, вы по-прежнему можете использовать клиентский пакет SDK в проекте для прямого доступа к данной службе, если вы предпочитаете. Возможно, вам потребуется использовать клиентские пакеты SDK напрямую, если для функций требуется функциональность базового пакета SDK, который не поддерживается расширением привязки.

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

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

Связи

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

Например, рассмотрим определение триггера connection , которое имеет свойство. Вместо строка подключения задается connection имя переменной среды, содержащей строка подключения. Использование этой стратегии доступа к секретам делает приложения более безопасными и упрощает изменение подключений между средами. Для еще большей безопасности можно использовать подключения на основе удостоверений.

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

Значения подключений

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

Однако имя подключения также может ссылаться на коллекцию нескольких элементов конфигурации. Это удобно при настройке подключений на основе удостоверений. Переменные среды можно представить как коллекцию с помощью общего префикса, заканчивающегося двойными символами подчеркивания __. На эту группу можно ссылаться, задав имя подключения для этого префикса.

Например, connection свойство для определения триггера BLOB-объектов Azure может быть Storage1. Если ни одно строковое значение, настроенное переменной среды с именемStorage1, то для информирования blobServiceUri свойства подключения можно использовать переменную Storage1__blobServiceUri среды. Свойства подключения у всех служб различны. Сведения о компоненте, использующем подключение, см. в документации.

Примечание.

При использовании Конфигурации приложений Azure или Key Vault для предоставления параметров подключений Управляемого удостоверения имена параметров должны использовать допустимый разделитель ключей, например : или /, вместо __, чтобы обеспечить правильное разрешение имен.

Например, Storage1:blobServiceUri.

Настройка подключения на основе удостоверений

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

Примечание.

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

Подключения на основе удостоверений поддерживаются только в Функциях 4.x, если вы используете версию 1.x, сначала необходимо перенести на версию 4.x.

Следующие компоненты поддерживают подключения на основе удостоверений:

Источник подключения	Поддерживаемые планы	Подробнее
Триггеры и привязки BLOB-объектов Azure	Все	Расширение blob-объектов Azure версии 5.0.0 или более поздней версии Пакет расширений 3.3.0 или более поздней версии
Триггеры и привязки очередей Azure	Все	Расширение очередей Azure версии 5.0.0 или более поздней версии Пакет расширений 3.3.0 или более поздней версии
Таблицы Azure (при использовании служба хранилища Azure)	Все	Расширение таблиц Azure версии 1.0.0 или более поздней версии Пакет расширений 3.3.0 или более поздней версии
База данных SQL Azure	Все	Подключение приложения-функции к SQL Azure с помощью управляемых удостоверений и привязок SQL
Триггеры и привязки центров событий Azure	Все	Центры событий Azure расширения версии 5.0.0 или более поздней, Пакет расширений 3.3.0 или более поздней версии
Триггеры и привязки служебной шины Azure	Все	Служебная шина Azure расширения версии 5.0.0 или более поздней версии, Пакет расширений 3.3.0 или более поздней версии
Выходная привязка Сетки событий Azure	Все	Сетка событий Azure расширения версии 3.3.0 или более поздней версии Пакет расширений 3.3.0 или более поздней версии
Триггеры и привязки Azure Cosmos DB	Все	Расширение Azure Cosmos DB версии 4.0.0 или более поздней версии Пакет расширений 4.0.2 или более поздней версии
Триггеры и привязки Azure SignalR	Все	Расширение Azure SignalR версии 1.7.0 или более поздней Пакет расширений 3.6.1 или более поздней версии
поставщик хранилища Устойчивые функции (служба хранилища Azure)	Все	Устойчивые функции расширения версии 2.7.0 или более поздней версии. Пакет расширений 3.3.0 или более поздней версии
Хранилище, требуемое для узла ("AzureWebJobsStorage")	Все	Подключение к хранилищу узлов с помощью удостоверения

При размещении в службе "Функции Azure" для подключений на основе удостоверений используется управляемое удостоверение. По умолчанию используется назначаемое системой удостоверение, однако вы можете указать назначаемое пользователем удостоверение с помощью свойств credential и clientID. Обратите внимание, что настройка назначаемого пользователем удостоверения с идентификатором ресурса не поддерживается. При выполнении в других контекстах, например при локальной разработке, вместо этого используется удостоверение разработчика, хотя это можно настроить. См. раздел Локальная разработка с использованием подключений на основе удостоверений.

Предоставление разрешения удостоверению

Любое используемое удостоверение должно иметь разрешения на выполнение предполагаемых действий. Для большинства служб Azure это означает, что необходимо назначить роль в Azure RBAC, используя встроенные или настраиваемые роли, которые предоставляют эти разрешения.

Внимание

Иногда целевая служба может предоставлять разрешения, которые не являются обязательными для всех контекстов. Там, где это возможно, придерживайтесь принципа минимальных привилегий, предоставляя удостоверению лишь самые необходимые привилегии. Например, если приложению требуется только возможность чтения из источника данных, используйте роль, которая имеет разрешение только на чтение. Было бы неуместным назначить роль, которая также разрешает запись в эту службу, так как это разрешение не требуется для операции чтения. Соответственно необходимо еще проверить, что область действия назначенной роли ограничена только теми ресурсами, которые необходимо прочитать.

Выберите одну из этих вкладок, чтобы узнать о разрешениях для каждого компонента:

Необходимо создать назначение ролей, которое предоставляет доступ к контейнеру BLOB-объектов во время выполнения. Ролей управления, таких как Владелец, недостаточно. В следующей таблице показаны встроенные роли, которые рекомендуется использовать вместе с расширением BLOB-объекта службы хранилища при обычной работе. Приложению могут потребоваться дополнительные разрешения на основе написанного кода.

Тип привязки	Примеры встроенных ролей
Триггер	Владелец данных BLOB-объектов хранилища и участник^{данных очереди хранилища 1} Дополнительные разрешения также должны быть предоставлены подключению AzureWebJobsStorage.²
Входные привязки	читатель данных больших двоичных объектов хранилища.
Выходные привязки	владелец данных BLOB-объектов хранилища;

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

² Подключение AzureWebJobsStorage используется во внутренней логике для BLOB-объектов и очередей, которые обеспечивают работу триггера. Если он настроен на использование подключения на основе удостоверений, он нуждается в дополнительных разрешениях за пределами требования по умолчанию. Необходимые разрешения охватываются ролями владельца данных BLOB-объектов хранилища, участника очередей хранилища и участника учетной записи хранения. Для получения дополнительных сведений см. раздел Подключение к хранилищу узла с помощью удостоверения.

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

Тип привязки	Примеры встроенных ролей
Триггер	Читатель данных очереди хранилища, Обработчик сообщений данных в очереди хранилища
Выходные привязки	Участник для данных очереди хранилища, Отправитель сообщений данных в очередь хранилища

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

Тип привязки	Примеры встроенных ролей (служба хранилища Azure ¹)
Входные привязки	Читатель данных таблицы хранилища
Выходные привязки	Участник данных таблицы хранилища

¹ Если приложение вместо этого подключается к таблицам в Azure Cosmos DB для таблицы, использование удостоверения не поддерживается, а подключение должно использовать строка подключения.

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

Тип привязки	Примеры встроенных ролей
Триггер	Получатель данных Центров событий Azure, Владелец данных Центров событий Azure
Выходные привязки	Отправитель данных Центров событий Azure

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

Тип привязки	Примеры встроенных ролей
Триггер¹	Получатель данных Служебной шины Azure, Владелец данных служебной шины Azure
Выходные привязки	Отправитель данных Служебной шины Azure

¹ Для активации из разделов служебной шины назначение роли должно иметь эффективную область действия, в которую входят ресурсы подписки служебной шины. Если включен только раздел, отобразится ошибка. Некоторые клиенты, такие как портал Azure, не предоставляют ресурс подписки служебной шины в качестве области назначения ролей. В таких случаях вместо этого можно использовать Azure CLI. Для получения дополнительных сведений см. раздел Встроенные роли Azure для служебной шины Azure.

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

Тип привязки	Примеры встроенных ролей
Выходные привязки	Участник EventGrid, отправитель данных EventGrid

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

Тип привязки	Пример встроенных ролей¹
Триггер²	Встроенный участник данных Cosmos DB
Входные привязки	Встроенное средство чтения данных Cosmos DB
Выходные привязки	Встроенный участник данных Cosmos DB

¹ Эти роли нельзя использовать в назначении ролей RBAC Azure. Дополнительные сведения о назначении этих ролей см. в встроенной системной документации по RBAC Cosmos DB.

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

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

Приложению могут потребоваться дополнительные разрешения в зависимости от создаваемого кода. Если вы используете поведение по умолчанию или явно задаете для connectionName значение AzureWebJobsStorage, обратитесь к разделу Подключение к хранилищу узлов с удостоверением, где приведены дополнительные рекомендации для разрешений.

Вам потребуется создать назначение ролей, предоставляющее доступ к учетной записи хранения для "AzureWebJobsStorage" во время выполнения. Ролей управления, таких как Владелец, недостаточно. Роль владельца данных BLOB-объектов хранилища охватывает основные потребности хранилища узлов Функций. Среда выполнения должна иметь доступ для чтения и записи к BLOB-объектам и возможность создавать контейнеры. Несколько расширений используют это подключение в качестве расположения по умолчанию для BLOB-объектов, очередей и таблиц, и в этом случае могут возникать дополнительные требования, как указано в таблице ниже. При использовании AzureWebJobsStorage в других целях могут потребоваться дополнительные разрешения.

Расширение	Необходимые роли	Описание
Без расширения (только узел)	владелец данных BLOB-объектов хранилища;	Используется для общей координации, хранилище ключей по умолчанию
BLOB-объекты Azure (только триггер)	Все из: Участник учетной записи хранения, Владелец данных BLOB-объектов хранилища, Участник для данных очереди хранилища	Триггер BLOB-объектов использует очереди Azure во внутренней структуре и записывает команды для BLOB-объектов. Для них используется атрибут AzureWebJobsStorage независимо от подключения, настроенного для триггера.
Центры событий Azure (только триггер)	(без изменения требований по умолчанию) владелец данных BLOB-объектов хранилища;	Контрольные точки сохраняются в BLOB-объектах с помощью подключения AzureWebJobsStorage.
Триггер по таймеру	(без изменения требований по умолчанию) владелец данных BLOB-объектов хранилища;	Чтобы обеспечить одно выполнение для каждого события, блокировки берутся их BLOB-объектов с помощью подключения AzureWebJobsStorage.
Устойчивые функции	Все из: Участник для данных BLOB-объектов хранилища, Участник для данных очереди хранилища, Участник данных таблицы хранилища	Устойчивые функции использует BLOB-объекты, очереди и таблицы для координации функций действий и поддержания состояния оркестрации. По умолчанию для всех этих подключений используется подключение AzureWebJobsStorage, но в конфигурации расширения Устойчивые функции можно указать другое подключение.

Общие свойства подключений на основе удостоверений

Подключение на основе удостоверений для службы Azure принимает следующие общие свойства, где <CONNECTION_NAME_PREFIX> — это значение свойства connection в определении триггера или привязки:

Свойство	Шаблон переменной среды	Description
Учетные данные маркера	`<CONNECTION_NAME_PREFIX>__credential`	Определяет, как должен быть получен маркер для соединения. Этот параметр следует задать, `managedidentity` если развернутая функция Azure намерена использовать проверку подлинности управляемого удостоверения. Это значение допустимо только в том случае, если управляемое удостоверение доступно в среде размещения.
Client ID	`<CONNECTION_NAME_PREFIX>__clientId`	Если `credential` задано значение `managedidentity`, это свойство можно задать, чтобы указать назначаемое пользователем удостоверение, которое будет использоваться при получении маркера. Свойство принимает идентификатор клиента, соответствующий назначаемому пользователем удостоверению, которое назначено приложению. Недопустимо указать идентификатор ресурса и идентификатор клиента. Если это не указано, используется удостоверение, назначаемое системой. Это свойство используется по-разному в локальных сценариях разработки, если `credential` не следует задавать.
ИД ресурса	`<CONNECTION_NAME_PREFIX>__managedIdentityResourceId`	Если `credential` задано `managedidentity`значение, это свойство можно задать, чтобы указать идентификатор ресурса, который будет использоваться при получении маркера. Свойство принимает идентификатор ресурса, соответствующий идентификатору ресурса определяемого пользователем управляемого удостоверения. Недопустимо указать идентификатор ресурса и идентификатор клиента. Если ни указано, используется удостоверение, назначаемое системой. Это свойство используется по-разному в локальных сценариях разработки, если `credential` не следует задавать.

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

Переменные среды пакета SDK Для Azure

Внимание

Использование переменных среды пакета SDK EnvironmentCredential Azure не рекомендуется из-за потенциального непреднамеренного влияния на другие подключения. Они также не полностью поддерживаются при развертывании в Функции Azure.

Кроме того, можно задать переменные среды, связанные с пакетом SDK EnvironmentCredential Azure, но они не обрабатываются службой "Функции" для масштабирования в планах потребления. Эти переменные среды не относятся к одному подключению и будут применяться в качестве значения по умолчанию, если соответствующее свойство не задано для заданного подключения. Например, если AZURE_CLIENT_ID задано, это будет использоваться так, как будто <CONNECTION_NAME_PREFIX>__clientId было настроено. Явно задано <CONNECTION_NAME_PREFIX>__clientId переопределение этого значения по умолчанию.

Локальная разработка с использованием подключений на основе удостоверений

Примечание.

Для локальной разработки с подключениями на основе удостоверений требуется версия 4.0.3904 Функции Azure Core Tools или более поздней версии.

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

локальный кэш, совместно используемый приложениями Майкрософт;
контекст текущего пользователя в Visual Studio;
контекст текущего пользователя в Visual Studio Code;
контекст текущего пользователя в Azure CLI.

Если ни один из этих параметров не выполнен успешно, возникает ошибка.

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

В некоторых случаях может потребоваться указать другое удостоверение. Вы можете добавить свойства конфигурации для подключения, которое указывает на альтернативное удостоверение на основе идентификатора клиента и секрета клиента для субъекта-службы Microsoft Entra. Следующий параметр конфигурации не поддерживается при размещении в службе "Функции Azure". Чтобы использовать идентификатор и секрет на локальном компьютере, определите подключение со следующими дополнительными свойствами:

Свойство	Шаблон переменной среды	Description
Идентификатор клиента	`<CONNECTION_NAME_PREFIX>__tenantId`	Идентификатор клиента Microsoft Entra (каталог).
Client ID	`<CONNECTION_NAME_PREFIX>__clientId`	Идентификатор клиента (приложения) для регистрации приложения в клиенте.
Секрет клиента	`<CONNECTION_NAME_PREFIX>__clientSecret`	Секрет клиента, созданный для регистрации приложения.

Ниже приведен пример свойств, необходимых local.settings.json для подключения на основе удостоверений к BLOB-объектам Azure:

{
  "IsEncrypted": false,
  "Values": {
    "<CONNECTION_NAME_PREFIX>__blobServiceUri": "<blobServiceUri>",
    "<CONNECTION_NAME_PREFIX>__queueServiceUri": "<queueServiceUri>",
    "<CONNECTION_NAME_PREFIX>__tenantId": "<tenantId>",
    "<CONNECTION_NAME_PREFIX>__clientId": "<clientId>",
    "<CONNECTION_NAME_PREFIX>__clientSecret": "<clientSecret>"
  }
}

Подключение к хранилищу узла с помощью удостоверения

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

Внимание

Другие компоненты в Функциях зависят от AzureWebJobsStorage поведения по умолчанию. Их не следует переводить на использование подключений на основе удостоверений, если вы используете более старые версии расширений, которые не поддерживают данный тип подключения, включая триггеры и привязки для BLOB-объектов Azure, центры событий и устойчивые функции. Аналогичным образом для артефактов развертывания используется AzureWebJobsStorage, когда используется серверная сборка в потреблении Linux и, если вы включите этот параметр, вам потребуется выполнить развертывание с помощью внешнего пакета развертывания.

Кроме того, приложение-функция может повторно использовать AzureWebJobsStorage для других подключений к хранилищу в их триггерах, привязках и /или коде функции. Прежде чем переходить на удостоверение со строки подключения, убедитесь, что все сценарии использования AzureWebJobsStorage поддерживают формат подключения на основе удостоверений.

Чтобы использовать подключение AzureWebJobsStorageна основе удостоверений, настройте следующие параметры приложения:

Параметр	Description	Пример значения
`AzureWebJobsStorage__blobServiceUri`	Универсальный код ресурса (URI) плоскости данных службы BLOB-объектов учетной записи хранения, использующей схему HTTPS.	https://<storage_account_name>.blob.core.windows.net
`AzureWebJobsStorage__queueServiceUri`	Универсальный код ресурса (URI) плоскости данных службы очередей учетной записи хранения, использующей схему HTTPS.	https://<storage_account_name>.queue.core.windows.net
`AzureWebJobsStorage__tableServiceUri`	Универсальный код ресурса (URI) плоскости данных службы таблиц учетной записи хранения, использующей схему HTTPS.	https://<storage_account_name>.table.core.windows.net

Также можно задать общие свойства для подключений на основе удостоверений.

Если вы настраиваете AzureWebJobsStorage учетную запись хранения, которая использует dns-суффикс по умолчанию и имя службы для глобальной среды Azure, https://<accountName>.[blob|queue|file|table].core.windows.net вы можете вместо этого задать AzureWebJobsStorage__accountName имя учетной записи хранения. Конечные точки для каждой службы хранения выводятся для этой учетной записи. Это не работает, если учетная запись хранения находится в суверенном облаке или имеет пользовательский DNS.

Параметр	Description	Пример значения
`AzureWebJobsStorage__accountName`	Имя учетной записи хранения, допустимое только в том случае, если учетная запись не в суверенном облаке и не имеет настраиваемого DNS. Этот синтаксис уникален `AzureWebJobsStorage` и не может использоваться для других подключений на основе удостоверений.	<storage_account_name>

Расширение	Необходимые роли	Описание
Без расширения (только узел)	владелец данных BLOB-объектов хранилища;	Используется для общей координации, хранилище ключей по умолчанию
BLOB-объекты Azure (только триггер)	Все из: Участник учетной записи хранения, Владелец данных BLOB-объектов хранилища, Участник для данных очереди хранилища	Триггер BLOB-объектов использует очереди Azure во внутренней структуре и записывает команды для BLOB-объектов. Для них используется атрибут AzureWebJobsStorage независимо от подключения, настроенного для триггера.
Центры событий Azure (только триггер)	(без изменения требований по умолчанию) владелец данных BLOB-объектов хранилища;	Контрольные точки сохраняются в BLOB-объектах с помощью подключения AzureWebJobsStorage.
Триггер по таймеру	(без изменения требований по умолчанию) владелец данных BLOB-объектов хранилища;	Чтобы обеспечить одно выполнение для каждого события, блокировки берутся их BLOB-объектов с помощью подключения AzureWebJobsStorage.
Устойчивые функции	Все из: Участник для данных BLOB-объектов хранилища, Участник для данных очереди хранилища, Участник данных таблицы хранилища	Устойчивые функции использует BLOB-объекты, очереди и таблицы для координации функций действий и поддержания состояния оркестрации. По умолчанию для всех этих подключений используется подключение AzureWebJobsStorage, но в конфигурации расширения Устойчивые функции можно указать другое подключение.

Создание отчетов о проблемах

Позиция	Description	Ссылка
Параметры выполнения	Сервер сценариев, триггеры и привязки, языковая поддержка	Сообщить о проблеме
Шаблоны	Проблемы с кодом при использовании шаблона создания	Сообщить о проблеме
Портал	Проблемы с пользовательским интерфейсом или при работе с ним	Сообщить о проблеме