Справочник по параметрам приложений для Функций AzureApp settings reference for Azure Functions

Параметры приложения в приложении-функции содержат параметры глобальной конфигурации, влияющие на все функции данного приложения-функции.App settings in a function app contain global configuration options that affect all functions for that function app. При локальном запуске эти параметры доступны как переменные локальной среды.When you run locally, these settings are accessed as local environment variables. В этой статье перечислены параметры приложений, которые доступны в приложениях-функциях.This article lists the app settings that are available in function apps.

Существует несколько способов для добавления, обновления и удаления параметров приложения-функции.There are several ways that you can add, update, and delete function app settings:

В файле host.json и в файле local.settings.json содержатся другие параметры глобальной конфигурации.There are other global configuration options in the host.json file and in the local.settings.json file.

APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY

Ключ инструментирования Application Insights, если используется Application Insights.The Application Insights instrumentation key if you're using Application Insights. Дополнительные сведения см. в статье Мониторинг функций Azure.See Monitor Azure Functions.

КлючKey Образец значенияSample value
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY 5dbdd5e9-af77-484b-9032-64f83bb83bb5dbdd5e9-af77-484b-9032-64f83bb83bb

AZURE_FUNCTIONS_ENVIRONMENTAZURE_FUNCTIONS_ENVIRONMENT

В версии 2. x и более поздних версиях среды выполнения функций настраивает поведение приложения на основе среды выполнения.In version 2.x and later versions of the Functions runtime, configures app behavior based on the runtime environment. Это значение считывается во время инициализации.This value is read during initialization. Можно задать AZURE_FUNCTIONS_ENVIRONMENT любое значение, но поддерживаются три значения : Разработка, промежуточное развертываниеи Рабочая среда.You can set AZURE_FUNCTIONS_ENVIRONMENT to any value, but three values are supported: Development, Staging, and Production. Если параметр AZURE_FUNCTIONS_ENVIRONMENT не задан, по умолчанию используется Development в локальной среде и Production в Azure.When AZURE_FUNCTIONS_ENVIRONMENT isn't set, it defaults to Development on a local environment and Production on Azure. Этот параметр следует использовать вместо ASPNETCORE_ENVIRONMENT для задания среды выполнения.This setting should be used instead of ASPNETCORE_ENVIRONMENT to set the runtime environment.

AzureWebJobsDashboardAzureWebJobsDashboard

Необязательная строка подключения учетной записи для хранения журналов и их отображения на вкладке Монитор на портале.Optional storage account connection string for storing logs and displaying them in the Monitor tab in the portal. Учетная запись хранения должна быть учетной записью общего назначения, поддерживающей большие двоичные объекты, очереди и таблицы.The storage account must be a general-purpose one that supports blobs, queues, and tables. Ознакомьтесь с разделами Учетная запись хранения и Требования к учетной записи хранения.See Storage account and Storage account requirements.

КлючKey Образец значенияSample value
AzureWebJobsDashboardAzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

Совет

Для достижения наилучшей производительности и взаимодействия вместо AzureWebJobsDashboard для мониторинга рекомендуется использовать APPINSIGHTS_INSTRUMENTATIONKEY и App Insights.For performance and experience, it is recommended to use APPINSIGHTS_INSTRUMENTATIONKEY and App Insights for monitoring instead of AzureWebJobsDashboard

AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage

true означает отключение целевой страницы по умолчанию, которая отображается для корневого URL-адреса приложения-функции.true means disable the default landing page that is shown for the root URL of a function app. Значение по умолчанию — false.Default is false.

КлючKey Образец значенияSample value
AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage truetrue

Если пропустить этот параметр приложения или задать для него значение false, то в ответ на URL-адрес <functionappname>.azurewebsites.net отобразится страница, аналогичная приведенной ниже.When this app setting is omitted or set to false, a page similar to the following example is displayed in response to the URL <functionappname>.azurewebsites.net.

Целевая страница приложения-функции

AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation

true означает использование режима выпуска при компиляции кода .NET; false означает использование режима отладки.true means use Release mode when compiling .NET code; false means use Debug mode. Значение по умолчанию — true.Default is true.

КлючKey Образец значенияSample value
AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation truetrue

AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags

Разделенный запятыми список бета-функций, которые необходимо включить.A comma-delimited list of beta features to enable. Бета-функции, которые здесь отмечаются флагами, еще не готовы для рабочей среды, но их можно включить для использования в экспериментальных целях.Beta features enabled by these flags are not production ready, but can be enabled for experimental use before they go live.

КлючKey Образец значенияSample value
AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags feature1,feature2feature1,feature2

AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType

Указывает репозиторий или поставщик, используемый для хранения ключей.Specifies the repository or provider to use for key storage. Сейчас поддерживаемыми репозиториями являются большой двоичный объект ("Blob") и локальная файловая система ("Files").Currently, the supported repositories are blob storage ("Blob") and the local file system ("Files"). По умолчанию в версии 2 используется большой двоичный объект, а в версии 1 — файловая система.The default is blob in version 2 and file system in version 1.

КлючKey Образец значенияSample value
AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType ФайлыFiles

AzureWebJobsStorageAzureWebJobsStorage

Среда выполнения Функций Azure использует эту строку подключения учетной записи хранения для всех функций, кроме функций, активируемых протоколом HTTP.The Azure Functions runtime uses this storage account connection string for all functions except for HTTP triggered functions. Учетная запись хранения должна быть учетной записью общего назначения, поддерживающей большие двоичные объекты, очереди и таблицы.The storage account must be a general-purpose one that supports blobs, queues, and tables. Ознакомьтесь с разделами Учетная запись хранения и Требования к учетной записи хранения.See Storage account and Storage account requirements.

КлючKey Образец значенияSample value
AzureWebJobsStorageAzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath

Путь к компилятору, который используется для TypeScript.Path to the compiler used for TypeScript. Позволяет при необходимости переопределить значение по умолчанию.Allows you to override the default if you need to.

КлючKey Образец значенияSample value
AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath %HOME%\typescript%HOME%\typescript

FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE

Определяет, включен ли режим редактирования в портал Azure.Dictates whether editing in the Azure portal is enabled. Допустимые значения — "readwrite" и "readonly".Valid values are "readwrite" and "readonly".

КлючKey Образец значенияSample value
FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE readonlyreadonly

FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION

Версия среды выполнения Функций, которая используется в этом приложении-функции.The version of the Functions runtime to use in this function app. Тильда с основным номером версии означает использование последней версии этого основного номера версии (например, "~2").A tilde with major version means use the latest version of that major version (for example, "~2"). Когда доступны новые версии для того же основного номера версии, они устанавливаются в приложении-функции автоматически.When new versions for the same major version are available, they are automatically installed in the function app. Чтобы закрепить для приложения определенную версию, используйте полный номер версии (например, "2.0.12345").To pin the app to a specific version, use the full version number (for example, "2.0.12345"). Значение по умолчанию: "~2".Default is "~2". Значение ~1 позволяет закрепить для приложения версию 1.x среды выполнения.A value of ~1 pins your app to version 1.x of the runtime.

КлючKey Образец значенияSample value
FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION ~2~2

РЕЖИМ_СОВМЕСТИМОСТИ функций_v2_FUNCTIONS_V2_COMPATIBILITY_MODE

Этот параметр позволяет приложению-функции работать в режиме совместимости с версией 2. x в среде выполнения версии 3. x.This setting enables your function app to run in a version 2.x compatible mode on the version 3.x runtime. Используйте этот параметр, только если возникли проблемы при обновлении приложения функции с версии 2. x до 3. x среды выполнения.Use this setting only if encountering issues when upgrading your function app from version 2.x to 3.x of the runtime.

Важно!

Этот параметр предназначен только для краткосрочного решения при обновлении приложения для правильной работы в версии 3. x.This setting is intended only as a short-term workaround while you update your app to run correctly on version 3.x. Этот параметр поддерживается до тех пор, пока поддерживается среда выполнения 2. x.This setting is supported as long as the 2.x runtime is supported. Если возникли проблемы, препятствующие запуску приложения в версии 3. x без использования этого параметра, сообщите об ошибке.If you encounter issues that prevent your app from running on version 3.x without using this setting, please report your issue.

Требует, чтобы функции_EXTENSION_версии были установлены в ~3.Requires that FUNCTIONS_EXTENSION_VERSION be set to ~3.

КлючKey Образец значенияSample value
РЕЖИМ_СОВМЕСТИМОСТИ функций_v2_FUNCTIONS_V2_COMPATIBILITY_MODE truetrue

ФУНКЦИИ_число_рабочих процессов_FUNCTIONS_WORKER_PROCESS_COUNT

Указывает максимальное количество рабочих процессов на языке и значение по умолчанию 1.Specifies the maximum number of language worker processes, with a default value of 1. Максимально допустимое значение — 10.The maximum value allowed is 10. Вызовы функций равномерно распределяются между рабочими процессами языка.Function invocations are evenly distributed among language worker processes. Рабочие процессы языка порождаются каждые 10 секунд до тех пор, пока количество функций не будет установлено функцией_рабочего_процесса_число.Language worker processes are spawned every 10 seconds until the count set by FUNCTIONS_WORKER_PROCESS_COUNT is reached. Использование нескольких языковых рабочих процессов отличается от масштабирования.Using multiple language worker processes is not the same as scaling. Рекомендуется использовать этот параметр, если в рабочей нагрузке есть сочетание вызовов, привязанных к ЦП, и операций ввода-вывода, связанных с вводом-выводом.Consider using this setting when your workload has a mix of CPU-bound and I/O-bound invocations. Этот параметр применяется ко всем non-.NET языкам.This setting applies to all non-.NET languages.

КлючKey Образец значенияSample value
ФУНКЦИИ_число_рабочих процессов_FUNCTIONS_WORKER_PROCESS_COUNT 22

FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME

Среда выполнения языка рабочей роли для загрузки в приложении-функции.The language worker runtime to load in the function app. Она будет соответствовать языку, используемому в приложении (например, "dotnet").This will correspond to the language being used in your application (for example, "dotnet"). Функции на нескольких языках потребуется опубликовать в нескольких приложениях с соответствующим значением среды выполнения рабочей роли.For functions in multiple languages you will need to publish them to multiple apps, each with a corresponding worker runtime value. Допустимые значения: dotnetC#(F#/), node (JavaScript/TypeScript), java (Java), powershell (PowerShell) и python (Python).Valid values are dotnet (C#/F#), node (JavaScript/TypeScript), java (Java), powershell (PowerShell), and python (Python).

КлючKey Образец значенияSample value
FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME dotnetdotnet

WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Только для планов использования & Premium.For Consumption & Premium plans only. Строка подключения для учетной записи хранения, где хранятся код и конфигурация приложения-функции.Connection string for storage account where the function app code and configuration are stored. Ознакомьтесь с разделом Создание приложения-функции.See Create a function app.

КлючKey Образец значенияSample value
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE

Только для планов использования & Premium.For Consumption & Premium plans only. Путь к файлам c кодом и конфигурацией приложения-функции.The file path to the function app code and configuration. Используется с WEBSITE_CONTENTAZUREFILECONNECTIONSTRING.Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Значение по умолчанию — уникальная строка, которая начинается с имени приложения-функции.Default is a unique string that begins with the function app name. Ознакомьтесь с разделом Создание приложения-функции.See Create a function app.

КлючKey Образец значенияSample value
WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE functionapp091999e2functionapp091999e2

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Максимальное число экземпляров, до которого можно развернуть приложение-функцию.The maximum number of instances that the function app can scale out to. По умолчанию ограничение не установлено.Default is no limit.

Примечание

Этот параметр доступен в качестве предварительной версии функции. Надежная работа обеспечивается только при его значении не больше 5.This setting is a preview feature - and only reliable if set to a value <= 5

КлючKey Образец значенияSample value
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 55

WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION

Только Windows.Windows only.
Задает версию Node. js, используемую при запуске приложения функции в Windows.Sets the version of Node.js to use when running your function app on Windows. Чтобы среда выполнения использовала последнюю доступную версию целевой основной версии, следует использовать символ тильды (~).You should use a tilde (~) to have the runtime use the latest available version of the targeted major version. Например, если задано значение ~10, используется последняя версия Node. js 10.For example, when set to ~10, the latest version of Node.js 10 is used. Если для основной версии используется тильда, не нужно вручную обновлять дополнительный номер версии.When a major version is targeted with a tilde, you don't have to manually update the minor version.

КлючKey Образец значенияSample value
WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION ~ 10~10

WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE

Позволяет приложению-функции запуск из файла подключенного пакета.Enables your function app to run from a mounted package file.

КлючKey Образец значенияSample value
WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE 11

Допустимые значения: или URL-адрес, который разрешается в путь файла пакета развертывания, или 1.Valid values are either a URL that resolves to the location of a deployment package file, or 1. Если задано значение 1, пакет должен быть в папке d:\home\data\SitePackages.When set to 1, the package must be in the d:\home\data\SitePackages folder. При использовании развертывания из ZIP-файла с этим параметром пакет автоматически передается в это расположение.When using zip deployment with this setting, the package is automatically uploaded to this location. В предварительной версии этот параметр называется WEBSITE_RUN_FROM_ZIP.In preview, this setting was named WEBSITE_RUN_FROM_ZIP. Дополнительные сведения см. в статье Запуск Функций Azure из файла пакета.For more information, see Run your functions from a package file.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

По умолчанию прокси-серверы Функций будут использовать команду для отправки вызовов API из них самих непосредственно в функции в одном приложении-функции, а не создавать новый HTTP-запрос.By default Functions proxies will utilize a shortcut to send API calls from proxies directly to functions in the same Function App, rather than creating a new HTTP request. Этот параметр позволяет отключить такую реакцию на событие.This setting allows you to disable that behavior.

КлючKey ЗначениеValue DescriptionDescription
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL truetrue Вызовы с URL-адресом внутреннего сервера, указывающим на функцию в локальном приложение-функция больше не будут отправляться непосредственно в функцию, а вместо этого будут переданы обратно в интерфейс HTTP для приложение-функцияCalls with a backend URL pointing to a function in the local Function App will no longer be sent directly to the function, and will instead be directed back to the HTTP front end for the Function App
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL falsefalse Это значение по умолчанию.This is the default value. Вызовы с URL-адресом внутреннего сервера, указывающим на функцию в локальном приложение-функция будут переадресовываться непосредственно в эту функциюCalls with a backend URL pointing to a function in the local Function App will be forwarded directly to that Function

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Этот параметр контролирует, декодируется ли сочетание знаков %2F как косая черта в параметрах маршрута, если оно вставлено в URL-адрес внутреннего сервера.This setting controls whether %2F is decoded as slashes in route parameters when they are inserted into the backend URL.

КлючKey ЗначениеValue DescriptionDescription
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES truetrue Параметры маршрута с закодированными косыми чертами будут его декодировать.Route parameters with encoded slashes will have them decoded. example.com/api%2ftest станет example.com/api/testexample.com/api%2ftest will become example.com/api/test
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES falsefalse Это поведение по умолчанию.This is the default behavior. Все параметры маршрута будут передаваться без измененийAll route parameters will be passed along unchanged

ПримерExample

Ниже приведен пример файла proxies.json в приложении-функции, расположенному по URL-адресу myfunction.comHere is an example proxies.json in a function app at the URL myfunction.com

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}
Декодирование URL-адресаURL Decoding Входные данныеInput Выходные данныеOutput
truetrue myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test/apiexample.com/test/api
falsefalse myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test%2fapiexample.com/test%2fapi

Дальнейшие действияNext steps

Узнайте, как обновлять параметры приложенияLearn how to update app settings

Ознакомьтесь с глобальными параметрами в файле host.jsonSee global settings in the host.json file

См. другие параметры приложения для приложений Службы приложений AzureSee other app settings for App Service apps