Referencia de configuración de aplicación para Azure FunctionsApp settings reference for Azure Functions

La configuración de la aplicación en una aplicación de función contiene opciones de configuración global que afectan a todas las funciones de dicha aplicación.App settings in a function app contain global configuration options that affect all functions for that function app. Cuando se ejecuta localmente, se accede a esta configuración como variables de entorno locales.When you run locally, these settings are accessed as local environment variables. Este artículo incluye una lista de las opciones de configuración disponibles en las aplicaciones de funciones.This article lists the app settings that are available in function apps.

Hay varias maneras de agregar, actualizar y eliminar opciones de configuración de la aplicación de función:There are several ways that you can add, update, and delete function app settings:

Hay otras opciones de configuración global en el archivo host.json y en local.settings.json.There are other global configuration options in the host.json file and in the local.settings.json file.

APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY

Clave de instrumentación de Application Insights si usa dicho servicio.The Application Insights instrumentation key if you're using Application Insights. Consulte Supervisar Azure Functions.See Monitor Azure Functions.

ClaveKey Valor de ejemploSample value
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY 5dbdd5e9-af77-484b-9032-64f83bb83bb5dbdd5e9-af77-484b-9032-64f83bb83bb

AzureWebJobsDashboardAzureWebJobsDashboard

Cadena de conexión de la cuenta de almacenamiento opcional para almacenar los registros y mostrarlos en la pestaña Monitor del portal.Optional storage account connection string for storing logs and displaying them in the Monitor tab in the portal. La cuenta de almacenamiento debe ser una de uso general que admite blobs, colas y tablas.The storage account must be a general-purpose one that supports blobs, queues, and tables. Consulte Almacenamiento de la cuenta y Requisitos de almacenamiento de la cuenta.See Storage account and Storage account requirements.

ClaveKey Valor de ejemploSample value
AzureWebJobsDashboardAzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=[nombre];AccountKey=[clave]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

Sugerencia

Por motivos de rendimiento y experiencia, se recomienda utilizar APPINSIGHTS_INSTRUMENTATIONKEY y App Insights para la supervisión, en lugar de AzureWebJobsDashboard.For performance and experience, it is recommended to use APPINSIGHTS_INSTRUMENTATIONKEY and App Insights for monitoring instead of AzureWebJobsDashboard

AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage

true significa deshabilitar la página de aterrizaje predeterminada que se muestra para la dirección URL raíz de una aplicación de función.true means disable the default landing page that is shown for the root URL of a function app. El valor predeterminado es false.Default is false.

ClaveKey Valor de ejemploSample value
AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage truetrue

Cuando esta configuración de la aplicación se omite o se establece en false, una página similar a la del siguiente ejemplo se muestra en respuesta a la dirección 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 aterrizaje de la aplicación de función

AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation

true significa utilizar el modo de versión cuando se compila código .NET y false significa utilizar el modo de depuración.true means use Release mode when compiling .NET code; false means use Debug mode. El valor predeterminado es true.Default is true.

ClaveKey Valor de ejemploSample value
AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation truetrue

AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags

Una lista delimitada por comas de características de la versión beta que se van a habilitar.A comma-delimited list of beta features to enable. Las características de la versión beta habilitadas por estas marcas no están listas para la producción, pero se pueden habilitar para su uso experimental antes de su publicación.Beta features enabled by these flags are not production ready, but can be enabled for experimental use before they go live.

ClaveKey Valor de ejemploSample value
AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags feature1,feature2feature1,feature2

AzureWebJobsScriptRootAzureWebJobsScriptRoot

Ruta de acceso al directorio raíz donde se encuentran las carpetas de función y el archivo host.json.The path to the root directory where the host.json file and function folders are located. En una aplicación de función, el valor predeterminado es %HOME%\site\wwwroot.In a function app, the default is %HOME%\site\wwwroot.

ClaveKey Valor de ejemploSample value
AzureWebJobsScriptRootAzureWebJobsScriptRoot %HOME%\site\wwwroot%HOME%\site\wwwroot

AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType

Especifica el repositorio o el proveedor que se utilizará para el almacenamiento de claves.Specifies the repository or provider to use for key storage. Actualmente, los repositorios admitidos son almacenamiento de blobs ("Blob") y sistema de archivos local ("Files").Currently, the supported repositories are blob storage ("Blob") and the local file system ("Files"). El valor predeterminado es blob en la versión 2 y sistema de archivos en la versión 1.The default is blob in version 2 and file system in version 1.

ClaveKey Valor de ejemploSample value
AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType ArchivosFiles

AzureWebJobsStorageAzureWebJobsStorage

El tiempo de ejecución de Azure Functions usa esta cadena de conexión de la cuenta de almacenamiento para todas las funciones, salvo en el caso de las desencadenadas de HTTP.The Azure Functions runtime uses this storage account connection string for all functions except for HTTP triggered functions. La cuenta de almacenamiento debe ser una de uso general que admite blobs, colas y tablas.The storage account must be a general-purpose one that supports blobs, queues, and tables. Consulte Almacenamiento de la cuenta y Requisitos de almacenamiento de la cuenta.See Storage account and Storage account requirements.

ClaveKey Valor de ejemploSample value
AzureWebJobsStorageAzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=[nombre];AccountKey=[clave]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath

Ruta de acceso al compilador que se usa para TypeScript.Path to the compiler used for TypeScript. Le permite reemplazar el valor predeterminado si lo necesita.Allows you to override the default if you need to.

ClaveKey Valor de ejemploSample value
AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath %HOME%\typescript%HOME%\typescript

MODO DE_EDICIÓN DE_LA APLICACIÓN DE_FUNCIÓNFUNCTION_APP_EDIT_MODE

Determina si está habilitada la edición en el portal de Azure.Dictates whether editing in the Azure portal is enabled. Los valores válidos son "readwrite" y "readonly".Valid values are "readwrite" and "readonly".

ClaveKey Valor de ejemploSample value
MODO DE_EDICIÓN DE_LA APLICACIÓN DE_FUNCIÓNFUNCTION_APP_EDIT_MODE readonlyreadonly

VERSIÓN DE LA _EXTENSIÓN_ DE FUNCTIONSFUNCTIONS_EXTENSION_VERSION

La versión del tiempo de ejecución de Functions para usar en esta aplicación de función.The version of the Functions runtime to use in this function app. Una tilde con la versión principal significa utilizar la versión más reciente de esa versión principal (por ejemplo, "~2").A tilde with major version means use the latest version of that major version (for example, "~2"). Cuando haya disponibles versiones nuevas de la misma versión principal, se instalarán automáticamente en la aplicación de función.When new versions for the same major version are available, they are automatically installed in the function app. Para anclar la aplicación a una versión específica, use el número completo de la versión (por ejemplo, "2.0.12345").To pin the app to a specific version, use the full version number (for example, "2.0.12345"). El valor predeterminado es "~2".Default is "~2". Un valor de ~1 ancla la aplicación a la versión 1.x del tiempo de ejecución.A value of ~1 pins your app to version 1.x of the runtime.

ClaveKey Valor de ejemploSample value
VERSIÓN DE LA _EXTENSIÓN_ DE FUNCTIONSFUNCTIONS_EXTENSION_VERSION ~2~2

FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME

Tiempo de ejecución del trabajo del lenguaje que se cargará en la aplicación de función.The language worker runtime to load in the function app. Se corresponderá con el lenguaje usado en la aplicación (por ejemplo, "dotnet").This will correspond to the language being used in your application (for example, "dotnet"). Para las funciones en varios lenguajes deberá publicarlas en varias aplicaciones, cada una con un valor de tiempo de ejecución de trabajo correspondiente.For functions in multiple languages you will need to publish them to multiple apps, each with a corresponding worker runtime value. Los valores válidos son dotnet (C#/F#), node (JavaScript/TypeScript) java (Java), powershell (PowerShell), y python (Python).Valid values are dotnet (C#/F#), node (JavaScript/TypeScript), java (Java), powershell (PowerShell), and python (Python).

ClaveKey Valor de ejemploSample value
FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME dotnetdotnet

WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Solo para los planes de consumo.For consumption plans only. Cadena de conexión para la cuenta de almacenamiento donde se almacenan el código de aplicación de función y la configuración.Connection string for storage account where the function app code and configuration are stored. Consulte Creación de una aplicación de función.See Create a function app.

ClaveKey Valor de ejemploSample value
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=[nombre];AccountKey=[clave]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE

Solo para los planes de consumo.For consumption plans only. Ruta de acceso del archivo para el código de la aplicación de función y la configuración.The file path to the function app code and configuration. Se usa con WEBSITE_CONTENTAZUREFILECONNECTIONSTRING.Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. El valor predeterminado es una cadena única que comienza con el nombre de aplicación de función.Default is a unique string that begins with the function app name. Consulte Creación de una aplicación de función.See Create a function app.

ClaveKey Valor de ejemploSample value
WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE functionapp091999e2functionapp091999e2

ESCALABILIDAD_HORIZONTAL_MÁXIMA_DE LA_APLICACIÓN_DINÁMICAWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Número máximo de instancias al que se puede escalar horizontalmente la aplicación de función.The maximum number of instances that the function app can scale out to. El valor predeterminado es sin límite.Default is no limit.

Nota

Este ajuste es una característica en vista previa, que solo es confiable si se establece en un valor <= 5This setting is a preview feature - and only reliable if set to a value <= 5

ClaveKey Valor de ejemploSample value
ESCALABILIDAD_HORIZONTAL_MÁXIMA_DE LA_APLICACIÓN_DINÁMICAWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 55

DEFAULT_VERSION_DEL NODO_DEL SITIO WEBWEBSITE_NODE_DEFAULT_VERSION

El valor predeterminado es "8.11.1".Default is "8.11.1".

ClaveKey Valor de ejemploSample value
DEFAULT_VERSION_DEL NODO_DEL SITIO WEBWEBSITE_NODE_DEFAULT_VERSION 8.11.18.11.1

WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE

Permite que la aplicación de función se ejecute desde un archivo de paquete montado.Enables your function app to run from a mounted package file.

ClaveKey Valor de ejemploSample value
WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE 11

Los valores válidos son una dirección URL que se resuelve en la ubicación de un archivo de paquete de implementación o 1.Valid values are either a URL that resolves to the location of a deployment package file, or 1. Cuando se establece en 1, el paquete debe estar en la carpeta d:\home\data\SitePackages.When set to 1, the package must be in the d:\home\data\SitePackages folder. Cuando se usa la implementación de ZIP con esta configuración, el paquete se carga automáticamente en esta ubicación.When using zip deployment with this setting, the package is automatically uploaded to this location. En la versión preliminar, este ajuste se denomina WEBSITE_RUN_FROM_ZIP.In preview, this setting was named WEBSITE_RUN_FROM_ZIP. Para más información, vea Run your functions from a package file (Ejecución de Azure Functions desde un archivo de paquete).For more information, see Run your functions from a package file.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

De forma predeterminada, las proxies de Functions usarán accesos directos para enviar llamadas de API desde servidores proxy directamente a funciones en la misma instancia de Function App, en lugar de crear una nueva solicitud 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. Esta configuración le permite deshabilitar este comportamiento.This setting allows you to disable that behavior.

ClaveKey ValorValue DESCRIPCIÓNDescription
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL truetrue Las llamadas con una dirección URL de back-end que señala a una instancia de Function App local ya no se enviarán directamente a la función y, en su lugar, se dirigirán al front-end HTTP para la instancia de Function App.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 Este es el valor predeterminado.This is the default value. Las llamadas con una dirección URL de back-end que señale a una instancia de Function App local se reenviarán directamente a esa función.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

Esta opción de configuración controla si se descodifica %2F como barras diagonales en los parámetros de ruta cuando se insertan en la URL del back-end.This setting controls whether %2F is decoded as slashes in route parameters when they are inserted into the backend URL.

ClaveKey ValorValue DESCRIPCIÓNDescription
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES truetrue Los parámetros de ruta con barras diagonales codificadas los descodificarán.Route parameters with encoded slashes will have them decoded. example.com/api%2ftest se convertirá en 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 Este es el comportamiento predeterminado.This is the default behavior. Todos los parámetros de ruta se pasarán sin cambiosAll route parameters will be passed along unchanged

EjemploExample

Este es un ejemplo de proxies.json en una aplicación de función en la dirección 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}"
        }
    }
}
Descodificación de URLURL Decoding EntradaInput SalidaOutput
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

Pasos siguientesNext steps

Obtenga información acerca de cómo actualizar la configuración de la aplicaciónLearn how to update app settings

Consulte la configuración global en el archivo host.jsonSee global settings in the host.json file

Consulte otros valores de aplicación para aplicaciones de App ServiceSee other app settings for App Service apps