Referência de configurações de aplicativo para Azure FunctionsApp settings reference for Azure Functions

As configurações de aplicativo em um aplicativo de funções contém opções de configuração global que afetam todas as funções desse aplicativo de funções.App settings in a function app contain global configuration options that affect all functions for that function app. Quando você executa localmente, essas configurações são acessadas como variáveis de ambiente.When you run locally, these settings are accessed as local environment variables. Este artigo lista as configurações de aplicativo disponíveis nos aplicativos de funções.This article lists the app settings that are available in function apps.

Há várias maneiras de adicionar, atualizar e excluir configurações do aplicativo de funções:There are several ways that you can add, update, and delete function app settings:

Há outras opções de configuração global no arquivo host.json e no arquivo local.settings.json.There are other global configuration options in the host.json file and in the local.settings.json file.

APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY

Chave de instrumentação do Application Insights se você estiver usando o Application Insights.The Application Insights instrumentation key if you're using Application Insights. Consulte Monitorar Azure Functions.See Monitor Azure Functions.

ChaveKey Valor de exemploSample value
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY 5dbdd5e9-af77-484b-9032-64f83bb83bb5dbdd5e9-af77-484b-9032-64f83bb83bb

AZURE_FUNCTIONS_ENVIRONMENTAZURE_FUNCTIONS_ENVIRONMENT

Na versão 2. x do tempo de execução do functions, o configura o comportamento do aplicativo com base no ambiente de tempo de execução.In version 2.x of the Functions runtime, configures app behavior based on the runtime environment. Esse valor é lido durante a inicialização.This value is read during initialization. Você pode definir AZURE_FUNCTIONS_ENVIRONMENT para qualquer valor, mas há suporte para três valores : desenvolvimento, preparoe produção.You can set AZURE_FUNCTIONS_ENVIRONMENT to any value, but three values are supported: Development, Staging, and Production. Quando AZURE_FUNCTIONS_ENVIRONMENT não é definido, o padrão é Development em um ambiente local e Production no Azure.When AZURE_FUNCTIONS_ENVIRONMENT isn't set, it defaults to Development on a local environment and Production on Azure. Essa configuração deve ser usada em vez de ASPNETCORE_ENVIRONMENT para definir o ambiente de tempo de execução.This setting should be used instead of ASPNETCORE_ENVIRONMENT to set the runtime environment.

AzureWebJobsDashboardAzureWebJobsDashboard

Cadeia de conexão da conta de armazenamento opcional para armazenar logs e exibi-los na guia Monitor do portal.Optional storage account connection string for storing logs and displaying them in the Monitor tab in the portal. A conta de armazenamento deve ser de uso geral, com suporte para blobs, filas e tabelas.The storage account must be a general-purpose one that supports blobs, queues, and tables. Consulte Conta de armazenamento e Requisitos da conta de armazenamento.See Storage account and Storage account requirements.

ChaveKey Valor de exemploSample value
AzureWebJobsDashboardAzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

Dica

Para desempenho e experiência, é recomendável usar APPINSIGHTS_INSTRUMENTATIONKEY e App Insights para monitoramento, em vez de AzureWebJobsDashboardFor performance and experience, it is recommended to use APPINSIGHTS_INSTRUMENTATIONKEY and App Insights for monitoring instead of AzureWebJobsDashboard

AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage

true significa desabilitar a página de aterrissagem padrão mostrada para a URL raiz de um aplicativo de funções.true means disable the default landing page that is shown for the root URL of a function app. O padrão é false.Default is false.

ChaveKey Valor de exemploSample value
AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage verdadeirotrue

Quando essa configuração de aplicativo é omitida ou definida como false, uma página semelhante ao exemplo a seguir é exibida na resposta à 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.

Página de aterrissagem do aplicativo de funções

AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation

true significa usar o modo de versão durante a compilação do código .NET; false significa usar o modo de depuração.true means use Release mode when compiling .NET code; false means use Debug mode. O padrão é true.Default is true.

ChaveKey Valor de exemploSample value
AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation verdadeirotrue

AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags

Uma lista delimitada por vírgulas de recursos beta a habilitar.A comma-delimited list of beta features to enable. Os recursos beta habilitados por esses sinalizadores não estão prontos para produção, mas podem ser habilitados para uso experimental antes de serem lançados.Beta features enabled by these flags are not production ready, but can be enabled for experimental use before they go live.

ChaveKey Valor de exemploSample value
AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags feature1,feature2feature1,feature2

AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType

Especifica o repositório ou o provedor a ser usado para armazenar chaves.Specifies the repository or provider to use for key storage. Atualmente, os repositórios com suporte são o armazenamento de blobs ("Blob") e o sistema de arquivos local ("Arquivos").Currently, the supported repositories are blob storage ("Blob") and the local file system ("Files"). O padrão é blob na versão 2 e sistema de arquivos na versão 1.The default is blob in version 2 and file system in version 1.

ChaveKey Valor de exemploSample value
AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType ArquivosFiles

AzureWebJobsStorageAzureWebJobsStorage

O Azure Functions runtime usa essa cadeia de conexão da conta armazenamento para todas as funções, exceto para as funções disparadas por HTTP.The Azure Functions runtime uses this storage account connection string for all functions except for HTTP triggered functions. A conta de armazenamento deve ser de uso geral, com suporte para blobs, filas e tabelas.The storage account must be a general-purpose one that supports blobs, queues, and tables. Consulte Conta de armazenamento e Requisitos da conta de armazenamento.See Storage account and Storage account requirements.

ChaveKey Valor de exemploSample value
AzureWebJobsStorageAzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath

Caminho para o compilador usado para TypeScript.Path to the compiler used for TypeScript. Permite substituir o padrão se necessário.Allows you to override the default if you need to.

ChaveKey Valor de exemploSample value
AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath %HOME%\typescript%HOME%\typescript

FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE

Determina se a edição no portal do Azure está habilitada.Dictates whether editing in the Azure portal is enabled. Os valores válidos são "readwrite" e "readonly".Valid values are "readwrite" and "readonly".

ChaveKey Valor de exemploSample value
FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE readonlyreadonly

FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION

A versão do runtime do Functions para usar nesse aplicativo de funções.The version of the Functions runtime to use in this function app. Um til com a versão principal significa usar a versão mais recente da versão principal (por exemplo, "~2").A tilde with major version means use the latest version of that major version (for example, "~2"). Quando novas versões da mesma versão principal estão disponíveis, elas são instaladas automaticamente no aplicativo de funções.When new versions for the same major version are available, they are automatically installed in the function app. Para fixar o aplicativo a uma versão específica, use o número de versão completo (por exemplo, "2.0.12345").To pin the app to a specific version, use the full version number (for example, "2.0.12345"). O padrão é "~ 2".Default is "~2". Um valor de pinos ~1 seu aplicativo para a versão 1.x do runtime.A value of ~1 pins your app to version 1.x of the runtime.

ChaveKey Valor de exemploSample value
FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION ~2~2

O Functions_o processo de_do trabalhador_contagemFUNCTIONS_WORKER_PROCESS_COUNT

Especifica o número máximo de processos de trabalho de idioma, com um valor padrão de 1.Specifies the maximum number of language worker processes, with a default value of 1. O valor máximo permitido é 10.The maximum value allowed is 10. As invocações de função são distribuídas uniformemente entre os processos de trabalho de linguagem.Function invocations are evenly distributed among language worker processes. Os processos de trabalho de idioma são gerados a cada 10 segundos até que a contagem definida por funções_o processo de_de trabalho_contagem seja atingida.Language worker processes are spawned every 10 seconds until the count set by FUNCTIONS_WORKER_PROCESS_COUNT is reached. O uso de vários processos de trabalho de idioma não é o mesmo que o dimensionamento.Using multiple language worker processes is not the same as scaling. Considere usar essa configuração quando sua carga de trabalho tiver uma combinação de invocações associadas à CPU e de e/s.Consider using this setting when your workload has a mix of CPU-bound and I/O-bound invocations. Essa configuração se aplica a todos os idiomas do non-.NET.This setting applies to all non-.NET languages.

ChaveKey Valor de exemploSample value
O Functions_o processo de_do trabalhador_contagemFUNCTIONS_WORKER_PROCESS_COUNT 22

FUNÇÕES_TRABALHADOR_TEMPO DE EXECUÇÃOFUNCTIONS_WORKER_RUNTIME

O runtime do trabalho de linguagem deve ser carregado no aplicativo de funções.The language worker runtime to load in the function app. Isso irá corresponder ao idioma que está sendo usado em seu aplicativo (por exemplo, "dotnet").This will correspond to the language being used in your application (for example, "dotnet"). Para funções em vários idiomas, você precisará publicá-las em vários aplicativos, cada um com um valor de runtime de trabalho correspondente.For functions in multiple languages you will need to publish them to multiple apps, each with a corresponding worker runtime value. Os valores válidos são dotnetC#(F#/), node (JavaScript/TypeScript), java (Java), powershell (PowerShell) e python (Python).Valid values are dotnet (C#/F#), node (JavaScript/TypeScript), java (Java), powershell (PowerShell), and python (Python).

ChaveKey Valor de exemploSample value
FUNÇÕES_TRABALHADOR_TEMPO DE EXECUÇÃOFUNCTIONS_WORKER_RUNTIME dotnetdotnet

WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Para consumo & apenas planos Premium.For consumption & Premium plans only. Cadeia de conexão para a conta de armazenamento na qual o código do aplicativo de funções e a configuração são armazenados.Connection string for storage account where the function app code and configuration are stored. Consulte Criar um aplicativo de funções.See Create a function app.

ChaveKey Valor de exemploSample value
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE

Para consumo & apenas planos Premium.For consumption & Premium plans only. O caminho do arquivo para o código do aplicativo de funções e a configuração.The file path to the function app code and configuration. Usado com WEBSITE_CONTENTAZUREFILECONNECTIONSTRING.Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. O padrão é uma cadeia única que começa com o nome do aplicativo de funções.Default is a unique string that begins with the function app name. Consulte Criar um aplicativo de funções.See Create a function app.

ChaveKey Valor de exemploSample value
WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE functionapp091999e2functionapp091999e2

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

O número máximo de instâncias que o aplicativo de funções pode alcançar.The maximum number of instances that the function app can scale out to. O padrão é sem limites.Default is no limit.

Observação

Essa configuração é uma versão prévia do recurso - e só confiável se definido como um valor < = 5This setting is a preview feature - and only reliable if set to a value <= 5

ChaveKey Valor de exemploSample value
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 55

WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION

Somente Windows.Windows only.
Define a versão do node. js a ser usada ao executar seu aplicativo de funções no Windows.Sets the version of Node.js to use when running your function app on Windows. Você deve usar um til (~) para que o tempo de execução use a versão mais recente disponível da versão principal de destino.You should use a tilde (~) to have the runtime use the latest available version of the targeted major version. Por exemplo, quando definido como ~10, a versão mais recente do node. js 10 é usada.For example, when set to ~10, the latest version of Node.js 10 is used. Quando uma versão principal é destinada a um til, você não precisa atualizar manualmente a versão secundária.When a major version is targeted with a tilde, you don't have to manually update the minor version.

ChaveKey Valor de exemploSample value
WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION ~ 10~10

SITE_EXECUTAR_DO_PACOTEWEBSITE_RUN_FROM_PACKAGE

Permite que seu aplicativo de funções execute de um arquivo de pacote montado.Enables your function app to run from a mounted package file.

ChaveKey Valor de exemploSample value
SITE_EXECUTAR_DO_PACOTEWEBSITE_RUN_FROM_PACKAGE 11

Os valores válidos são 1 ou uma URL que resolve para o local de um arquivo de pacote de implantação.Valid values are either a URL that resolves to the location of a deployment package file, or 1. Quando definido como 1, o pacote deve estar na pasta d:\home\data\SitePackages.When set to 1, the package must be in the d:\home\data\SitePackages folder. Ao usar a implantação em zip com essa configuração, o pacote é automaticamente carregado para esse local.When using zip deployment with this setting, the package is automatically uploaded to this location. Na versão prévia, essa configuração foi nomeada WEBSITE_RUN_FROM_ZIP.In preview, this setting was named WEBSITE_RUN_FROM_ZIP. Para obter mais informações, veja Executar suas funções de um arquivo de pacote.For more information, see Run your functions from a package file.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Por padrão, os proxies de funções utilizarão um atalho para enviar chamadas à API de proxies diretamente para funções no mesmo aplicativo de funções, em vez de criar uma nova solicitação 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. Essa configuração permite que você desabilite esse comportamento.This setting allows you to disable that behavior.

ChaveKey ValorValue DESCRIÇÃODescription
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL verdadeirotrue Chamadas com uma URL de back-end apontando para uma função no Aplicativo de funções local não serão mais enviadas diretamente à função e, em vez disso, serão direcionadas de volta para o front-end HTTP para o Aplicativo de funçõesCalls 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 Esse é o valor padrão.This is the default value. Chamadas com uma URL de back-end apontando para uma função no Aplicativo de Funções local serão encaminhadas diretamente para essa FunçãoCalls 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

Essa configuração controla se %2F é decodificado como barras nos parâmetros de rota quando inseridos na URL de back-end.This setting controls whether %2F is decoded as slashes in route parameters when they are inserted into the backend URL.

ChaveKey ValorValue DESCRIÇÃODescription
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES verdadeirotrue Os parâmetros de rota com barras codificadas os terão decodificados.Route parameters with encoded slashes will have them decoded. example.com/api%2ftest se tornará 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 Esse é o comportamento padrão.This is the default behavior. Todos os parâmetros de rota serão passados inalteradosAll route parameters will be passed along unchanged

ExemploExample

Aqui, está um exemplo de proxy.json em um aplicativo de funções no myfunction.com da URLHere 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}"
        }
    }
}
Decodificação URLURL Decoding EntradaInput SaídaOutput
verdadeirotrue 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

Próximas etapasNext steps

Saiba como atualizar as configurações do aplicativoLearn how to update app settings

Consulte as configurações globais no arquivo host.jsonSee global settings in the host.json file

Consulte outras configurações de aplicativo para aplicativos do Serviço de AplicativoSee other app settings for App Service apps