Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Programinställningar i en funktionsapp innehåller konfigurationsalternativ som påverkar alla funktioner för funktionsappen. De här inställningarna används som miljövariabler. I den här artikeln visas de appinställningar som är tillgängliga i funktionsappar.
Det finns flera sätt att lägga till, uppdatera och ta bort funktionsappinställningar:
Ändringar i funktionsappsinställningarna kräver att funktionsappen startas om.
I den här artikeln trunkateras värdena för anslutningssträngar för läsbarhet.
Azure Functions använder Azure App Service-plattformen som värd. Du kan hitta vissa inställningar som är relevanta för att vara värd för funktionsappen i Miljövariabler och appinställningar i Azure App Service.
Överväganden för appinställning
När du använder appinställningar bör du vara medveten om följande:
Ändringar i funktionsappsinställningarna kräver att funktionsappen startas om.
I inställningsnamn betraktas dubbla understreck (
__) och kolon (:) som reserverade värden. Dubbla understreck tolkas som hierarkiska avgränsare i både Windows och Linux. Kolon tolkas på samma sätt endast på Windows. InställningenAzureFunctionsWebHost__hostid=somehost_123456tolkas till exempel som följande JSON-objekt:"AzureFunctionsWebHost": { "hostid": "somehost_123456" }I den här artikeln används endast dubbla understreck eftersom de stöds på båda operativsystemen. De flesta inställningar som stöder hanterade identitetsanslutningar använder dubbla understreck.
När funktioner körs lokalt anges appinställningar i
Valuessamlingen i local.settings.json.Det finns andra konfigurationsalternativ för funktionsappar i host.json-filenoch i filen local.settings.json.
Du kan använda programinställningar för att åsidosätta host.json inställningsvärden utan att behöva ändra själva host.json-filen. Den här metoden är användbar för scenarier där du behöver konfigurera eller ändra specifika host.json inställningar för en viss miljö. Med den här metoden kan du också ändra host.json inställningar utan att behöva publicera om projektet. Mer information finns i referensartikeln host.json.
Den här artikeln dokumenterar de inställningar som är mest relevanta för dina funktionsappar. Eftersom Azure Functions körs på App Service stöds även andra programinställningar. Mer information finns i Miljövariabler och appinställningar i Azure App Service.
Vissa scenarier kräver också att du arbetar med inställningar som dokumenteras i App Service-webbplatsinställningar.
Om du ändrar skrivskyddadeApp Service-programinställningar kan det göra att funktionsappen slutar svara.
Var försiktig när du uppdaterar programinställningarna med hjälp av REST-API:er, inklusive ARM-mallar. Eftersom dessa API:er ersätter de befintliga programinställningarna måste du inkludera alla befintliga inställningar när du lägger till eller ändrar inställningar med hjälp av REST-API:er eller ARM-mallar. När det är möjligt kan du använda Azure CLI eller Azure PowerShell för att programmatiskt arbeta med programinställningar. Mer information finns i Arbeta med programinställningar.
APPINSIGHTS_INSTRUMENTATIONKEY
Instrumentationsnyckeln för Application Insights. Använd inte både APPINSIGHTS_INSTRUMENTATIONKEY och APPLICATIONINSIGHTS_CONNECTION_STRING. När det är möjligt, använd APPLICATIONINSIGHTS_CONNECTION_STRING. När Application Insights körs i ett nationellt moln måste du använda APPLICATIONINSIGHTS_CONNECTION_STRING. Mer information finns i Konfigurera övervakning för Azure Functions.
| Key | Exempelvärde |
|---|---|
| APPINSIGHTS_INSTRUMENTATIONKEY | 55555555-af77-484b-9032-64f83bb83bb |
Använd inte både APPINSIGHTS_INSTRUMENTATIONKEY och APPLICATIONINSIGHTS_CONNECTION_STRING. Vi rekommenderar att du använder APPLICATIONINSIGHTS_CONNECTION_STRING.
APPLICATIONINSIGHTS_AUTHENTICATION_STRING
Ger åtkomst till Application Insights med hjälp av Microsoft Entra-autentisering. Använd den här inställningen när du måste ansluta till Din Application Insights-arbetsyta med hjälp av Microsoft Entra-autentisering. Mer information finns i Microsoft Entra-autentisering för Application Insights.
När du använder APPLICATIONINSIGHTS_AUTHENTICATION_STRINGberor det specifika värdet som du anger på typen av hanterad identitet:
| Hanterad identitet | Inställningsvärde |
|---|---|
| System-assigned | Authorization=AAD |
| User-assigned | Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID> |
Det här autentiseringskravet tillämpas på anslutningar från Functions-värden, felsökningsprogram för ögonblicksbilder, profilerare och alla språkspecifika agenter. Om du vill använda den här inställningen måste den hanterade identiteten redan vara tillgänglig för funktionsappen, med en tilldelad roll som motsvarar Monitoring Metrics Publisher.
Note
När du använder APPLICATIONINSIGHTS_AUTHENTICATION_STRING för att ansluta till Application Insights med Microsoft Entra-autentisering bör du även inaktivera lokal autentisering för Application Insights. Den här konfigurationen kräver Microsoft Entra-autentisering för att telemetri ska matas in på din arbetsyta.
APPLICATIONINSIGHTS_CONNECTION_STRING
Anslutningssträng för Application Insights. Använd inte både APPINSIGHTS_INSTRUMENTATIONKEY och APPLICATIONINSIGHTS_CONNECTION_STRING. Vi rekommenderar att du använder APPLICATIONINSIGHTS_CONNECTION_STRING i alla fall. Det är ett krav i följande fall:
- När din funktionsapp kräver de tillagda anpassningar som stöds med hjälp av anslutningssträng
- När Application Insights-instansen körs i ett nationellt moln, vilket kräver en anpassad slutpunkt
Mer information finns i Anslutningssträngar.
| Key | Exempelvärde |
|---|---|
| APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=... |
Om du vill ansluta till Application Insights med Microsoft Entra-autentisering bör du använda APPLICATIONINSIGHTS_AUTHENTICATION_STRING.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL
Important
Azure Functions-proxyservrar var en funktion i versionerna 1.x till 3.x av Azure Functions-körningen. Mer information finns i Functions-proxyservrar.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
Important
Azure Functions-proxyservrar var en funktion i versionerna 1.x till 3.x av Azure Functions-körningen. Mer information finns i Functions-proxyservrar.
AZURE_FUNCTIONS_ENVIRONMENT
Konfigurerar körmiljön värdmiljön för funktionsappen när den körs i Azure. Det här värdet läses under initialisering. Runtime-miljön accepterar endast dessa värden:
| Value | Description |
|---|---|
Production |
Representerar en produktionsmiljö med minskad loggning och fullständiga prestandaoptimeringar. Det här värdet är standardvärdet när AZURE_FUNCTIONS_ENVIRONMENT antingen inte har angetts eller är inställt på ett värde som inte stöds. |
Staging |
Representerar en mellanlagringsmiljö, till exempel när den körs i ett mellanlagringsfack. |
Development |
En utvecklingsmiljö stöder mer utförlig loggning och optimeringar med reducerad prestanda. Azure Functions Core Tools ställer in AZURE_FUNCTIONS_ENVIRONMENT till Development när det körs på din lokala dator. Den här inställningen kan inte åsidosättas i filen local.settings.json. |
Använd den här inställningen i stället för ASPNETCORE_ENVIRONMENT när du behöver ändra körningsmiljön i Azure till något annat än Production. Mer information finns i Miljöbaserad startklass och metoder.
Den här inställningen är inte tillgänglig i version 1.x av Azure Functions körmiljö.
AzureFunctionsJobHost__*
I version 2.x och senare versioner av Functions-körningen kan programinställningar åsidosätta host.json inställningar i den aktuella miljön. Dessa åsidosättningar uttrycks som programinställningar med namnet AzureFunctionsJobHost__path__to__setting. Mer information finns i Åsidosätta värden för host.json.
AzureFunctionsWebHost__hostid
Anger värd-ID för en viss funktionsapp, vilket ska vara ett unikt ID. Den här inställningen åsidosätter det automatiskt genererade värd-ID-värdet för din app. Använd endast den här inställningen när du behöver förhindra kollisioner mellan värd-ID mellan funktionsappar som delar samma lagringskonto.
Ett värd-ID måste uppfylla följande krav:
- Mellan 1 och 32 tecken
- Innehåller endast små bokstäver, siffror och bindestreck
- Starta eller avsluta inte med ett bindestreck
- Innehåller inte på varandra följande bindestreck
Ett enkelt sätt att generera ett ID är att ta ett GUID, ta bort bindestrecken och göra det till gemener, till exempel genom att konvertera GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 till värdet 1835d7b55c984790815d072cc94c6f71.
| Key | Exempelvärde |
|---|---|
| AzureFunctionsWebHost__hostid | myuniquefunctionappname123456789 |
Mer information finns i Överväganden för värd-ID.
AzureWebJobsDashboard
Den här inställningen är inaktuell och stöds endast när den körs på version 1.x av Azure Functions-körningen.
Valfri anslutningssträng för lagringskonto för att lagra loggar och visa dem på fliken Övervaka i Azure-portalen. Lagringskontot måste vara ett allmänt konto som stöder blobar, köer och tabeller. Mer information finns i Krav för lagringskonto.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsDashboard | DefaultEndpointsProtocol=https;AccountName=... |
AzureWebJobsDisableHomepage
Värdet true inaktiverar standardlandningssidan som visas för rot-URL:en för en funktionsapp. Standardvärdet är false.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsDisableHomepage | true |
När den här appinställningen utelämnas eller anges till falsevisas en sida som liknar följande exempel som svar på URL:en <functionappname>.azurewebsites.net.
AzureWebJobsDotNetReleaseCompilation
true innebär användningsläge Release vid kompilering av .NET-kod.
false innebär att du använder felsökningsläge. Standard är true.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsDotNetReleaseCompilation | true |
AzureWebJobsFeatureFlags
En kommaavgränsad lista över betafunktioner som ska aktiveras. Betafunktioner som aktiveras av dessa flaggor är inte produktionsklara, men kan aktiveras för experimentell användning innan de går live.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsFeatureFlags | feature1,feature2,EnableProxies |
Om din app för närvarande har den här inställningen lägger du till nya flaggor i slutet av den kommadefinierade listan.
Funktionsflaggor som stöds för närvarande:
| Flaggvärde | Description |
|---|---|
EnableProxies |
Återaktivera proxyservrar på version 4.x av Functions-körningen medan du planerar migreringen till Azure API Management. Mer information finns i Återaktivera proxyservrar i Functions v4.x. |
EnableAzureMonitorTimeIsoFormat |
Aktiverar tidsformatet ISO 8601 i Azure Monitor-loggar för Linux-appar som körs på en dedikerad plan (App Service). |
AzureWebJobsKubernetesSecretName
Anger den Kubernetes Secrets-resurs som används för att lagra nycklar. Stöds endast vid körning i Kubernetes.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsKubernetesSecretName | <SECRETS_RESOURCE> |
Överväganden när du använder en Kubernetes Secrets-resurs:
- Du måste också ange
AzureWebJobsSecretStorageTypetillkubernetes. NärAzureWebJobsKubernetesSecretNameinte har angetts betraktas lagringsplatsen som skrivskyddad. I det här fallet måste värdena genereras före distributionen. - Azure Functions Core Tools genererar värdena automatiskt när de distribueras till Kubernetes.
- Oföränderliga hemligheter stöds inte och användning av dem resulterar i körningsfel.
Mer information finns i Hantera nyckellagring.
AzureWebJobsSecretStorageKeyVaultClientId
Klient-ID för den användartilldelade hanterade identiteten eller appregistreringen som används för att komma åt valvet där nycklar lagras. Den här inställningen kräver att du anger AzureWebJobsSecretStorageType till keyvault. Stöds i version 4.x och senare versioner av Functions-körningen.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsSecretStorageKeyVaultClientId | <CLIENT_ID> |
Mer information finns i Hantera nyckellagring.
AzureWebJobsSecretStorageKeyVaultClientSecret
Hemligheten för klient-ID för den användartilldelade hanterade identiteten eller appregistreringen som används för att komma åt valvet där nycklar lagras. Den här inställningen kräver att du anger AzureWebJobsSecretStorageType till keyvault. Stöds i version 4.x och senare versioner av Functions-körningen.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsSecretStorageKeyVaultClientSecret | <CLIENT_SECRET> |
Mer information finns i Hantera nyckellagring.
AzureWebJobsSecretStorageKeyVaultName
Den här inställningen är inaktuell och användes endast när den kördes på version 3.x av Azure Functions-körningen.
Namnet på en key vault-instans som används för att lagra nycklar. Den här inställningen användes endast i version 3.x av Functions-körningen, som inte längre stöds. För version 4.x använder du AzureWebJobsSecretStorageKeyVaultUrii stället . Den här inställningen kräver att du anger AzureWebJobsSecretStorageType till keyvault.
Valvet måste ha en åtkomstprincip som motsvarar den systemtilldelade hanterade identiteten för värdresursen. Åtkomstprincipen bör ge identiteten följande hemliga behörigheter: Get,Set, Listoch Delete.
När dina funktioner körs lokalt används utvecklaridentiteten. Inställningarna måste finnas i filenlocal.settings.json.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsSecretStorageKeyVaultName | <VAULT_NAME> |
Mer information finns i Hantera nyckellagring.
AzureWebJobsSecretStorageKeyVaultTenantId
Klient-ID för appregistreringen som används för att komma åt valvet där nycklar lagras. Den här inställningen kräver att du anger AzureWebJobsSecretStorageType till keyvault. Stöds i version 4.x och senare versioner av Functions-körningen. Mer information finns i Hantera nyckellagring.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsSecretStorageKeyVaultTenantId | <TENANT_ID> |
AzureWebJobsSecretStorageKeyVaultUri
URI:n för en key vault-instans som används för att lagra nycklar. Stöds i version 4.x och senare versioner av Functions-körningen. Vi rekommenderar den här inställningen för att använda en key vault-instans för nyckellagring. Den här inställningen kräver att du anger AzureWebJobsSecretStorageType till keyvault.
Värdet AzureWebJobsSecretStorageKeyVaultUri ska vara det fullständiga värdet för Valv-URI som visas på fliken Översikt för Key Vault, inklusive https://.
Valvet måste ha en åtkomstprincip som motsvarar den systemtilldelade hanterade identiteten för värdresursen. Åtkomstprincipen bör ge identiteten följande hemliga behörigheter: Get,Set, Listoch Delete.
När dina funktioner körs lokalt används utvecklaridentiteten och inställningarna måste finnas i filen local.settings.json.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsSecretStorageKeyVaultUri | https://<VAULT_NAME>.vault.azure.net |
Important
Hemligheter är inte begränsade till enskilda funktionsappar via inställningen AzureWebJobsSecretStorageKeyVaultUri . Om flera funktionsappar har konfigurerats för att använda samma Key Vault delar de samma hemligheter, vilket kan leda till nyckelkollisioner eller överskrivningar. För att undvika oavsiktligt beteende rekommenderar vi att du använder en separat Key Vault-instans för varje funktionsapp.
Mer information finns i Hantera nyckellagring.
AzureWebJobsSecretStorageSas
En SAS-URL för Blob Storage för ett andra lagringskonto som används för nyckellagring. Som standard använder Functions kontouppsättningen i AzureWebJobsStorage. När du använder det här alternativet för hemlig lagring kontrollerar du att AzureWebJobsSecretStorageType inte uttryckligen har angetts eller är inställt på blob. Mer information finns i Hantera nyckellagring.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsSecretStorageSas | <BLOB_SAS_URL> |
AzureWebJobsSecretStorageType
Anger den lagringsplats eller provider som ska användas för nyckellagring. Nycklar krypteras alltid innan de lagras med hjälp av en hemlighet som är unik för din funktionsapp.
| Key | Value | Description |
|---|---|---|
| AzureWebJobsSecretStorageType | blob |
Nycklar lagras i en Blob Storage-container i det konto som anges av inställningen AzureWebJobsStorage . Blob Storage är standardbeteendet när AzureWebJobsSecretStorageType inte har angetts.Om du vill ange ett annat lagringskonto använder du inställningen AzureWebJobsSecretStorageSas för att ange SAS-URL:en för ett andra lagringskonto. |
| AzureWebJobsSecretStorageType | files |
Nycklar sparas i filsystemet. Det här beteendet är standard för Functions v1.x. |
| AzureWebJobsSecretStorageType | keyvault |
Nycklar lagras i en key vault-instans som anges av AzureWebJobsSecretStorageKeyVaultName. |
| AzureWebJobsSecretStorageType | kubernetes |
Stöds endast när du kör Functions-körmiljön i Kubernetes. När AzureWebJobsKubernetesSecretName inte har angetts betraktas lagringsplatsen som skrivskyddad. I det här fallet måste värdena genereras före distributionen.
Azure Functions Core Tools genererar värdena automatiskt när de distribueras till Kubernetes. |
Mer information finns i Hantera nyckellagring.
AzureWebJobsStorage
Anger anslutningssträng för ett Azure Storage-konto som Functions-körningen använder för normala åtgärder. Vissa användningar av det här lagringskontot från Functions omfattar nyckelhantering, timerutlösarhantering och kontrollpunkter för händelsehubbar. Lagringskontot måste vara ett allmänt konto som stöder blobar, köer och tabeller. Mer information finns i Krav för lagringskonto.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsStorage | DefaultEndpointsProtocol=https;AccountName=... |
I stället för en anslutningssträng kan du använda en identitetsbaserad anslutning för det här lagringskontot. Mer information finns i Ansluta till värdlagring med en identitet.
AzureWebJobsStorage__accountName
När du använder en identitetsbaserad lagringsanslutning anger du kontonamnet för lagringskontot i stället för att använda anslutningssträng i AzureWebJobsStorage. Den här syntaxen är unik för AzureWebJobsStorage och kan inte användas för andra identitetsbaserade anslutningar.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsStorage__accountName | <STORAGE_ACCOUNT_NAME> |
För nationella moln eller när du använder en anpassad DNS måste du i stället använda de tjänstspecifika AzureWebJobsStorage__*ServiceUri inställningarna.
AzureWebJobsStorage__blobServiceUri
När du använder en identitetsbaserad lagringsanslutning anger du dataplanets URI för blobtjänsten för lagringskontot.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsStorage__blobServiceUri | https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net |
Använd den här inställningen i stället för AzureWebJobsStorage__accountName i nationella moln eller när du använder en anpassad DNS. Mer information finns i Ansluta till värdlagring med en identitet.
AzureWebJobsStorage__clientId
Anger klient-ID för en specifik användartilldelad identitet som används för att hämta en åtkomsttoken för hanterad identitetsautentisering. Kräver att AzureWebJobsStorage__credential anges till managedidentity. Värdet är ett klient-ID som motsvarar en identitet som tilldelats programmet. Du kan inte ange både AzureWebJobsStorage__managedIdentityResourceId och AzureWebJobsStorage__clientId. När den inte har angetts används den systemtilldelade identiteten.
AzureWebJobsStorage__credential
Definierar hur en åtkomsttoken hämtas för anslutningen. Används managedidentity för hanterad identitetsautentisering. När du använder managedidentitymåste en hanterad identitet vara tillgänglig i värdmiljön. Ange inte AzureWebJobsStorage__credential i scenarier för lokal utveckling.
AzureWebJobsStorage__managedIdentityResourceId
Anger resursidentifieraren för en användartilldelad identitet som används för att hämta en åtkomsttoken för hanterad identitetsautentisering. Kräver att AzureWebJobsStorage__credential anges till managedidentity. Värdet är resurs-ID för en identitet som tilldelats till programmet som används för hanterad identitetsautentisering. Du kan inte ange både AzureWebJobsStorage__managedIdentityResourceId och AzureWebJobsStorage__clientId. När den inte har angetts används den systemtilldelade identiteten.
AzureWebJobsStorage__queueServiceUri
När du använder en identitetsbaserad lagringsanslutning anger du dataplanets URI för kötjänsten för lagringskontot.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsStorage__queueServiceUri | https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net |
Använd den här inställningen i stället för AzureWebJobsStorage__accountName i nationella moln eller när du använder en anpassad DNS. Mer information finns i Ansluta till värdlagring med en identitet.
AzureWebJobsStorage__tableServiceUri
När du använder en identitetsbaserad lagringsanslutning anger du dataplans-URI för en tabelltjänst för lagringskontot.
| Key | Exempelvärde |
|---|---|
| AzureWebJobsStorage__tableServiceUri | https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net |
Använd den här inställningen i stället för AzureWebJobsStorage__accountName i nationella moln eller när du använder en anpassad DNS. Mer information finns i Ansluta till värdlagring med en identitet.
AzureWebJobs_TypeScriptPath
Sökväg till kompilatorn som används för TypeScript. Gör att du kan åsidosätta standardvärdet om du behöver.
| Key | Exempelvärde |
|---|---|
| AzureWebJobs_TypeScriptPath | %HOME%\typescript |
DOCKER_REGISTRY_SERVER_PASSWORD
Anger lösenordet som används för att komma åt ett privat containerregister. Den här inställningen krävs bara när du distribuerar din containerbaserade funktionsapp från ett privat containerregister. Mer information finns i Miljövariabler och appinställningar i Azure App Service.
DOCKER_REGISTRY_SERVER_URL
Anger URL:en för ett privat containerregister. Den här inställningen krävs bara när du distribuerar din containerbaserade funktionsapp från ett privat containerregister. Mer information finns i Miljövariabler och appinställningar i Azure App Service.
DOCKER_REGISTRY_SERVER_USERNAME
Anger det konto som används för att komma åt ett privat containerregister. Den här inställningen krävs bara när du distribuerar din containerbaserade funktionsapp från ett privat containerregister. Mer information finns i Miljövariabler och appinställningar i Azure App Service.
DOCKER_SHM_SIZE
Anger den delade minnesstorleken (i byte) när Python-arbetaren använder delat minne. Mer information finns i Delat minne.
| Key | Exempelvärde |
|---|---|
| DOCKER_SHM_SIZE | 268435456 |
Föregående värde anger en delad minnesstorlek på ~256 MB.
Kräver att FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED är inställt på 1.
ENABLE_ORYX_BUILD
Anger om Oryx-byggsystemet används under distributionen.
ENABLE_ORYX_BUILD måste anges till true när du gör fjärrversionsdistributioner till Linux. Mer information finns i Fjärrbygge.
| Key | Exempelvärde |
|---|---|
| ENABLE_ORYX_BUILD | true |
FUNCTION_APP_EDIT_MODE
Anger om du kan redigera funktionsappen i Azure-portalen. Giltiga värden är readwrite och readonly.
| Key | Exempelvärde |
|---|---|
| FUNCTION_APP_EDIT_MODE | readonly |
Körmiljön anger värdet baserat på programmeringsspråkstacken och distributionsstatusen för din funktionsapp. Mer information finns i Utvecklingsbegränsningar i Azure Portal.
FUNCTIONS_EXTENSION_VERSION
Den version av Functions-körningen som är värd för din funktionsapp. En tilde (~) med huvudversion innebär att du använder den senaste versionen av den huvudversionen, ~4till exempel . När nya delversioner av samma huvudversion är tillgängliga installeras de automatiskt i funktionsappen.
| Key | Exempelvärde |
|---|---|
| FUNCTIONS_EXTENSION_VERSION | ~4 |
Följande huvudversionsvärden för körtid stöds:
| Value | Körningstidsmål | Comment |
|---|---|---|
~4 |
4.x | Recommended |
~1 |
1.x | Support upphör den 14 september 2026 |
Ett värde på ~4 betyder att din app körs på version 4.x av körmiljön. Värdet ~1 låser appen till version 1.x av runtime-miljön. Körningsversionerna 2.x och 3.x stöds inte längre. Mer information finns i Översikt över Azure Functions-körningsversioner.
Om det begärs av supporten för att fästa appen på en viss delversion använder du det fullständiga versionsnumret, till exempel 4.0.12345. För mer information, se hur du riktar in dig på Azure Functions-körningsversioner.
FUNCTIONS_INPROC_NET8_ENABLED
Anger om en app kan använda .NET 8 i den pågående modellen. Om du vill använda .NET 8 i den processbaserade modellen måste det här värdet vara inställt på 1. Se Uppdatera till mål .NET 8 för fullständiga instruktioner, inklusive andra nödvändiga konfigurationsvärden.
| Key | Exempelvärde |
|---|---|
| FUNCTIONS_INPROC_NET8_ENABLED | 1 |
Ställ in på 0 för att inaktivera stöd för .NET 8 för den in-process-modellen.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR
Den här appinställningen är ett tillfälligt sätt för att Node.js-appar ska kunna aktivera en brytande ändring som gör det enklare att felsöka fel vid startpunkten på Node.js v18 eller tidigare. Vi rekommenderar starkt att du använder true, särskilt för programmeringsmodell v4-appar, som alltid använder startpunktsfiler. Beteendet utan brytande ändring (false) ignorerar instegspunktsfel och loggar dem inte i Application Insights.
Från och med Node.js v20 har appinställningen ingen effekt och brytningsbeteendet är alltid aktiverat.
För Node.js v18 eller lägre används appinställningen och standardbeteendet beror på om felet inträffar före eller efter att en modell v4-funktion har registrerats:
- Om felet utlöses innan, matchar standardbeteendet
false. Om du till exempel använder modell v3 eller om startpunktsfilen inte finns. - Om felet utlöses efteråt matchar standardbeteendet
true. Om du till exempel försöker registrera duplicerade modell v4-funktioner.
| Key | Value | Description |
|---|---|---|
| FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | true |
Blockera startpunktsfel och logga dem i Application Insights. |
| FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | false |
Ignorera startpunktsfel och logga dem inte i Application Insights. |
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT
Åsidosätter standardgränsen för brödtextstorleken för begäranden som skickas till HTTP-slutpunkter. Värdet anges i byte med en maximal standardstorlek på 104 857 600 byte.
| Key | Exempelvärde |
|---|---|
| FUNCTIONS_REQUEST_BODY_SIZE_LIMIT | 250000000 |
FUNCTIONS_V2_COMPATIBILITY_MODE
Important
Den här inställningen stöds inte längre. Det tillhandahölls ursprungligen för att möjliggöra en kortsiktig lösning för appar som riktade in sig på v2.x-körningen. De skulle i stället kunna köras i v3.x-körmiljön medan den fortfarande stöds. Förutom äldre appar som körs på version 1.x måste alla funktionsappar köras på version 4.x av Functions-körningen: FUNCTIONS_EXTENSION_VERSION=~4. Mer information finns i Översikt över Azure Functions-körningsversioner.
FUNCTIONS_WORKER_PROCESS_COUNT
Anger det maximala antalet språkarbetsprocesser med standardvärdet 1. Det högsta tillåtna värdet är 10. Funktionsanrop fördelas jämnt mellan språkarbetsprocesser. Språkarbetsprocesser skapas var 10:e sekund tills antalet som anges av FUNCTIONS_WORKER_PROCESS_COUNT har uppnåtts. Att använda flera språkarbetsprocesser är inte samma sak som skalning. Överväg att använda den här inställningen när din arbetsbelastning har en blandning av CPU-bundna och I/O-bundna anrop. Den här inställningen gäller för alla språkkörningar, förutom för .NET som körs i processen (FUNCTIONS_WORKER_RUNTIME=dotnet).
| Key | Exempelvärde |
|---|---|
| FUNCTIONS_WORKER_PROCESS_COUNT | 2 |
FUNCTIONS_WORKER_RUNTIME
Språk- eller språkstacken för arbetskörningen som ska läsas in i funktionsappen. Det här värdet motsvarar det språk som används i ditt program, till exempel python. Från och med version 2.x av Azure Functions-körningen kan en viss funktionsapp bara stödja ett enda språk.
| Key | Exempelvärde |
|---|---|
| FUNCTIONS_WORKER_RUNTIME | node |
Giltiga värden:
| Value | Språk-/språkstack |
|---|---|
dotnet |
C# (klassbibliotek) C# (skript) |
dotnet-isolated |
C# (isolerad arbetsprocess) |
java |
Java |
node |
JavaScript TypeScript |
powershell |
PowerShell |
python |
Python |
custom |
Other |
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED
Med den här inställningen kan Python-arbetaren använda delat minne för att förbättra dataflödet. Aktivera delat minne när python-funktionsappen stöter på flaskhalsar i minnet.
| Key | Exempelvärde |
|---|---|
| FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED | 1 |
Med den här inställningen aktiverad kan du använda inställningen DOCKER_SHM_SIZE för att ange storleken på delat minne. Mer information finns i Delat minne.
JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY
Anger om Java-arbetsprocessen ska mata ut telemetri i ett Open Telemetry-format till Application Insights-slutpunkten. Om du anger den här flaggan till True uppmanas Functions-värden att låta Java-arbetaren strömma OpenTelemetry-loggar direkt, vilket förhindrar duplicerade poster på värdnivå. Mer information finns i Konfigurera programinställningar.
JAVA_ENABLE_SDK_TYPES
Gör att din funktionsapp kan använda inbyggda Azure SDK-typer i bindningar.
Note
Stöd för bindning till SDK-typer finns för närvarande i förhandsversion och är begränsat till Azure Blob Storage SDK. Mer information finns i SDK-typer i Java-referensartikeln.
| Key | Exempelvärde |
|---|---|
| JAVA_ENABLE_SDK_TYPES | true |
Mer information finns i SDK-typer i Java-referensartikeln.
JAVA_OPTS
Används för att anpassa den virtuella Java-datorn (JVM) som används för att köra dina Java-funktioner när du kör en Premium-plan eller dedikerad plan. När du kör en förbrukningsplan använder du languageWorkers__java__argumentsi stället . Mer information finns i Anpassa JVM.
languageWorkers__java__arguments
Används för att anpassa den virtuella Java-datorn (JVM) som används för att köra dina Java-funktioner när du kör en förbrukningsplan. Den här inställningen ökar de kalla starttiderna för Java-funktioner som körs i en förbrukningsplan. För en Premium- eller Dedikerad plan använder du JAVA_OPTSi stället . Mer information finns i Anpassa JVM.
MDMaxBackgroundUpgradePeriod
Styr bakgrundsuppdateringsperioden för hanterade beroenden för PowerShell-funktionsappar med standardvärdet 7.00:00:00 (varje vecka).
Varje PowerShell-arbetsprocess initierar sökning efter moduluppgraderingar i PowerShell-galleriet vid processstart och varje MDMaxBackgroundUpgradePeriod efter starten. När en ny modulversion är tillgänglig i PowerShell-galleriet installeras den i filsystemet och görs tillgänglig för PowerShell-arbetare. Om du minskar det här värdet kan funktionsappen få nyare modulversioner tidigare, men det ökar även appresursanvändningen, inklusive nätverks-I/O, CPU och lagring. Om du ökar det här värdet minskar appens resursanvändning, men det kan också fördröja leveransen av nya modulversioner till din app.
| Key | Exempelvärde |
|---|---|
| MDMaxBackgroundUpgradePeriod | 7.00:00:00 |
Mer information finns i Beroendehantering.
MDNewSnapshotCheckPeriod
Anger hur ofta varje PowerShell-arbetare kontrollerar om hanterade beroendeuppgraderingar är installerade. Standardfrekvensen är 01:00:00 (varje timme).
När nya modulversioner har installerats i filsystemet måste varje PowerShell-arbetsprocess startas om. Omstart av PowerShell-workers påverkar appens tillgänglighet eftersom den kan avbryta aktuell funktionskörning. Tills alla PowerShell-arbetsprocesser startas om kan funktionsanrop använda antingen de gamla eller de nya modulversionerna. Omstart av alla PowerShell-arbetare slutförs inom MDNewSnapshotCheckPeriod.
Inom varje MDNewSnapshotCheckPeriodkontrollerar PowerShell-arbetaren om hanterade beroendeuppgraderingar har installerats eller inte. När uppgraderingar installeras initieras en omstart. Om du ökar det här värdet minskar avbrottsfrekvensen på grund av omstarter. Ökningen kan dock också förlänga den tid under vilken funktionsanrop icke-deterministiskt kan använda antingen de gamla eller de nya modulversionerna.
| Key | Exempelvärde |
|---|---|
| MDNewSnapshotCheckPeriod | 01:00:00 |
Mer information finns i Beroendehantering.
MDMinBackgroundUpgradePeriod
Tidsperioden efter en tidigare kontrollerad uppgradering av hanterade beroenden innan en ny uppgraderingskontroll startas, med standardvärdet 1.00:00:00 (dagligen).
För att undvika överdrivna moduluppgraderingar vid frekventa arbetsomstarter utförs inte sökning efter moduluppgraderingar när någon arbetare redan har initierat kontrollen i den senaste MDMinBackgroundUpgradePeriod.
| Key | Exempelvärde |
|---|---|
| MDMinBackgroundUpgradePeriod | 1.00:00:00 |
Mer information finns i Beroendehantering.
OTEL_EXPORTER_OTLP_ENDPOINT
Anger den URL till vilken OpenTelemetry-formaterade data exporteras för inmatning. Mer information finns i Använda OpenTelemetry med Azure Functions.
OTEL_EXPORTER_OTLP_HEADERS
Anger en valfri lista över rubriker som tillämpas på alla utgående data som exporteras till en OpenTelemetry-slutpunkt. Du bör använda den här inställningen när OpenTelemetry-slutpunkten kräver att du anger en API-nyckel. Mer information finns i Använda OpenTelemetry med Azure Functions.
PIP_INDEX_URL
Med den här inställningen kan du åsidosätta bas-URL:en för Python-paketindexet, som som standard är https://pypi.org/simple. Använd den här inställningen när du behöver köra en fjärrversion med hjälp av anpassade beroenden. Dessa anpassade beroenden kan finnas i en paketindexlagringsplats som är kompatibel med PEP 503 (det enkla lagringslagrings-API:et) eller i en lokal katalog som följer samma format.
| Key | Exempelvärde |
|---|---|
| PIP_INDEX_URL | http://my.custom.package.repo/simple |
Mer information finns pip i dokumentationen för --index-url och användning av anpassade beroenden i Python-utvecklarreferensen.
PIP_EXTRA_INDEX_URL
Värdet för den här inställningen anger en extra index-URL för anpassade paket för Python-appar som ska användas utöver --index-url. Använd den här inställningen när du behöver köra en fjärrversion med hjälp av anpassade beroenden som finns i ett extra paketindex. Bör följa samma regler som --index-url.
| Key | Exempelvärde |
|---|---|
| PIP_EXTRA_INDEX_URL | http://my.custom.package.repo/simple |
Mer information finns pip i dokumentationen för --extra-index-url och anpassade beroenden i Python-utvecklarreferensen.
PROJECT
En inställning för kontinuerlig distribution som talar om för Kudu-distributionstjänsten att mappen på en ansluten lagringsplats ska placera det distribuerade projektet.
| Key | Exempelvärde |
|---|---|
| PROJECT | WebProject/WebProject.csproj |
PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY
Anger om Python-arbetsprocessen ska mata ut telemetri i ett Open Telemetry-format till Application Insights-slutpunkten. Om du anger den här flaggan till True uppmanas Functions-värden att låta Python-arbetsprocessen exportera OpenTelemetry-data till Application Insights-slutpunkten. Mer information finns i Konfigurera programinställningar.
PYTHON_ISOLATE_WORKER_DEPENDENCIES
Konfigurationen är specifik för Python-funktionsappar. Den definierar prioriteringen för modulinläsningens ordning. Som standard är det här värdet inställt på 0.
| Key | Value | Description |
|---|---|---|
| PYTHON_ISOLATE_WORKER_DEPENDENCIES | 0 |
Prioritera inläsning av Python-biblioteken från den interna Python-arbetarens beroenden, vilket är standardbeteendet. Icke-Microsoft-bibliotek definierade i requirements.txt kan skuggas. |
| PYTHON_ISOLATE_WORKER_DEPENDENCIES | 1 |
Prioritera inläsning av Python-bibliotek från programmets paket som definierats i requirements.txt. Det här värdet hindrar dina bibliotek från att kollidera med interna Python Worker-bibliotek. |
PYTHON_ENABLE_DEBUG_LOGGING
Aktiverar loggning på felsökningsnivå i en Python-funktionsapp. Ett värde för 1 aktiverar loggning på felsökningsnivå. Utan den här inställningen eller med värdet 0 skickas endast information och loggar av hög nivå från Python-arbetaren till Functions-värden. Använd den här inställningen när du felsöker eller spårar python-funktionskörningar.
När du felsöker Python-funktioner måste du även ange en felsöknings- eller spårningsloggningsnivå i host.json-filen efter behov. Mer information finns i Konfigurera övervakning för Azure Functions.
PYTHON_ENABLE_OPENTELEMETRY
Anger om Python-arbetsprocessen ska exportera telemetri till en öppen telemetrislutpunkt. Om du anger den här flaggan till True uppmanas Functions-värden att låta Python-arbetsprocessen exportera OpenTelemetry-data till den konfigurerade OTEL_EXPORTER_OTLP_ENDPOINT. Mer information finns i Konfigurera programinställningar.
PYTHON_ENABLE_WORKER_EXTENSIONS
Konfigurationen är specifik för Python-funktionsappar. Om du anger det här värdet till 1 kan arbetaren läsa in Python worker-tillägg som definierats i requirements.txt. Det gör att din funktionsapp kan komma åt nya funktioner som tillhandahålls av partnerpaket. Det kan också ändra beteendet för funktionsbelastning och anrop i din app. Se till att det tillägg du väljer är tillförlitligt eftersom du riskerar att använda det. Azure Functions ger inga uttryckliga garantier till några tillägg. Om du vill använda ett tillägg går du till tilläggets manuella sida eller readme-dokument. Som standard anges det här värdet till 0.
| Key | Value | Description |
|---|---|---|
| PYTHON_ENABLE_WORKER_EXTENSIONS | 0 |
Inaktivera alla Python-arbetstillägg. |
| PYTHON_ENABLE_WORKER_EXTENSIONS | 1 |
Tillåt Python Worker att läsa in tillägg från requirements.txt. |
PYTHON_THREADPOOL_THREAD_COUNT
Anger det maximala antalet trådar som en Python-språkarbetare skulle använda för att köra funktionsanrop, med standardvärdet 1 För Python-version 3.8 och nedan. För Python-versionen 3.9 och senare är värdet inställt på None. Den här inställningen garanterar inte det antal trådar som kommer att ställas in under körning. Med inställningen kan Python utöka antalet trådar till det angivna värdet. Inställningen gäller endast för Python-funktionsappar. Dessutom gäller inställningen synkrona funktionsanrop och inte för coroutines.
| Key | Exempelvärde | Maxvärde |
|---|---|---|
| PYTHON_THREADPOOL_THREAD_COUNT | 2 | 32 |
SCALE_CONTROLLER_LOGGING_ENABLED
Den här inställningen är för närvarande i förhandsversion.
Den här inställningen styr loggning från Azure Functions-skalningskontrollanten. Mer information finns i Skala kontrollantloggar.
| Key | Exempelvärde |
|---|---|
| SCALE_CONTROLLER_LOGGING_ENABLED | AppInsights:Verbose |
Värdet för den här nyckeln anges i formatet <DESTINATION>:<VERBOSITY>, som definieras enligt följande:
| Property | Description |
|---|---|
<DESTINATION> |
Målet som loggarna skickas till. Giltiga värden är AppInsights och Blob.När du använder AppInsightskontrollerar du att Application Insights är aktiverat i funktionsappen.När du anger målet till Blobskapas loggar i en blobcontainer med namnet azure-functions-scale-controller i standardlagringskontot som anges i programinställningen AzureWebJobsStorage . |
<VERBOSITY> |
Anger loggningsnivån. Värden som stöds är None, Warningoch Verbose.När värdet är inställt Verbosepå loggar skalningskontrollanten en orsak till varje ändring i antalet arbetare och information om utlösarna som påverkar dessa beslut. Utförliga loggar inkluderar utlösarvarningar och hashvärden som används av utlösarna före och efter att skalningskontrollanten körs. |
Tip
Tänk på att även om du låter skalningskontrollantloggning vara aktiverad påverkar det de potentiella kostnaderna för att övervaka din funktionsapp. Överväg att aktivera loggning tills du samlar in tillräckligt med data för att förstå hur skalningskontrollanten beter sig och sedan inaktivera den.
SCM_DO_BUILD_DURING_DEPLOYMENT
Styr beteendet för fjärrbygge under distributionen. När SCM_DO_BUILD_DURING_DEPLOYMENT är inställt på trueskapas projektet via fjärranslutning under distributionen.
| Key | Exempelvärde |
|---|---|
| SCM_DO_BUILD_DURING_DEPLOYMENT | true |
SCM_LOGSTREAM_TIMEOUT
Styr tidsgränsen, i sekunder, vid anslutning till strömmande loggar. Standardvärdet är 7200 (2 timmar).
| Key | Exempelvärde |
|---|---|
| SCM_LOGSTREAM_TIMEOUT | 1800 |
Det föregående exempelvärdet 1800 för anger en tidsgräns på 30 minuter. För mer information, se Aktivera körningsloggar för direktuppspelning i Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
Anslutningssträng för lagringskonto där funktionsappens kod och konfiguration lagras i händelsedrivna skalningsplaner. Mer information finns i Inställningen för lagringskontoanslutning.
| Key | Exempelvärde |
|---|---|
| WEBSITE_CONTENTAZUREFILECONNECTIONSTRING | DefaultEndpointsProtocol=https;AccountName=... |
Den här inställningen krävs för både förbruknings- och Elastic Premium-abonnemangsappar. Det krävs inte för dedikerade planappar, som inte skalas dynamiskt av Functions.
Flex Consumption-planen är nu den rekommenderade serverlösa värdplanen för Azure Functions. Det ger snabbare skalning, minskad kallstart, privata nätverk och mer kontroll över prestanda och kostnader. Mer information finns i Flexkonsumtionsplanen.
Om du ändrar eller tar bort den här inställningen kan funktionsappen inte startas. Mer information finns i den här felsökningsartikeln.
Azure Files stöder inte användning av hanterad identitet vid åtkomst till filresursen. Mer information finns i autentiseringsscenarier som stöds av Azure Files.
WEBSITE_CONTENTOVERVNET
Important
WEBSITE_CONTENTOVERVNET är en äldre appinställning som har ersatts av webbplatsegenskapen vnetContentShareEnabled .
Ett värde för 1 gör att funktionsappen kan skalas när du har ditt lagringskonto begränsat till ett virtuellt nätverk. Du bör aktivera den här inställningen när du begränsar ditt lagringskonto till ett virtuellt nätverk. Krävs endast när du använder WEBSITE_CONTENTSHARE och WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Mer information finns i Begränsa ditt lagringskonto till ett virtuellt nätverk.
| Key | Exempelvärde |
|---|---|
| WEBSITE_CONTENTOVERVNET | 1 |
Den här appinställningen krävs för Elastic Premium - och Dedicated-abonnemangen (App Service) (Standard och högre). Stöds inte när du kör en förbrukningsplan.
Note
Du måste vara särskilt försiktig när du dirigerar till innehållsresursen i ett lagringskonto som delas av flera funktionsappar i samma plan. Mer information finns i Artikeln Om konsekvent routning via virtuella nätverk i artikeln Om lagringsöverväganden.
WEBSITE_CONTENTSHARE
Namnet på filresursen som Functions använder för att lagra funktionsappens kod och konfigurationsfiler. Det här innehållet krävs av händelsedrivna skalningsplaner. Används med WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Standardvärdet är en unik sträng som genereras av körtiden och som börjar med funktionsappens namn. Mer information finns i Inställningen för lagringskontoanslutning.
| Key | Exempelvärde |
|---|---|
| WEBSITE_CONTENTSHARE | functionapp091999e2 |
Den här inställningen krävs endast för appar med förbrukning och Premium-abonnemang. Det krävs inte för dedikerade planappar, som inte skalas dynamiskt av Azure Functions.
Flex Consumption-planen är nu den rekommenderade serverlösa värdplanen för Azure Functions. Det ger snabbare skalning, minskad kallstart, privata nätverk och mer kontroll över prestanda och kostnader. Mer information finns i Flexkonsumtionsplanen.
Resursen skapas när funktionsappen skapas. Om du ändrar eller tar bort den här inställningen kan funktionsappen inte startas. Mer information finns i den här felsökningsartikeln.
Följande överväganden gäller när du använder en ARM-mall (Azure Resource Manager) eller en Bicep-fil för att skapa en funktionsapp under distributionen:
- När du inte anger ett
WEBSITE_CONTENTSHAREvärde för huvudfunktionsappen eller några appar i platser skapas unika andelsvärden åt dig. Att inte angeWEBSITE_CONTENTSHAREär den rekommenderade metoden för distribution av ARM-mallar. - Det finns scenarier där du måste ange
WEBSITE_CONTENTSHAREvärdet till ett fördefinierat värde, till exempel när du använder ett skyddat lagringskonto i ett virtuellt nätverk. I det här fallet måste du ange ett unikt delningsnamn för huvudfunktionsappen och appen för varje distributionsplats. För ett lagringskonto som skyddas av ett virtuellt nätverk måste du också skapa själva resursen som en del av den automatiserade distributionen. Mer information finns i Säkra distributioner. - Gör inte
WEBSITE_CONTENTSHAREtill en platsinställning. - När du anger
WEBSITE_CONTENTSHAREmåste värdet följa den här vägledningen för delade namn.
WEBSITE_DNS_SERVER
Anger den DNS-server som används av en app vid matchning av IP-adresser. Den här inställningen krävs ofta när du använder vissa nätverksfunktioner, till exempel privata Azure DNS-zoner och privata slutpunkter.
| Key | Exempelvärde |
|---|---|
| WEBSITE_DNS_SERVER | 168.63.129.16 |
WEBSITE_ENABLE_BROTLI_ENCODING
Styr om Brotli-kodning används för komprimering i stället för standard-gzip-komprimering. När WEBSITE_ENABLE_BROTLI_ENCODING är inställt på 1används Brotli-kodning. Annars används gzip-kodning.
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED
Inaktiverar cachelagring när funktionsappar distribueras med hjälp av ARM-mallar (Azure Resource Manager).
| Key | Exempelvärde |
|---|---|
| WEBSITE_FUNCTIONS_ARMCACHE_ENABLED | 0 |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT
Det maximala antalet instanser som appen kan skala ut till. Standardinställningen är obegränsad.
Important
Den här inställningen är i förhandsversion. Det finns nu en appegenskap för maximal utskalning av funktioner . Vi rekommenderar den här egenskapen för att begränsa utskalning.
| Key | Exempelvärde |
|---|---|
| WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT | 5 |
WEBSITE_NODE_DEFAULT_VERSION
Endast Windows.
Anger vilken version av Node.js som ska användas när du kör funktionsappen i Windows. Du bör använda en tilde (~) för att få körmiljön att använda den senaste tillgängliga versionen av den angivna huvudversionen. När den är inställd på ~18, används den senaste versionen av Node.js 18. När en huvudversion är riktad mot en tilde behöver du inte uppdatera delversionen manuellt.
| Key | Exempelvärde |
|---|---|
| WEBSITE_NODE_DEFAULT_VERSION | ~18 |
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS
När du utför ett slotsbyte på en funktionsapp som körs på en Premium-plan kan växlingen misslyckas om det dedikerade lagringskontot som används av appen har nätverksrestriktioner. Det här felet orsakas av en äldre funktion för programloggning, som både Functions och App Service delar. Den här inställningen åsidosätter den äldre loggningsfunktionen och tillåter växlingen.
| Key | Exempelvärde |
|---|---|
| WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS | 0 |
Lägg till WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS med värdet 0 till alla platser för att se till att legacy-systemdiagnostik inte blockerar dina växlingar. Du kan också lägga till den här inställningen och värdet till bara produktionsfacket som en inställning för distributionsfack (fast förblir).
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS
Som standard är versionsinställningarna för funktionsappar specifika för varje fack. Den här inställningen används när du uppgraderar funktioner med hjälp av distributionsplatser. Den här metoden förhindrar oväntat beteende på grund av ändrade versioner efter ett byte. Ange till 0 i produktion och i sloten för att se till att alla versionsinställningar också byts. Mer information finns i Uppgradera med fack.
| Key | Exempelvärde |
|---|---|
| WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS | 0 |
WEBSITE_RUN_FROM_PACKAGE
Gör att funktionsappen kan köras från en paketfil som kan monteras lokalt eller distribueras till en extern URL.
| Key | Exempelvärde |
|---|---|
| WEBSITE_RUN_FROM_PACKAGE | 1 |
Giltiga värden är antingen en URL som matchar platsen för en extern distributionspaketfil eller 1. När det är inställt 1på måste paketet finnas i d:\home\data\SitePackages mappen. När du använder zip-distribution med WEBSITE_RUN_FROM_PACKAGE aktiverat laddas paketet upp automatiskt till den här platsen. Mer information finns i Kör dina funktioner från en paketfil.
När du använder WEBSITE_RUN_FROM_PACKAGE=<URL>måste URL:en matcha till paketfilens plats på en tillgänglig lagringsplats, till exempel en Azure Blob Storage-container. Containern måste vara privat för att förhindra obehörig åtkomst, vilket kräver att du använder antingen en signatur för delad åtkomst (SAS) i URL:en eller Microsoft Entra-ID-autentisering för att tillåta åtkomst. Användning av Microsoft Entra-ID med hanterade identiteter rekommenderas.
Det här är ett exempel på inställningen WEBSITE_RUN_FROM_PACKAGE till URL:en för ett distributionspaket i en Azure Blog Storage-container:
WEBSITE_RUN_FROM_PACKAGE=https://contosostorageaccount.blob.core.windows.net/mycontainer/mypackage.zip
När du använder SAS lägger du till token i URL:en som en frågeparameter.
När du distribuerar ett paket från Azure Blob Storage med hjälp av en användartilldelad hanterad identitet måste du också ange WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID resurs-ID för den användartilldelade hanterade identiteten. När du distribuerar från en extern paket-URL måste du även synkronisera utlösare manuellt. Mer information finns i Utlösarsynkronisering.
WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID
Anger resurs-ID för en användartilldelad hanterad identitet som används vid åtkomst till ett distributionspaket från en extern Azure Blob Storage-container som skyddas med hjälp av Microsoft Entra-ID. Den här inställningen kräver att WEBSITE_RUN_FROM_PACKAGE anges till URL:en för distributionspaketet i en privat container.
Att ställa in WEBSITE_RUN_FROM_PACKAGE_BLOB_MI_RESOURCE_ID=SystemAssigned är detsamma som att utelämna inställningen, i vilket fall den systemtilldelade hanterade identiteten för appen används.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION
Inställningarna WEBSITE_CONTENTAZUREFILECONNECTIONSTRING och WEBSITE_CONTENTSHARE har extra verifieringskontroller för att säkerställa att appen kan startas korrekt. Det går inte att skapa programinställningar när funktionsappen inte kan anropa det underordnade lagringskontot eller Nyckelvalvet på grund av nätverksbegränsningar eller andra begränsande faktorer. När WEBSITE_SKIP_CONTENTSHARE_VALIDATION är inställt på 1hoppas verifieringskontrollen över. Annars är värdet standardvärdet 0 och verifieringen sker.
| Key | Exempelvärde |
|---|---|
| WEBSITE_SKIP_CONTENTSHARE_VALIDATION | 1 |
Om valideringen hoppas över och antingen anslutningssträngen eller innehållsdelningen inte är giltig kan appen inte starta korrekt. I det här fallet returnerar funktioner HTTP 500-fel. Mer information finns i Felsöka fel: "Azure Functions Runtime är inte åtkomlig".
WEBSITE_SLOT_NAME
Read-only. Namnet på det aktuella distributionsfacket. Namnet på produktionsplatsen är Production.
| Key | Exempelvärde |
|---|---|
| WEBSITE_SLOT_NAME | Production |
WEBSITE_TIME_ZONE
Gör att du kan ange tidszonen för funktionsappen.
| Key | OS | Exempelvärde |
|---|---|---|
| WEBSITE_TIME_ZONE | Windows | Eastern Standard Time |
| WEBSITE_TIME_ZONE | Linux | America/New_York |
Standardtidszonen som används med CRON-uttrycken är Coordinated Universal Time (UTC). Om du vill att CRON-uttrycket ska baseras på en annan tidszon skapar du en appinställning för funktionsappen med namnet WEBSITE_TIME_ZONE.
Värdet för den här inställningen beror på vilket operativsystem och vilken plan funktionsappen körs på.
| Operativsystem | Plan | Value |
|---|---|---|
| Windows | All | Ange värdet till namnet på önskad tidszon enligt den andra raden från varje par som anges av Windows-kommandot tzutil.exe /L |
| Linux | Premium Dedicated |
Ange värdet till namnet på den önskade tidszonen enligt tz-databasen |
Note
WEBSITE_TIME_ZONE och TZ stöds för närvarande inte när de körs på Linux i en Flex Consumption - eller Consumption-plan . I det här fallet kan inställningen WEBSITE_TIME_ZONE eller TZ skapa SSL-relaterade problem och få mått att sluta fungera för din app.
Till exempel använder Eastern Time i USA (representeras av Eastern Standard Time (Windows) eller America/New_York (Linux)) för närvarande UTC-05:00 under standardtiden och UTC-04:00 under sommartid. Om du vill att en timerutlösare ska utlösas klockan 10:00 östlig tid varje dag skapar du en appinställning för funktionsappen med namnet WEBSITE_TIME_ZONE, anger värdet till Eastern Standard Time (Windows) eller America/New_York (Linux) och använder sedan följande NCRONTAB-uttryck:
"0 0 10 * * *"
När du använder WEBSITE_TIME_ZONEjusteras tiden för tidsändringar i den specifika tidszonen, inklusive sommartid och ändringar i standardtiden.
WEBSITE_USE_PLACEHOLDER
Anger om du vill använda en specifik kallstartsoptimering när du kör förbrukningsplanen. Ställ in på 0 för att inaktivera kallstartsoptimeringen på förbrukningsplanen.
| Key | Exempelvärde |
|---|---|
| WEBSITE_USE_PLACEHOLDER | 1 |
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED
Anger om du vill använda en specifik kallstartsoptimering när du kör .NET-isolerade arbetsprocessfunktioner i förbrukningsplanen. Ställ in på 0 för att inaktivera kallstartsoptimeringen på förbrukningsplanen.
| Key | Exempelvärde |
|---|---|
| WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED | 1 |
WEBSITE_VNET_ROUTE_ALL
Important
WEBSITE_VNET_ROUTE_ALL är en äldre appinställning som har ersatts av webbplatsinställningen vnetRouteAllEnabled .
Anger om all utgående trafik från appen dirigeras via det virtuella nätverket. Ett inställningsvärde 1 för anger att all programtrafik dirigeras via det virtuella nätverket. Du behöver den här inställningen när du konfigurerar regional integrering av virtuella nätverk i elastic premium- och dedikerade värdplaner. Den används också när en NAT-gateway för virtuellt nätverk används för att definiera en statisk utgående IP-adress.
| Key | Exempelvärde |
|---|---|
| WEBSITE_VNET_ROUTE_ALL | 1 |
WEBSITES_ENABLE_APP_SERVICE_STORAGE
Anger om /home katalogen delas mellan skalbara instanser med standardvärdet true. Du bör ange det här värdet till false när du distribuerar funktionsappen i en container.
Inställningar för App Service-webbplats
Vissa konfigurationer måste underhållas på App Service-nivå som platsinställningar, till exempel språkversioner. De här inställningarna hanteras i Azure-portalen, med hjälp av REST-API:er eller med hjälp av Azure CLI eller Azure PowerShell. Följande är webbplatsinställningar som kan krävas, beroende på ditt körningsspråk, operativsystem och versioner.
AcrUseManagedIdentityCreds
Anger om avbildningen hämtas från en Azure Container Registry-instans med hjälp av hanterad identitetsautentisering. Ett värde för true kräver att du använder hanterad identitet. Vi rekommenderar den här metoden för lagrade autentiseringsuppgifter som bästa praxis för säkerhet.
AcrUserManagedIdentityID
Anger den hanterade identitet som ska användas när avbildningen hämtas från en Azure Container Registry-instans. Kräver som AcrUseManagedIdentityCreds är inställt på true. Dessa värden är giltiga:
| Value | Description |
|---|---|
system |
Funktionsappens systemtilldelade hanterade identitet används. |
<USER_IDENTITY_RESOURCE_ID> |
Det fullständigt kvalificerade resurs-ID:t för en användartilldelad hanterad identitet. |
Den identitet som du anger måste läggas till i rollen ACRPull i containerregistret. Mer information finns i Skapa och konfigurera en funktionsapp i Azure med avbildningen.
alwaysOn
I en funktionsapp som körs i en dedikerad (App Service)-plan går Functions-körningen i viloläge efter några minuters inaktivitet, i vilket läge endast begäranden till en HTTP-utlösare väcker funktionsappen. För att se till att dina icke-HTTP-utlösta funktioner körs korrekt, inklusive Timer-utlösarfunktioner, aktiverar du AlwaysOn för funktionsappen genom att ange platsinställningen alwaysOn till värdet true.
functionsRuntimeAdminIsolationEnabled
Avgör om de inbyggda administratörsslutpunkterna (/admin) i funktionsappen kan nås. När den är inställd på false (standard) tillåter appen begäranden till slutpunkter under /admin när dessa begäranden visar en huvudnyckel i begäran. När truekan /admin slutpunkter inte nås, även med en huvudnyckel.
Det går inte att ange den här egenskapen för appar som körs på Linux i en förbrukningsplan. Det går inte att ange för appar som körs på version 1.x av Azure Functions. Om du använder version 1.x måste du först migrera till version 4.x.
Flex Consumption-planen är nu den rekommenderade serverlösa värdplanen för Azure Functions. Det ger snabbare skalning, minskad kallstart, privata nätverk och mer kontroll över prestanda och kostnader. Mer information finns i Flexkonsumtionsplanen.
linuxFxVersion
För funktionsappar som körs på Linux anger linuxFxVersion språket och versionen för den språkspecifika arbetsprocessen. Den här informationen används tillsammans med FUNCTIONS_EXTENSION_VERSIONför att avgöra vilken specifik Linux-containeravbildning som är installerad för att köra funktionsappen. Den här inställningen kan anges till ett fördefinierat värde eller en anpassad bild-URI.
Det här värdet anges för dig när du skapar din Linux-funktionsapp. Du kan behöva ange den för ARM-mall och Bicep-distributioner och i vissa uppgraderingsscenarier.
Giltiga linuxFxVersion-värden
Du kan använda följande Azure CLI-kommando för att se en tabell med aktuella linuxFxVersion värden, med funktionskörningsversion som stöds:
az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table
Föregående kommando kräver att du uppgraderar till version 2.40 av Azure CLI.
Anpassade avbildningar
När du skapar och underhåller en egen anpassad Linux-container för funktionsappen linuxFxVersion är värdet i stället i formatet DOCKER|<IMAGE_URI>, som i följande exempel:
linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"
Det här exemplet anger registerkällan för den distribuerade containern. Mer information finns i Arbeta med containrar och Azure Functions.
Important
När du skapar egna containrar måste du hålla basavbildningen av containern uppdaterad till den senaste basavbildningen som stöds. Basavbildningar som stöds för Azure Functions är språkspecifika. Se Lagringsplatser för Azure Functions-basavbildningar.
Functions-teamet har åtagit sig att publicera månatliga uppdateringar för dessa basavbildningar. Regelbundna uppdateringar omfattar de senaste delversionsuppdateringarna och säkerhetskorrigeringarna för både Functions-körningen och språken. Du bör regelbundet uppdatera containern från den senaste basavbildningen och distribuera om den uppdaterade versionen av containern. För mer information, se Underhåll av anpassade containrar.
netFrameworkVersion
Anger den specifika versionen av .NET för C#-funktioner. Mer information finns i Uppdatera funktionsappen i Azure.
powerShellVersion
Anger den specifika version av PowerShell som dina funktioner körs på. Mer information finns i Ändra PowerShell-versionen.
När du kör lokalt, använder du i stället FUNCTIONS_WORKER_RUNTIME_VERSION inställningen i filen local.settings.json.
vnetContentShareEnabled
Appar som körs i en Premium-plan använder en filresurs för att lagra innehåll. Namnet på den här innehållsresursen lagras i appinställningen WEBSITE_CONTENTSHARE och dess anslutningssträng lagras i WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Om du vill dirigera trafik mellan funktionsappen och innehållsresursen via ett virtuellt nätverk måste du också ange vnetContentShareEnabled till true. Att aktivera den här webbplatsegenskapen är ett krav när du begränsar ditt lagringskonto till ett virtuellt nätverk i elastic premium- och dedikerade värdplaner.
Note
Du måste vara särskilt försiktig när du dirigerar till innehållsresursen i ett lagringskonto som delas av flera funktionsappar i samma plan. Mer information finns i Artikeln Om konsekvent routning via virtuella nätverk i artikeln Om lagringsöverväganden.
Den här webbplatsegenskapen ersätter den äldre WEBSITE_CONTENTOVERVNET inställningen.
vnetImagePullEnabled
Functions stöder funktionsappar som körs i Linux-containrar. Om du vill ansluta och hämta från ett containerregister i ett virtuellt nätverk måste du ange vnetImagePullEnabled till true. Den här webbplatsegenskapen stöds i elastic premium- och dedikerade värdplaner. Flex Consumption-planen förlitar sig inte på platsegenskaper eller appinställningar för att konfigurera nätverk. Mer information finns i Utfasningar av flexförbrukningsplan.
vnetRouteAllEnabled
Anger om all utgående trafik från appen dirigeras via det virtuella nätverket. Ett inställningsvärde true för anger att all programtrafik dirigeras via det virtuella nätverket. Använd den här inställningen när du konfigurerar regional integrering av virtuella nätverk i Elastic Premium- och Dedicated-abonnemangen. Den används också när en NAT-gateway för virtuellt nätverk används för att definiera en statisk utgående IP-adress. Mer information finns i Konfigurera programroutning.
Den här webbplatsinställningen ersätter den äldre inställningen WEBSITE_VNET_ROUTE_ALL .
Utfasningar av flexförbrukningsplan
I Flex Consumption-planen är dessa webbplatsegenskaper och programinställningar inaktuella och bör inte användas när du skapar funktionsappresurser:
| Setting/property | Reason |
|---|---|
ENABLE_ORYX_BUILD |
Ersatt av parametern remoteBuild vid distribution i Flex Consumption |
FUNCTIONS_EXTENSION_VERSION |
Appinställningen anges av serverdelen. Ett värde på ~1 kan ignoreras. |
FUNCTIONS_WORKER_RUNTIME |
Ersatt av name i properties.functionAppConfig.runtime |
FUNCTIONS_WORKER_RUNTIME_VERSION |
Ersatt av version i properties.functionAppConfig.runtime |
FUNCTIONS_MAX_HTTP_CONCURRENCY |
Ersatt av avsnittet för skalning och samtidighetsutlösare |
FUNCTIONS_WORKER_PROCESS_COUNT |
Ogiltig inställning |
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED |
Ogiltig inställning |
SCM_DO_BUILD_DURING_DEPLOYMENT |
Ersatt av parametern remoteBuild vid distribution i Flex Consumption |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Ersatt av funktionAppConfigs distributionsavsnitt |
WEBSITE_CONTENTOVERVNET |
Används inte för nätverkskoppling i Flex Consumption |
WEBSITE_CONTENTSHARE |
Ersatt av funktionAppConfigs distributionsavsnitt |
WEBSITE_DNS_SERVER |
DNS ärvs från det integrerade virtuella nätverket i Flex |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT |
Ersatt av maximumInstanceCount i properties.functionAppConfig.scaleAndConcurrency |
WEBSITE_NODE_DEFAULT_VERSION |
Ersatt av version i properties.functionAppConfig.runtime |
WEBSITE_RUN_FROM_PACKAGE |
Används inte för distributioner i Flex Consumption |
WEBSITE_SKIP_CONTENTSHARE_VALIDATION |
Innehållsdelning används inte i Flex-förbrukning |
WEBSITE_VNET_ROUTE_ALL |
Används inte för nätverkskoppling i Flex Consumption |
properties.alwaysOn |
Inte giltigt |
properties.containerSize |
Omnamnades till instanceMemoryMB |
properties.ftpsState |
FTPS stöds inte |
properties.isReserved |
Inte giltigt |
properties.IsXenon |
Inte giltigt |
properties.javaVersion |
Ersatt av version i properties.functionAppConfig.runtime |
properties.LinuxFxVersion |
Ersatt av properties.functionAppConfig.runtime |
properties.netFrameworkVersion |
Ersatt av version i properties.functionAppConfig.runtime |
properties.powerShellVersion |
Ersatt av version i properties.functionAppConfig.runtime |
properties.siteConfig.functionAppScaleLimit |
Omnamnades till maximumInstanceCount |
properties.siteConfig.preWarmedInstanceCount |
Omnamnades till alwaysReadyInstances |
properties.use32BitWorkerProcess |
32-bit stöds inte |
properties.vnetBackupRestoreEnabled |
Används inte för nätverkskoppling i Flex Consumption |
properties.vnetContentShareEnabled |
Används inte för nätverkskoppling i Flex Consumption |
properties.vnetImagePullEnabled |
Används inte för nätverkskoppling i Flex Consumption |
properties.vnetRouteAllEnabled |
Används inte för nätverkskoppling i Flex Consumption |
properties.windowsFxVersion |
Inte giltigt |