Alkalmazásbeállítások referenciája Azure FunctionsApp settings reference for Azure Functions

A Function alkalmazásban az Alkalmazásbeállítások olyan globális konfigurációs beállításokat tartalmaznak, amelyek az adott Function alkalmazás összes funkcióját érintik.App settings in a function app contain global configuration options that affect all functions for that function app. Helyileg futtatva ezek a beállítások helyi környezeti változókkéntérhetők el.When you run locally, these settings are accessed as local environment variables. Ez a cikk a Function apps alkalmazásban elérhető Alkalmazásbeállítások listáját tartalmazza.This article lists the app settings that are available in function apps.

A Function app-beállítások több módon is hozzáadhatók, frissíthetők és törölhetők:There are several ways that you can add, update, and delete function app settings:

A Host. JSON fájlban és a Local. Settings. JSON fájlban más globális konfigurációs lehetőségek is vannak.There are other global configuration options in the host.json file and in the local.settings.json file.

APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY

A Application Insights kialakítási kulcs, ha Application Insights használ.The Application Insights instrumentation key if you're using Application Insights. Lásd: figyelő Azure functions.See Monitor Azure Functions.

JelmagyarázatKey MintaértékSample value
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY 5dbdd5e9-af77-484b-9032-64f83bb83bb5dbdd5e9-af77-484b-9032-64f83bb83bb

AZURE_FUNCTIONS_ENVIRONMENTAZURE_FUNCTIONS_ENVIRONMENT

A functions Runtime 2. x verziójában a futásidejű környezet alapján konfigurálja az alkalmazás viselkedését.In version 2.x of the Functions runtime, configures app behavior based on the runtime environment. Az inicializálás soránez az érték olvasható.This value is read during initialization. Bármilyen értékre beállíthatja a AZURE_FUNCTIONS_ENVIRONMENTt, de három érték támogatott: fejlesztés, előkészítésés éles környezet.You can set AZURE_FUNCTIONS_ENVIRONMENT to any value, but three values are supported: Development, Staging, and Production. Ha AZURE_FUNCTIONS_ENVIRONMENT nincs beállítva, az alapértelmezett érték Development helyi környezetben, és Production az Azure-ban.When AZURE_FUNCTIONS_ENVIRONMENT isn't set, it defaults to Development on a local environment and Production on Azure. A futásidejű környezet beállítása ASPNETCORE_ENVIRONMENT helyett ezt a beállítást kell használni.This setting should be used instead of ASPNETCORE_ENVIRONMENT to set the runtime environment.

AzureWebJobsDashboardAzureWebJobsDashboard

Opcionális Storage-fiókhoz tartozó kapcsolatok karakterlánca a naplók tárolásához és megjelenítéséhez a portál figyelés lapján.Optional storage account connection string for storing logs and displaying them in the Monitor tab in the portal. A Storage-fióknak olyan általános célúnak kell lennie, amely támogatja a blobokat, a várólistákat és a táblákat.The storage account must be a general-purpose one that supports blobs, queues, and tables. Lásd a Storage-fiókra és a Storage-fiókra vonatkozó követelményeket.See Storage account and Storage account requirements.

JelmagyarázatKey MintaértékSample value
AzureWebJobsDashboardAzureWebJobsDashboard DefaultEndpointsProtocol = https; AccountName = [név]; AccountKey = [kulcs]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

Tipp

A teljesítmény és a használhatóság érdekében ajánlott a APPINSIGHTS_INSTRUMENTATIONKEY és az alkalmazás-megállapítások használata a figyeléshez a AzureWebJobsDashboard helyettFor performance and experience, it is recommended to use APPINSIGHTS_INSTRUMENTATIONKEY and App Insights for monitoring instead of AzureWebJobsDashboard

AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage

true azt jelenti, hogy letiltja a Function app gyökerének URL-címéhez tartozó alapértelmezett kezdőlapot.true means disable the default landing page that is shown for the root URL of a function app. Az alapértelmezett érték a false.Default is false.

JelmagyarázatKey MintaértékSample value
AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage igaztrue

Ha ez az Alkalmazásbeállítások ki van hagyva vagy a falseértékre van állítva, az URL <functionappname>.azurewebsites.net-címre adott válaszban az alábbi példához hasonló oldal jelenik meg.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.

Function app kezdőlapja

AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation

true azt jelenti, hogy a kiadási módot használja a .NET-kód fordításakor; false a hibakeresési mód használatát jelenti.true means use Release mode when compiling .NET code; false means use Debug mode. Az alapértelmezett érték a true.Default is true.

JelmagyarázatKey MintaértékSample value
AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation igaztrue

AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags

Az engedélyezni kívánt béta-funkciók vesszővel tagolt listája.A comma-delimited list of beta features to enable. A jelzők által engedélyezett béta-funkciók nem állnak készen a gyártásra, de a kísérleti használatra engedélyezhető a működésük előtt.Beta features enabled by these flags are not production ready, but can be enabled for experimental use before they go live.

JelmagyarázatKey MintaértékSample value
AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags feature1,feature2feature1,feature2

AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType

Megadja a kulcstárolóhoz használandó tárházat vagy szolgáltatót.Specifies the repository or provider to use for key storage. Jelenleg a támogatott adattárak a blob Storage (blob) és a helyi fájlrendszer ("fájlok").Currently, the supported repositories are blob storage ("Blob") and the local file system ("Files"). Az alapértelmezett érték a blob a 2. és a fájlrendszerben az 1. verzióban.The default is blob in version 2 and file system in version 1.

JelmagyarázatKey MintaértékSample value
AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType FájlokFiles

AzureWebJobsStorageAzureWebJobsStorage

A Azure Functions futtatókörnyezet ezt a Storage-fiókhoz tartozó kapcsolatok sztringjét használja az összes függvényhez, kivéve a HTTP által aktivált függvények esetében.The Azure Functions runtime uses this storage account connection string for all functions except for HTTP triggered functions. A Storage-fióknak olyan általános célúnak kell lennie, amely támogatja a blobokat, a várólistákat és a táblákat.The storage account must be a general-purpose one that supports blobs, queues, and tables. Lásd a Storage-fiókra és a Storage-fiókra vonatkozó követelményeket.See Storage account and Storage account requirements.

JelmagyarázatKey MintaértékSample value
AzureWebJobsStorageAzureWebJobsStorage DefaultEndpointsProtocol = https; AccountName = [név]; AccountKey = [kulcs]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath

Az írógéppel használt fordító elérési útja.Path to the compiler used for TypeScript. Lehetővé teszi az alapértelmezett érték felülbírálását, ha szükséges.Allows you to override the default if you need to.

JelmagyarázatKey MintaértékSample value
AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath %HOME%\typescript%HOME%\typescript

FUNCTION_alkalmazás__mód szerkesztéseFUNCTION_APP_EDIT_MODE

Azt diktálja, hogy engedélyezve van-e a Azure Portal szerkesztése.Dictates whether editing in the Azure portal is enabled. Az érvényes értékek: "READWRITE" és "ReadOnly".Valid values are "readwrite" and "readonly".

JelmagyarázatKey MintaértékSample value
FUNCTION_alkalmazás__mód szerkesztéseFUNCTION_APP_EDIT_MODE ReadOnlyreadonly

FÜGGVÉNYEK_BŐVÍTMÉNY_verziójaFUNCTIONS_EXTENSION_VERSION

A Function alkalmazásban használni kívánt functions futtatókörnyezet verziója.The version of the Functions runtime to use in this function app. A nagyobb verziószámú tilde a főverzió legújabb verzióját használja (például "~ 2").A tilde with major version means use the latest version of that major version (for example, "~2"). Ha az azonos főverzióhoz tartozó új verziók elérhetők, a rendszer automatikusan telepíti őket a Function alkalmazásba.When new versions for the same major version are available, they are automatically installed in the function app. Az alkalmazás egy adott verzióra való rögzítéséhez használja a teljes verziószámot (például "2.0.12345").To pin the app to a specific version, use the full version number (for example, "2.0.12345"). Az alapértelmezett érték a "~ 2".Default is "~2". ~1 az alkalmazás a futtatókörnyezet 1. x verziójára való PIN-kód.A value of ~1 pins your app to version 1.x of the runtime.

JelmagyarázatKey MintaértékSample value
FÜGGVÉNYEK_BŐVÍTMÉNY_verziójaFUNCTIONS_EXTENSION_VERSION ~ 2~2

FUNCTIONs_WORKer_folyamat_DARABSZÁMFUNCTIONS_WORKER_PROCESS_COUNT

Meghatározza a nyelvi munkavégző folyamatok maximális számát 1alapértelmezett értékkel.Specifies the maximum number of language worker processes, with a default value of 1. A maximálisan megengedett érték 10.The maximum value allowed is 10. A függvények meghívása egyenletesen oszlik meg a nyelvi munkavégző folyamatok között.Function invocations are evenly distributed among language worker processes. A nyelv munkavégző folyamatai 10 másodpercenként vannak elindítva, amíg a függvények száma_a feldolgozó_a folyamat_a szám elérte a száma értéket.Language worker processes are spawned every 10 seconds until the count set by FUNCTIONS_WORKER_PROCESS_COUNT is reached. Több nyelvi feldolgozó folyamat használata nem ugyanaz, mint a skálázás.Using multiple language worker processes is not the same as scaling. Akkor érdemes ezt a beállítást használni, ha a számítási feladathoz CPU-kötésű és I/O-kötésű hívás is tartozik.Consider using this setting when your workload has a mix of CPU-bound and I/O-bound invocations. Ez a beállítás az összes non-.NET nyelvre vonatkozik.This setting applies to all non-.NET languages.

JelmagyarázatKey MintaértékSample value
FUNCTIONs_WORKer_folyamat_DARABSZÁMFUNCTIONS_WORKER_PROCESS_COUNT 22

FUNCTIONs_WORKer_RUNTIMEFUNCTIONS_WORKER_RUNTIME

A Function alkalmazásban betölteni kívánt nyelvi feldolgozó futtatókörnyezet.The language worker runtime to load in the function app. Ez megfelel az alkalmazásban használt nyelvnek (például "DotNet").This will correspond to the language being used in your application (for example, "dotnet"). A függvények több nyelven is közzétehető több alkalmazásban, amelyek mindegyike egy megfelelő munkavégző futásidejű értékkel rendelkezik.For functions in multiple languages you will need to publish them to multiple apps, each with a corresponding worker runtime value. Az érvényes értékek: dotnetC#(F#/), node (JavaScript/írógéppel), java (Java), powershell (PowerShell) és python (Python).Valid values are dotnet (C#/F#), node (JavaScript/TypeScript), java (Java), powershell (PowerShell), and python (Python).

JelmagyarázatKey MintaértékSample value
FUNCTIONs_WORKer_RUNTIMEFUNCTIONS_WORKER_RUNTIME DotNetdotnet

WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Csak a prémium csomagok fogyasztása &.For consumption & Premium plans only. A Storage-fiókhoz tartozó, a Function app-kód és a konfiguráció tárolására szolgáló hálózati karakterlánc.Connection string for storage account where the function app code and configuration are stored. Lásd: Function-alkalmazás létrehozása.See Create a function app.

JelmagyarázatKey MintaértékSample value
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol = https; AccountName = [név]; AccountKey = [kulcs]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

WEBHELY_CONTENTSHAREWEBSITE_CONTENTSHARE

Csak a prémium csomagok fogyasztása &.For consumption & Premium plans only. A függvény alkalmazás kódjának és konfigurációjának elérési útja.The file path to the function app code and configuration. A WEBSITE_CONTENTAZUREFILECONNECTIONSTRING használatával használható.Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Az alapértelmezett érték egy egyedi karakterlánc, amely a Function alkalmazás nevével kezdődik.Default is a unique string that begins with the function app name. Lásd: Function-alkalmazás létrehozása.See Create a function app.

JelmagyarázatKey MintaértékSample value
WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE functionapp091999e2functionapp091999e2

WEBHELY_maximális_dinamikus_alkalmazás_SKÁLÁZÁSi_WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Azon példányok maximális száma, amelyeket a Function alkalmazás fel tud skálázásra.The maximum number of instances that the function app can scale out to. Az alapértelmezett érték nem korlát.Default is no limit.

Megjegyzés

Ez a beállítás egy előzetes verziójú szolgáltatás, és csak akkor megbízható, ha értékre van állítva < = 5This setting is a preview feature - and only reliable if set to a value <= 5

JelmagyarázatKey MintaértékSample value
WEBHELY_maximális_dinamikus_alkalmazás_SKÁLÁZÁSi_WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 55

WEBHELY_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION

Csak Windows.Windows only.
Beállítja a Node. js azon verzióját, amelyet a Function alkalmazás Windows rendszeren való futtatásakor használ.Sets the version of Node.js to use when running your function app on Windows. Ha a futásidejű modult használja, használjon egy tilde (~) verziót a célként megadott főverzió legújabb elérhető verziójának használatára.You should use a tilde (~) to have the runtime use the latest available version of the targeted major version. Ha például az ~10értékre van állítva, a Node. js 10 legújabb verziója van használatban.For example, when set to ~10, the latest version of Node.js 10 is used. Ha egy főverziót egy tilde megcéloz, nem kell manuálisan frissítenie a másodlagos verziót.When a major version is targeted with a tilde, you don't have to manually update the minor version.

JelmagyarázatKey MintaértékSample value
WEBHELY_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION ~ 10~10

WEBHELY__futtatása_CSOMAGbólWEBSITE_RUN_FROM_PACKAGE

Lehetővé teszi, hogy a Function alkalmazás egy csatlakoztatott csomagfájl használatával fusson.Enables your function app to run from a mounted package file.

JelmagyarázatKey MintaértékSample value
WEBHELY__futtatása_CSOMAGbólWEBSITE_RUN_FROM_PACKAGE 11

Az érvényes értékek egy URL-cím, amely feloldja a központi telepítési csomag fájljának helyét, vagy 1.Valid values are either a URL that resolves to the location of a deployment package file, or 1. Ha 1re van állítva, a csomagnak a d:\home\data\SitePackages mappában kell lennie.When set to 1, the package must be in the d:\home\data\SitePackages folder. Ha a zip-telepítést ezzel a beállítással használja, a csomag automatikusan erre a helyre lesz feltöltve.When using zip deployment with this setting, the package is automatically uploaded to this location. Az előzetes verzióban a beállítás neve WEBSITE_RUN_FROM_ZIP.In preview, this setting was named WEBSITE_RUN_FROM_ZIP. További információkért lásd: függvények futtatása csomagfájl alapján.For more information, see Run your functions from a package file.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Alapértelmezés szerint a függvények proxyi olyan parancsikont használnak, amely az API-hívásokat közvetlenül az azonos függvényalkalmazás lévő függvények számára küldi el, nem pedig új HTTP-kérést hoz létre.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. Ezzel a beállítással letilthatja ezt a viselkedést.This setting allows you to disable that behavior.

JelmagyarázatKey Value (Díj)Value LeírásDescription
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL igaztrue A helyi függvényalkalmazás függvényére mutató háttér-URL-címmel rendelkező hívások a továbbiakban nem lesznek közvetlenül a függvénynek elküldve, és helyette a függvényalkalmazás a HTTP-kezelőfelületre lesznek irányítva.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 hamisfalse Ez az alapértelmezett érték.This is the default value. A helyi függvényalkalmazás függvényére mutató háttérbeli URL-címmel rendelkező hívások közvetlenül erre a függvényre lesznek továbbítvaCalls 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

Ezzel a beállítással megadható, hogy a (z)% 2F dekódolva van-e a háttérbeli URL-címekbe illesztett útvonal-paraméterekben.This setting controls whether %2F is decoded as slashes in route parameters when they are inserted into the backend URL.

JelmagyarázatKey Value (Díj)Value LeírásDescription
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES igaztrue A kódolt perjelekkel ellátott útválasztási paraméterek dekódolva lesznek.Route parameters with encoded slashes will have them decoded. example.com/api%2ftest lesz 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 hamisfalse Ez az alapértelmezett viselkedés.This is the default behavior. A rendszer az összes útvonal paraméterét változatlanul adja átAll route parameters will be passed along unchanged

PéldaExample

Íme egy példa a proxys. JSON fájlra az URL-myfunction.com található Function alkalmazásban.Here 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-dekódolásURL Decoding Input (Bemenet)Input KimenetOutput
igaztrue myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test/apiexample.com/test/api
hamisfalse myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test%2fapiexample.com/test%2fapi

Következő lépésekNext steps

Ismerje meg, hogyan frissítheti az alkalmazás beállításaitLearn how to update app settings

Lásd: globális beállítások a Host. JSON fájlbanSee global settings in the host.json file

További Alkalmazásbeállítások App Service alkalmazásokhozSee other app settings for App Service apps