Delen via

Naslaginformatie over app-instellingen voor Azure Functions

  • Artikel

Toepassingsinstellingen in een functie-app bevatten configuratieopties die van invloed zijn op alle functies voor die functie-app. Deze instellingen worden geopend als omgevingsvariabelen. In dit artikel worden de app-instellingen vermeld die beschikbaar zijn in functie-apps.

Er zijn verschillende manieren waarop u instellingen van een functie app kunt toevoegen, bijwerken en verwijderen:

Voor wijzigingen in de instellingen van de functie-app moet uw functie-app opnieuw worden gestart.

In dit artikel worden verbindingsreeks waarden voor leesbaarheid afgekapt.

Omdat Azure Functions gebruikmaakt van het Azure-app Service-platform voor hosting, vindt u mogelijk enkele instellingen die relevant zijn voor uw functie-app die wordt gehost in omgevingsvariabelen en app-instellingen in Azure-app Service.

Overwegingen voor app-instellingen

Wanneer u app-instellingen gebruikt, moet u rekening houden met de volgende overwegingen:

  • Voor wijzigingen in de instellingen van de functie-app moet uw functie-app opnieuw worden gestart.

  • Bij het instellen van namen worden dubbele onderstrepingstekens (__) en dubbele punt (:) beschouwd als gereserveerde waarden. Dubbele onderstrepingstekens worden geïnterpreteerd als hiërarchische scheidingstekens in Zowel Windows als Linux en dubbele punten worden op dezelfde manier geïnterpreteerd in Windows. De instelling AzureFunctionsWebHost__hostid=somehost_123456 wordt bijvoorbeeld geïnterpreteerd als het volgende JSON-object:

    "AzureFunctionsWebHost": {
    "hostid": "somehost_123456"
}

    In dit artikel worden alleen dubbele onderstrepingstekens gebruikt, omdat ze worden ondersteund op beide besturingssystemen. De meeste instellingen die beheerde identiteitverbindingen ondersteunen, maken gebruik van dubbele onderstrepingstekens.

  • Wanneer Functions lokaal wordt uitgevoerd, worden app-instellingen opgegeven in de Values verzameling in de local.settings.json.

  • Er zijn andere configuratieopties voor functie-apps in het host.json-bestand en in het local.settings.json-bestand .

  • U kunt toepassingsinstellingen gebruiken om host.json instellingswaarden te overschrijven zonder dat u het host.json bestand zelf hoeft te wijzigen. Dit is handig voor scenario's waarin u specifieke host.json-instellingen voor een specifieke omgeving moet configureren of wijzigen. Hiermee kunt u ook host.json instellingen wijzigen zonder dat u uw project opnieuw hoeft te publiceren. Zie het host.json naslagartikel voor meer informatie.

  • In dit artikel worden de instellingen beschreven die het meest relevant zijn voor uw functie-apps. Omdat Azure Functions wordt uitgevoerd op App Service, worden andere toepassingsinstellingen ook ondersteund. Zie Omgevingsvariabelen en app-instellingen in Azure-app Service voor meer informatie.

  • Voor sommige scenario's moet u ook werken met instellingen die worden beschreven in app service-site-instellingen.

  • Als u instellingen voor alleen-lezen-App Service-toepassingen wijzigt, kan uw functie-app in een niet-reagerende status worden geplaatst.

  • Zorg ervoor dat u toepassingsinstellingen bijwerkt met behulp van REST API's, waaronder ARM-sjablonen. Omdat deze API's de bestaande toepassingsinstellingen vervangen, moet u alle bestaande instellingen opnemen bij het toevoegen of wijzigen van instellingen met behulp van REST API's of ARM-sjablonen. Gebruik indien mogelijk Azure CLI of Azure PowerShell om programmatisch te werken met toepassingsinstellingen. Zie Werken met toepassingsinstellingen voor meer informatie.

APPINSIGHTS_INSTRUMENTATIONKEY

De instrumentatiesleutel voor Application Insights. Gebruik niet zowel APPINSIGHTS_INSTRUMENTATIONKEY als APPLICATIONINSIGHTS_CONNECTION_STRING. Gebruik indien APPLICATIONINSIGHTS_CONNECTION_STRINGmogelijk . Wanneer Application Insights wordt uitgevoerd in een onafhankelijke cloud, moet u deze gebruiken APPLICATIONINSIGHTS_CONNECTION_STRING. Zie Bewaking configureren voor Azure Functions voor meer informatie.

Sleutel Voorbeeldwaarde
APPINSIGHTS_INSTRUMENTATIONKEY 55555555-af77-484b-9032-64f83bb83bb

Gebruik niet zowel APPINSIGHTS_INSTRUMENTATIONKEY als APPLICATIONINSIGHTS_CONNECTION_STRING. Het gebruik van APPLICATIONINSIGHTS_CONNECTION_STRING wordt aanbevolen.

APPLICATIONINSIGHTS_AUTHENTICATION_STRING

Hiermee kunt u toegang krijgen tot Application Insights met behulp van Microsoft Entra-verificatie. Gebruik deze instelling wanneer u verbinding moet maken met uw Application Insights-werkruimte met behulp van Microsoft Entra-verificatie. Zie Microsoft Entra-verificatie voor Application Insights voor meer informatie.

Wanneer u gebruikt APPLICATIONINSIGHTS_AUTHENTICATION_STRING, is de specifieke waarde die u instelt, afhankelijk van het type beheerde identiteit:

Beheerde identiteit Instellingswaarde
Door het systeem toegewezen Authorization=AAD
Door de gebruiker toegewezen Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID>

Deze verificatievereiste wordt toegepast op verbindingen van de Functions-host, het foutopsporingsprogramma voor momentopnamen, profiler en alle taalspecifieke agents. Als u deze instelling wilt gebruiken, moet de beheerde identiteit al beschikbaar zijn voor de functie-app, met een toegewezen rol die gelijk is aan De uitgever van metrische gegevens bewaken.

Notitie

APPLICATIONINSIGHTS_AUTHENTICATION_STRING Wanneer u verbinding maakt met Application Insights met behulp van Microsoft Entra-verificatie, moet u ook lokale verificatie uitschakelen voor Application Insights. Voor deze configuratie is Microsoft Entra-verificatie vereist om telemetrie op te nemen in uw werkruimte.

APPLICATIONINSIGHTS_CONNECTION_STRING

De verbindingsreeks voor Application Insights. Gebruik niet zowel APPINSIGHTS_INSTRUMENTATIONKEY als APPLICATIONINSIGHTS_CONNECTION_STRING. Hoewel het gebruik in APPLICATIONINSIGHTS_CONNECTION_STRING alle gevallen wordt aanbevolen, is dit vereist in de volgende gevallen:

  • Wanneer uw functie-app de toegevoegde aanpassingen vereist die worden ondersteund met behulp van de verbindingsreeks
  • Wanneer uw Application Insights-exemplaar wordt uitgevoerd in een onafhankelijke cloud, waarvoor een aangepast eindpunt is vereist

Zie Verbindingsreeksen voor meer informatie.

Sleutel Voorbeeldwaarde
APPLICATIONINSIGHTS_CONNECTION_STRING InstrumentationKey=...

Als u verbinding wilt maken met Application Insights met Microsoft Entra-verificatie, moet u dit gebruiken APPLICATIONINSIGHTS_AUTHENTICATION_STRING.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Belangrijk

Azure Functions-proxy's is een verouderde functie voor versies 1.x tot en met 3.x van de Azure Functions-runtime. Zie Functions-proxy's voor meer informatie over verouderde ondersteuning in versie 4.x.

Functions-proxy's gebruiken standaard een snelkoppeling om API-aanroepen van proxy's rechtstreeks naar functies in dezelfde functie-app te verzenden. Deze snelkoppeling wordt gebruikt in plaats van een nieuwe HTTP-aanvraag te maken. Met deze instelling kunt u dat snelkoppelingsgedrag uitschakelen.

Sleutel Weergegeven als Beschrijving
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL true Aanroepen met een back-end-URL die verwijst naar een functie in de lokale functie-app, worden niet rechtstreeks naar de functie verzonden. In plaats daarvan worden de aanvragen teruggeleid naar de HTTP-front-end voor de functie-app.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL false Aanroepen met een back-end-URL die verwijst naar een functie in de lokale functie-app, worden rechtstreeks doorgestuurd naar de functie. false is de standaardwaarde.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Belangrijk

Azure Functions-proxy's is een verouderde functie voor versies 1.x tot en met 3.x van de Azure Functions-runtime. Zie Functions-proxy's voor meer informatie over verouderde ondersteuning in versie 4.x.

Met deze instelling bepaalt u of de tekens %2F worden gedecodeerd als slashes in routeparameters wanneer ze worden ingevoegd in de back-end-URL.

Sleutel Weergegeven als Beschrijving
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES true Routeparameters met gecodeerde slashes worden gedecodeerd.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES false Alle routeparameters worden ongewijzigd doorgegeven. Dit is het standaardgedrag.

Denk bijvoorbeeld aan het proxies.json-bestand voor een functie-app in het myfunction.com domein.

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}

Wanneer AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES deze is ingesteld trueop , wordt de URL example.com/api%2ftest omgezet in example.com/api/test. Standaard blijft de URL ongewijzigd als example.com/test%2fapi. Zie Functions-proxy's voor meer informatie.

AZURE_FUNCTIONS_ENVIRONMENT

Hiermee configureert u de runtimehostingomgeving van de functie-app wanneer deze wordt uitgevoerd in Azure. Deze waarde wordt gelezen tijdens de initialisatie en alleen deze waarden worden door de runtime gehonoreerd:

Weergegeven als Beschrijving
Production Vertegenwoordigt een productieomgeving, met verminderde logboekregistratie en optimalisatie van volledige prestaties. Dit is de standaardwaarde wanneer AZURE_FUNCTIONS_ENVIRONMENT deze niet is ingesteld of is ingesteld op een niet-ondersteunde waarde.
Staging Vertegenwoordigt een faseringsomgeving, zoals bij het uitvoeren in een staging-site.
Development Een ontwikkeling omgevingsondersteuning uitgebreidere logboekregistratie en andere verminderde prestatieoptimalisaties. De Azure Functions Core Tools wordt ingesteld AZURE_FUNCTIONS_ENVIRONMENT Development wanneer deze wordt uitgevoerd op uw lokale computer. Deze instelling kan niet worden overschreven in het local.settings.json-bestand.

Gebruik deze instelling in plaats van ASPNETCORE_ENVIRONMENT wanneer u de runtime-omgeving in Azure moet wijzigen in iets anders dan Production. Zie Opstartklasse en -methoden op basis van omgeving voor meer informatie.

Deze instelling is niet beschikbaar in versie 1.x van de Functions-runtime.

AzureFunctionsJobHost__*

In versie 2.x en latere versies van de Functions-runtime kunnen toepassingsinstellingen host.json instellingen in de huidige omgeving overschrijven. Deze onderdrukkingen worden uitgedrukt als toepassingsinstellingen met de naam AzureFunctionsJobHost__path__to__setting. Voor meer informatie, zie Host.json-waarden overschrijven.

AzureFunctionsWebHost__hostid

Hiermee stelt u de host-id voor een bepaalde functie-app in. Dit moet een unieke id zijn. Met deze instelling wordt de automatisch gegenereerde host-id-waarde voor uw app overschreven. Gebruik deze instelling alleen als u host-id-conflicten wilt voorkomen tussen functie-apps die hetzelfde opslagaccount delen.

Een host-id moet voldoen aan de volgende vereisten:

  • Tussen 1 en 32 tekens zijn
  • alleen kleine letters, cijfers en streepjes bevatten
  • Niet beginnen of eindigen met een streepje
  • Geen opeenvolgende streepjes bevatten

Een eenvoudige manier om een id te genereren is door een GUID te nemen, de streepjes te verwijderen en kleine letters te maken, zoals door de GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 te converteren naar de waarde 1835d7b55c984790815d072cc94c6f71.

Sleutel Voorbeeldwaarde
AzureFunctionsWebHost__hostid myuniquefunctionappname123456789

Zie Overwegingen voor host-id's voor meer informatie.

AzureWebJobsDashboard

Deze instelling is afgeschaft en wordt alleen ondersteund wanneer deze wordt uitgevoerd op versie 1.x van de Azure Functions-runtime.

Optioneel opslagaccount verbindingsreeks voor het opslaan van logboeken en het weergeven ervan op het tabblad Monitor in de portal. Het opslagaccount moet een algemeen account zijn dat ondersteuning biedt voor blobs, wachtrijen en tabellen. Zie de vereisten voor opslagaccounts voor meer informatie.

Sleutel Voorbeeldwaarde
AzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=...

AzureWebJobsDisableHomepage

Een waarde van het uitschakelen van true de standaardlandingspagina die wordt weergegeven voor de hoofd-URL van een functie-app. De standaardwaarde is false.

Sleutel Voorbeeldwaarde
AzureWebJobsDisableHomepage true

Wanneer deze app-instelling wordt weggelaten of is ingesteld falseop, wordt een pagina die lijkt op het volgende voorbeeld weergegeven als reactie op de URL <functionappname>.azurewebsites.net.

Landingspagina van functie-app

AzureWebJobsDotNetReleaseCompilation

true betekent de gebruiksmodus Release bij het compileren van .NET-code; false betekent dat de foutopsporingsmodus wordt gebruikt. Standaard is true.

Sleutel Voorbeeldwaarde
AzureWebJobsDotNetReleaseCompilation true

AzureWebJobsFeatureFlags

Een door komma's gescheiden lijst met bètafuncties die u wilt inschakelen. Bètafuncties die door deze vlaggen zijn ingeschakeld, zijn niet gereed voor productie, maar kunnen worden ingeschakeld voor experimenteel gebruik voordat ze live gaan.

Sleutel Voorbeeldwaarde
AzureWebJobsFeatureFlags feature1,feature2,EnableProxies

Voeg EnableProxies toe aan deze lijst om proxy's opnieuw in te schakelen op versie 4.x van de Functions-runtime tijdens het plannen van uw migratie naar Azure API Management. Zie Proxy's opnieuw inschakelen in Functions v4.x voor meer informatie.

AzureWebJobsKubernetesSecretName

Geeft de Kubernetes Secrets-resource aan die wordt gebruikt voor het opslaan van sleutels. Alleen ondersteund bij uitvoering in Kubernetes. Voor deze instelling moet u instellen AzureWebJobsSecretStorageType op kubernetes. Wanneer AzureWebJobsKubernetesSecretName deze niet is ingesteld, wordt de opslagplaats beschouwd als alleen-lezen. In dit geval moeten de waarden vóór de implementatie worden gegenereerd. De Azure Functions Core Tools genereert de waarden automatisch bij het implementeren in Kubernetes.

Sleutel Voorbeeldwaarde
AzureWebJobsKubernetesSecretName <SECRETS_RESOURCE>

Zie Sleutelopslag beheren voor meer informatie.

AzureWebJobsSecretStorageKeyVaultClientId

De client-id van de door de gebruiker toegewezen beheerde identiteit of de app-registratie die wordt gebruikt voor toegang tot de kluis waar sleutels worden opgeslagen. Voor deze instelling moet u instellen AzureWebJobsSecretStorageType op keyvault. Ondersteund in versie 4.x en latere versies van de Functions-runtime.

Sleutel Voorbeeldwaarde
AzureWebJobsSecretStorageKeyVaultClientId <CLIENT_ID>

Zie Sleutelopslag beheren voor meer informatie.

AzureWebJobsSecretStorageKeyVaultClientSecret

Het geheim voor client-id van de door de gebruiker toegewezen beheerde identiteit of de app-registratie die wordt gebruikt voor toegang tot de kluis waar sleutels worden opgeslagen. Voor deze instelling moet u instellen AzureWebJobsSecretStorageType op keyvault. Ondersteund in versie 4.x en latere versies van de Functions-runtime.

Sleutel Voorbeeldwaarde
AzureWebJobsSecretStorageKeyVaultClientSecret <CLIENT_SECRET>

Zie Sleutelopslag beheren voor meer informatie.

AzureWebJobsSecretStorageKeyVaultName

Deze instelling is afgeschaft en is alleen gebruikt bij uitvoering op versie 3.x van de Azure Functions-runtime.

De naam van een sleutelkluisexemplaren die wordt gebruikt voor het opslaan van sleutels. Deze instelling is alleen gebruikt in versie 3.x van de Functions-runtime, die niet meer wordt ondersteund. Voor versie 4.x gebruikt AzureWebJobsSecretStorageKeyVaultUriu in plaats daarvan . Voor deze instelling moet u instellen AzureWebJobsSecretStorageType op keyvault.

De kluis moet een toegangsbeleid hebben dat overeenkomt met de door het systeem toegewezen beheerde identiteit van de hostingresource. Het toegangsbeleid moet de identiteit de volgende geheime machtigingen verlenen: Get,Set, Listen Delete.
Wanneer uw functies lokaal worden uitgevoerd, wordt de identiteit van de ontwikkelaar gebruikt en moeten de instellingen zich in het local.settings.json-bestand bevindt.

Sleutel Voorbeeldwaarde
AzureWebJobsSecretStorageKeyVaultName <VAULT_NAME>

Zie Sleutelopslag beheren voor meer informatie.

AzureWebJobsSecretStorageKeyVaultTenantId

De tenant-id van de app-registratie die wordt gebruikt voor toegang tot de kluis waarin sleutels worden opgeslagen. Voor deze instelling moet u instellen AzureWebJobsSecretStorageType op keyvault. Ondersteund in versie 4.x en latere versies van de Functions-runtime. Zie Sleutelopslag beheren voor meer informatie.

Sleutel Voorbeeldwaarde
AzureWebJobsSecretStorageKeyVaultTenantId <TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

De URI van een sleutelkluisexemplaren die worden gebruikt voor het opslaan van sleutels. Ondersteund in versie 4.x en latere versies van de Functions-runtime. Dit is de aanbevolen instelling voor het gebruik van een sleutelkluisexemplaren voor sleutelopslag. Voor deze instelling moet u instellen AzureWebJobsSecretStorageType op keyvault.

De AzureWebJobsSecretStorageKeyVaultUri waarde moet de volledige waarde zijn van de Kluis-URI die wordt weergegeven op het tabblad Overzicht van Key Vault, waaronder https://.

De kluis moet een toegangsbeleid hebben dat overeenkomt met de door het systeem toegewezen beheerde identiteit van de hostingresource. Het toegangsbeleid moet de identiteit de volgende geheime machtigingen verlenen: Get,Set, Listen Delete.
Wanneer uw functies lokaal worden uitgevoerd, wordt de identiteit van de ontwikkelaar gebruikt en moeten de instellingen zich in het local.settings.json-bestand bevindt.

Sleutel Voorbeeldwaarde
AzureWebJobsSecretStorageKeyVaultUri https://<VAULT_NAME>.vault.azure.net

Zie Key Vault verwijzingen gebruiken voor Azure Functions voor meer informatie.

AzureWebJobsSecretStorageSas

Een SAS-URL voor Blob Storage voor een tweede opslagaccount dat wordt gebruikt voor sleutelopslag. Functions maakt standaard gebruik van het account dat is ingesteld in AzureWebJobsStorage. Wanneer u deze optie voor geheime opslag gebruikt, moet u ervoor zorgen dat deze AzureWebJobsSecretStorageType niet expliciet is ingesteld of is ingesteld op blob. Zie Sleutelopslag beheren voor meer informatie.

Sleutel Voorbeeldwaarde
AzureWebJobsSecretStorageSas <BLOB_SAS_URL>

AzureWebJobsSecretStorageType

Hiermee geeft u de opslagplaats of provider die moet worden gebruikt voor sleutelopslag. Sleutels worden altijd versleuteld voordat ze worden opgeslagen met een geheim dat uniek is voor uw functie-app.

Sleutel Weergegeven als Beschrijving
AzureWebJobsSecretStorageType blob Sleutels worden opgeslagen in een Blob Storage-container in het account dat wordt geleverd door de AzureWebJobsStorage instelling. Blob Storage is het standaardgedrag wanneer AzureWebJobsSecretStorageType deze niet is ingesteld.
Als u een ander opslagaccount wilt opgeven, gebruikt u de AzureWebJobsSecretStorageSas instelling om de SAS-URL van een tweede opslagaccount aan te geven.
AzureWebJobsSecretStorageType files Sleutels blijven behouden in het bestandssysteem. Dit is het standaardgedrag voor Functions v1.x.
AzureWebJobsSecretStorageType keyvault Sleutels worden opgeslagen in een sleutelkluisexemplaren die zijn ingesteld door AzureWebJobsSecretStorageKeyVaultName.
AzureWebJobsSecretStorageType kubernetes Wordt alleen ondersteund bij het uitvoeren van de Functions-runtime in Kubernetes. Wanneer AzureWebJobsKubernetesSecretName deze niet is ingesteld, wordt de opslagplaats beschouwd als alleen-lezen. In dit geval moeten de waarden vóór de implementatie worden gegenereerd. De Azure Functions Core Tools genereert de waarden automatisch bij het implementeren in Kubernetes.

Zie Sleutelopslag beheren voor meer informatie.

AzureWebJobsStorage

Hiermee geeft u de verbindingsreeks voor een Azure Storage-account dat door de Functions-runtime wordt gebruikt voor normale bewerkingen. Sommige toepassingen van dit opslagaccount door Functions zijn sleutelbeheer, timertriggerbeheer en Controlepunten van Event Hubs. Het opslagaccount moet een algemeen account zijn dat ondersteuning biedt voor blobs, wachtrijen en tabellen. Zie Vereisten voor opslagaccounts voor meer informatie.

Sleutel Voorbeeldwaarde
AzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=...

In plaats van een verbindingsreeks kunt u een op identiteit gebaseerde verbinding voor dit opslagaccount gebruiken. Zie Verbinding maken met hostopslag met een identiteit voor meer informatie.

AzureWebJobsStorage__accountName

Wanneer u een opslagverbinding op basis van identiteit gebruikt, stelt u de accountnaam van het opslagaccount in in plaats van de verbindingsreeks te gebruiken inAzureWebJobsStorage. Deze syntaxis is uniek voor AzureWebJobsStorage en kan niet worden gebruikt voor andere op identiteit gebaseerde verbindingen.

Sleutel Voorbeeldwaarde
AzureWebJobsStorage__accountName <STORAGE_ACCOUNT_NAME>

Voor onafhankelijke clouds of wanneer u een aangepaste DNS gebruikt, moet u in plaats daarvan de servicespecifieke AzureWebJobsStorage__*ServiceUri instellingen gebruiken.

AzureWebJobsStorage__blobServiceUri

Wanneer u een opslagverbinding op basis van identiteit gebruikt, stelt u de gegevensvlak-URI van de blobservice van het opslagaccount in.

Sleutel Voorbeeldwaarde
AzureWebJobsStorage__blobServiceUri https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net

Gebruik deze instelling in plaats van AzureWebJobsStorage__accountName in onafhankelijke clouds of wanneer u een aangepaste DNS gebruikt. Zie Verbinding maken met hostopslag met een identiteit voor meer informatie.

AzureWebJobsStorage__queueServiceUri

Wanneer u een opslagverbinding op basis van identiteit gebruikt, stelt u de gegevensvlak-URI van de wachtrijservice van het opslagaccount in.

Sleutel Voorbeeldwaarde
AzureWebJobsStorage__queueServiceUri https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net

Gebruik deze instelling in plaats van AzureWebJobsStorage__accountName in onafhankelijke clouds of wanneer u een aangepaste DNS gebruikt. Zie Verbinding maken met hostopslag met een identiteit voor meer informatie.

AzureWebJobsStorage__tableServiceUri

Wanneer u een op identiteit gebaseerde opslagverbinding gebruikt, stelt u de gegevensvlak-URI van een tabelservice van het opslagaccount in.

Sleutel Voorbeeldwaarde
AzureWebJobsStorage__tableServiceUri https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net

Gebruik deze instelling in plaats van AzureWebJobsStorage__accountName in onafhankelijke clouds of wanneer u een aangepaste DNS gebruikt. Zie Verbinding maken met hostopslag met een identiteit voor meer informatie.

AzureWebJobs_TypeScriptPath

Pad naar de compiler die wordt gebruikt voor TypeScript. Hiermee kunt u de standaardinstelling overschrijven als dat nodig is.

Sleutel Voorbeeldwaarde
AzureWebJobs_TypeScriptPath %HOME%\typescript

DOCKER_REGISTRY_SERVER_PASSWORD

Geeft het wachtwoord aan dat wordt gebruikt voor toegang tot een privécontainerregister. Deze instelling is alleen vereist bij het implementeren van uw containerfunctie-app vanuit een privécontainerregister. Zie Omgevingsvariabelen en app-instellingen in Azure-app Service voor meer informatie.

DOCKER_REGISTRY_SERVER_URL

Geeft de URL van een privécontainerregister aan. Deze instelling is alleen vereist bij het implementeren van uw containerfunctie-app vanuit een privécontainerregister. Zie Omgevingsvariabelen en app-instellingen in Azure-app Service voor meer informatie.

DOCKER_REGISTRY_SERVER_USERNAME

Geeft het account aan dat wordt gebruikt voor toegang tot een privécontainerregister. Deze instelling is alleen vereist bij het implementeren van uw containerfunctie-app vanuit een privécontainerregister. Zie Omgevingsvariabelen en app-instellingen in Azure-app Service voor meer informatie.

DOCKER_SHM_SIZE

Hiermee stelt u de grootte van het gedeelde geheugen (in bytes) in wanneer de Python-werkrol gebruikmaakt van gedeeld geheugen. Zie Gedeeld geheugen voor meer informatie.

Sleutel Voorbeeldwaarde
DOCKER_SHM_SIZE 268435456

Met de bovenstaande waarde wordt een gedeelde geheugengrootte van ~256 MB ingesteld.

Vereist dat deze FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED is ingesteld op 1.

ENABLE_ORYX_BUILD

Geeft aan of het Oryx-buildsysteem wordt gebruikt tijdens de implementatie. ENABLE_ORYX_BUILD moet worden ingesteld op true het uitvoeren van externe build-implementaties naar Linux. Zie Remote build voor meer informatie.

Sleutel Voorbeeldwaarde
ENABLE_ORYX_BUILD true

FUNCTION_APP_EDIT_MODE

Hiermee wordt aangegeven of u uw functie-app kunt bewerken in Azure Portal. Geldige waarden zijn readwrite en readonly.

Sleutel Voorbeeldwaarde
FUNCTION_APP_EDIT_MODE readonly

De waarde wordt door de runtime ingesteld op basis van de taalstack en de implementatiestatus van uw functie-app. Zie Ontwikkelingsbeperkingen in Azure Portal voor meer informatie.

FUNCTIONS_EXTENSION_VERSION

De versie van de Functions-runtime die als host fungeert voor uw functie-app. Een tilde (~) met primaire versie betekent dat de meest recente versie van die primaire versie (bijvoorbeeld ~4). Wanneer er nieuwe secundaire versies van dezelfde primaire versie beschikbaar zijn, worden deze automatisch geïnstalleerd in de functie-app.

Sleutel Voorbeeldwaarde
FUNCTIONS_EXTENSION_VERSION ~4

De volgende primaire runtimeversiewaarden worden ondersteund:

Weergegeven als Runtimedoel Opmerking
~4 4.x Aanbevolen
~1 1.x Ondersteuning eindigt op 14 september 2026

De waarde betekent ~4 dat uw app wordt uitgevoerd op versie 4.x van de runtime. Een waarde van het vastmaken van ~1 uw app aan versie 1.x van de runtime. Runtimeversie 2.x en 3.x worden niet meer ondersteund. Raadpleeg Overzicht van Azure Functions-runtime voor meer informatie. Als u door ondersteuning wordt gevraagd om uw app vast te maken aan een specifieke secundaire versie, gebruikt u het volledige versienummer (bijvoorbeeld 4.0.12345). Zie Een versie kiezen voor de runtime van Azure Functions voor meer informatie.

FUNCTIONS_INPROC_NET8_ENABLED

Hiermee wordt aangegeven of een app .NET 8 in het procesmodel kan gebruiken. Als u .NET 8 in het procesmodel wilt gebruiken, moet deze waarde worden ingesteld op 1. Zie Bijwerken naar doel .NET 8 voor volledige instructies, inclusief andere vereiste configuratiewaarden.

Sleutel Voorbeeldwaarde
FUNCTIONS_INPROC_NET8_ENABLED 1

Ingesteld op 0 het uitschakelen van ondersteuning voor .NET 8 in het procesmodel.

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

Deze app-instelling is een tijdelijke manier voor Node.js apps om een belangrijke wijziging mogelijk te maken die fouten in toegangspunten gemakkelijker kan oplossen op Node.js v18 of lager. Het wordt ten zeerste aanbevolen om te gebruiken true, met name voor programmeermodel v4-apps, die altijd toegangspuntbestanden gebruiken. Het gedrag zonder de wijziging die fouten veroorzaakt (false) negeert invoerpuntfouten en meldt deze niet aan in Application Insights.

Vanaf Node.js v20 heeft de app-instelling geen effect en wordt het gedrag van de wijziging die fouten veroorzaken altijd ingeschakeld.

Voor Node.js v18 of lager wordt de app-instelling gebruikt en is het standaardgedrag afhankelijk van of de fout voor of nadat een model v4-functie is geregistreerd:

  • Als de fout eerder wordt gegenereerd (bijvoorbeeld als u model v3 gebruikt of uw invoerpuntbestand niet bestaat), komt het standaardgedrag overeen false.
  • Als de fout wordt gegenereerd na (bijvoorbeeld als u dubbele model v4-functies probeert te registreren), komt het standaardgedrag overeen true.
Sleutel Weergegeven als Beschrijving
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR true Blokkeer fouten bij toegangspunten en meld ze aan in Application Insights.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR false Negeer invoerpuntfouten en meld deze niet aan in Application Insights.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

Overschrijft de standaardlimiet voor de hoofdtekst van aanvragen die naar HTTP-eindpunten worden verzonden. De waarde wordt gegeven in bytes, met een standaard maximale aanvraaggrootte van 104.857.600 bytes.

Sleutel Voorbeeldwaarde
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT 250000000

FUNCTIONS_V2_COMPATIBILITY_MODE

Belangrijk

Deze instelling wordt niet meer ondersteund. Het is oorspronkelijk opgegeven om een tijdelijke oplossing voor de korte termijn in te schakelen voor apps die gericht waren op de v2.x-runtime om in plaats daarvan te kunnen worden uitgevoerd op de v3.x-runtime terwijl deze nog steeds werd ondersteund. Met uitzondering van verouderde apps die worden uitgevoerd op versie 1.x, moeten alle functie-apps worden uitgevoerd op versie 4.x van de Functions-runtime: FUNCTIONS_EXTENSION_VERSION=~4. Raadpleeg Overzicht van Azure Functions-runtime voor meer informatie.

FUNCTIONS_WORKER_PROCESS_COUNT

Hiermee geeft u het maximum aantal taalwerkprocessen, met een standaardwaarde van 1. De toegestane maximumwaarde is 10. Functie-aanroepen worden gelijkmatig verdeeld over taalwerkprocessen. Taalwerkprocessen worden elke 10 seconden totdat het aantal dat is FUNCTIONS_WORKER_PROCESS_COUNT ingesteld, is bereikt. Het gebruik van werkprocessen in meerdere talen is niet hetzelfde als schalen. Overweeg deze instelling te gebruiken wanneer uw workload een combinatie van CPU-afhankelijke en I/O-afhankelijke aanroepen heeft. Deze instelling is van toepassing op alle taalruntimes, met uitzondering van .NET dat wordt uitgevoerd in proces (FUNCTIONS_WORKER_RUNTIME=dotnet).

Sleutel Voorbeeldwaarde
FUNCTIONS_WORKER_PROCESS_COUNT 2

FUNCTIONS_WORKER_RUNTIME

De taal- of taalstack van de werkrolruntime die moet worden geladen in de functie-app. Dit komt overeen met de taal die wordt gebruikt in uw toepassing (bijvoorbeeld python). Vanaf versie 2.x van de Azure Functions-runtime kan een bepaalde functie-app slechts één taal ondersteunen.

Sleutel Voorbeeldwaarde
FUNCTIONS_WORKER_RUNTIME node

Geldige waarden:

Weergegeven als Taal/taalstack
dotnet C# (klassebibliotheek)
C# (script)
dotnet-isolated C# (geïsoleerd werkproces)
java Java
node JavaScript
TypeScript
powershell Powershell
python Python
custom Overig

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

Met deze instelling kan de Python-werkrol gedeeld geheugen gebruiken om de doorvoer te verbeteren. Schakel gedeeld geheugen in wanneer uw Python-functie-app knelpunten in het geheugen raakt.

Sleutel Voorbeeldwaarde
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED 1

Als deze instelling is ingeschakeld, kunt u de DOCKER_SHM_SIZE-instelling gebruiken om de grootte van het gedeelde geheugen in te stellen. Zie Gedeeld geheugen voor meer informatie.

JAVA_OPTS

Wordt gebruikt om de virtuele Java-machine (JVM) aan te passen die wordt gebruikt om uw Java-functies uit te voeren bij het uitvoeren van een Premium-abonnement of Dedicated-abonnement. Wanneer u een verbruiksabonnement uitvoert, gebruikt u languageWorkers__java__argumentsin plaats daarvan . Zie JVM aanpassen voor meer informatie.

languageWorkers__java__arguments

Wordt gebruikt om de virtuele Java-machine (JVM) aan te passen die wordt gebruikt om uw Java-functies uit te voeren bij het uitvoeren van een verbruiksabonnement. Deze instelling verhoogt de koude begintijden voor Java-functies die worden uitgevoerd in een verbruiksabonnement. Voor een Premium- of Dedicated-abonnement gebruikt u in plaats daarvan JAVA_OPTS. Zie JVM aanpassen voor meer informatie.

MDMaxBackgroundUpgradePeriod

Hiermee bepaalt u de updateperiode voor beheerde afhankelijkheden voor PowerShell-functie-apps, met een standaardwaarde van 7.00:00:00 (wekelijks).

Elk PowerShell-werkproces initieert het controleren op module-upgrades in de PowerShell Gallery bij het starten van het proces en daarna MDMaxBackgroundUpgradePeriod . Wanneer een nieuwe moduleversie beschikbaar is in de PowerShell Gallery, wordt deze geïnstalleerd in het bestandssysteem en beschikbaar gesteld aan PowerShell-werkrollen. Als u deze waarde verlaagt, kan uw functie-app sneller nieuwere moduleversies krijgen, maar het verhoogt ook het app-resourcegebruik (netwerk-I/O, CPU, opslag). Als u deze waarde verhoogt, wordt het resourcegebruik van de app verlaagd, maar kan het ook vertragen dat nieuwe moduleversies aan uw app worden geleverd.

Sleutel Voorbeeldwaarde
MDMaxBackgroundUpgradePeriod 7.00:00:00

Zie Afhankelijkheidsbeheer voor meer informatie.

MDNewSnapshotCheckPeriod

Hiermee geeft u op hoe vaak elke PowerShell-werkrol controleert of beheerde afhankelijkheidsupgrades zijn geïnstalleerd. De standaardfrequentie is 01:00:00 (elk uur).

Nadat nieuwe moduleversies zijn geïnstalleerd in het bestandssysteem, moet elk PowerShell-werkproces opnieuw worden gestart. Het opnieuw opstarten van PowerShell-werkrollen is van invloed op de beschikbaarheid van uw app, omdat de huidige functie-uitvoering kan worden onderbroken. Totdat alle PowerShell-werkprocessen opnieuw worden gestart, kunnen functie-aanroepen de oude of de nieuwe moduleversies gebruiken. Alle PowerShell-werkrollen worden opnieuw opgestart binnen MDNewSnapshotCheckPeriod.

Binnen elke MDNewSnapshotCheckPeriodmodule controleert de PowerShell-werkrol of upgrades voor beheerde afhankelijkheden al dan niet zijn geïnstalleerd. Wanneer upgrades zijn geïnstalleerd, wordt opnieuw opstarten gestart. Als u deze waarde verhoogt, wordt de frequentie van onderbrekingen verlaagd vanwege opnieuw opstarten. De toename kan echter ook de tijd verhogen waarin functie-aanroepen de oude of de nieuwe moduleversies, niet-deterministisch, kunnen gebruiken.

Sleutel Voorbeeldwaarde
MDNewSnapshotCheckPeriod 01:00:00

Zie Afhankelijkheidsbeheer voor meer informatie.

MDMinBackgroundUpgradePeriod

De periode na een eerdere controle van een upgrade van beheerde afhankelijkheden voordat een andere upgradecontrole wordt gestart, met een standaardwaarde van 1.00:00:00 (dagelijks).

Als u overmatige module-upgrades wilt voorkomen bij frequente herstarts van werkrollen, wordt het controleren op module-upgrades niet uitgevoerd wanneer er al een werkrol is gestart die de laatste MDMinBackgroundUpgradePeriodcontrole heeft gestart.

Sleutel Voorbeeldwaarde
MDMinBackgroundUpgradePeriod 1.00:00:00

Zie Afhankelijkheidsbeheer voor meer informatie.

PIP_INDEX_URL

Met deze instelling kunt u de basis-URL van de Python-pakketindex overschrijven, wat standaard is https://pypi.org/simple. Gebruik deze instelling wanneer u een externe build moet uitvoeren met behulp van aangepaste afhankelijkheden. Deze aangepaste afhankelijkheden kunnen zich in een pakketindexopslagplaats bevinden die compatibel is met PEP 503 (de EENVOUDIGE OPSLAGPLAATS-API) of in een lokale map die dezelfde indeling volgt.

Sleutel Voorbeeldwaarde
PIP_INDEX_URL http://my.custom.package.repo/simple

Zie pip de documentatie voor aangepaste afhankelijkheden in de Naslaginformatie voor --index-url Python-ontwikkelaars voor meer informatie.

PIP_EXTRA_INDEX_URL

De waarde voor deze instelling geeft een extra index-URL aan voor aangepaste pakketten voor Python-apps, die naast de --index-url. Gebruik deze instelling wanneer u een externe build wilt uitvoeren met behulp van aangepaste afhankelijkheden die zijn gevonden in een extra pakketindex. Moet dezelfde regels volgen als --index-url.

Sleutel Voorbeeldwaarde
PIP_EXTRA_INDEX_URL http://my.custom.package.repo/simple

Zie pip de documentatie voor en aangepaste afhankelijkheden in de Naslaginformatie voor --extra-index-url Python-ontwikkelaars voor meer informatie.

PROJECT

Een instelling voor continue implementatie die aangeeft dat de Kudu-implementatieservice de map in een verbonden opslagplaats heeft om het implementeerbare project te plaatsen.

Sleutel Voorbeeldwaarde
PROJECT WebProject/WebProject.csproj

PYTHON_ISOLATE_WORKER_DEPENDENCIES

De configuratie is specifiek voor Python-functie-apps. Hiermee definieert u de prioriteitsaanduiding van de laadvolgorde van de module. Deze waarde is standaard ingesteld op 0.

Sleutel Weergegeven als Beschrijving
PYTHON_ISOLATE_WORKER_DEPENDENCIES 0 Prioriteit geven aan het laden van de Python-bibliotheken vanuit de afhankelijkheden van de interne Python-werkrol. Dit is het standaardgedrag. Bibliotheken van derden die zijn gedefinieerd in requirements.txt zijn mogelijk schaduw.
PYTHON_ISOLATE_WORKER_DEPENDENCIES 1 Geef prioriteit aan het laden van de Python-bibliotheken vanuit het pakket van de toepassing dat is gedefinieerd in requirements.txt. Dit voorkomt dat uw bibliotheken botsen met de bibliotheken van interne Python-werkrollen.

PYTHON_ENABLE_DEBUG_LOGGING

Hiermee schakelt u logboekregistratie op foutopsporingsniveau in een Python-functie-app in. Een waarde van het inschakelen van 1 logboekregistratie op foutopsporingsniveau. Zonder deze instelling of met een waarde van 0, worden alleen gegevens en logboeken op een hoger niveau verzonden van de Python-werkrol naar de Functions-host. Gebruik deze instelling bij het opsporen van fouten of het traceren van de uitvoeringen van uw Python-functie.

Wanneer u Python-functies foutopsporing uitvoert, moet u indien nodig ook een foutopsporings- of traceringslogboekniveau instellen in het host.json-bestand. Zie Bewaking configureren voor Azure Functions voor meer informatie.

PYTHON_ENABLE_WORKER_EXTENSIONS

De configuratie is specifiek voor Python-functie-apps. Als u dit instelt, 1 kan de werkrol laden in Python-werkuitbreidingen die zijn gedefinieerd in requirements.txt. Hiermee heeft uw functie-app toegang tot nieuwe functies die worden geleverd door pakketten van derden. Het kan ook het gedrag van functiebelasting en aanroep in uw app wijzigen. Zorg ervoor dat de extensie die u kiest betrouwbaar is omdat u het risico loopt dat u deze gebruikt. Azure Functions biedt geen expliciete garanties voor extensies. Ga naar de handmatige pagina of het leesmij-document van de extensie voor informatie over het gebruik van een extensie. Deze waarde wordt standaard ingesteld op 0.

Sleutel Weergegeven als Beschrijving
PYTHON_ENABLE_WORKER_EXTENSIONS 0 Schakel een Python-werkrolextensie uit.
PYTHON_ENABLE_WORKER_EXTENSIONS 1 Toestaan dat Python-werkrollen extensies uit requirements.txt laden.

PYTHON_THREADPOOL_THREAD_COUNT

Hiermee geeft u het maximum aantal threads op dat een Python-taalwerker zou gebruiken om functie-aanroepen uit te voeren, met een standaardwaarde van 1 de Python-versie 3.8 en hieronder. Voor python-versie 3.9 en hoger is de waarde ingesteld op None. Deze instelling garandeert niet het aantal threads dat tijdens uitvoeringen wordt ingesteld. Met de instelling kan Python het aantal threads uitbreiden naar de opgegeven waarde. De instelling is alleen van toepassing op Python Functions-apps. Daarnaast is de instelling van toepassing op synchrone functieaanroepen en niet op coroutines.

Sleutel Voorbeeldwaarde Maximumwaarde
PYTHON_THREADPOOL_THREAD_COUNT 2 32

SCALE_CONTROLLER_LOGGING_ENABLED

Deze instelling is momenteel beschikbaar als preview-versie.

Met deze instelling bepaalt u logboekregistratie van de Azure Functions-schaalcontroller. Zie Controller-logboeken schalen voor meer informatie.

Sleutel Voorbeeldwaarde
SCALE_CONTROLLER_LOGGING_ENABLED AppInsights:Verbose

De waarde voor deze sleutel wordt opgegeven in de notatie <DESTINATION>:<VERBOSITY>, die als volgt wordt gedefinieerd:

Eigenschappen Beschrijving
<DESTINATION> Het doel waarnaar logboeken worden verzonden. Geldige waarden zijn AppInsights en Blob.
Wanneer u deze gebruikt AppInsights, moet u ervoor zorgen dat Application Insights is ingeschakeld in uw functie-app.
Wanneer u het doel Blobinstelt, worden logboeken gemaakt in een blobcontainer met de naam azure-functions-scale-controller in het standaardopslagaccount dat is ingesteld in de AzureWebJobsStorage toepassingsinstelling.
<VERBOSITY> Hiermee geeft u het niveau van logboekregistratie op. Ondersteunde waarden zijn None, Warningen Verbose.
Wanneer dit is ingesteld Verbose, registreert de schaalcontroller een reden voor elke wijziging in het aantal werknemers en informatie over de triggers die in deze beslissingen van invloed zijn. Uitgebreide logboeken bevatten triggerwaarschuwingen en de hashes die door de triggers worden gebruikt voor en nadat de schaalcontroller wordt uitgevoerd.

Tip

Houd er rekening mee dat wanneer u de logboekregistratie van de schaalcontroller ingeschakeld laat, dit van invloed is op de mogelijke kosten voor het bewaken van uw functie-app. Overweeg logboekregistratie in te schakelen totdat u voldoende gegevens hebt verzameld om te begrijpen hoe de schaalcontroller werkt en deze vervolgens uit te schakelen.

SCM_DO_BUILD_DURING_DEPLOYMENT

Hiermee bepaalt u het gedrag van externe build tijdens de implementatie. Wanneer SCM_DO_BUILD_DURING_DEPLOYMENT dit is ingesteld true, wordt het project tijdens de implementatie op afstand gebouwd.

Sleutel Voorbeeldwaarde
SCM_DO_BUILD_DURING_DEPLOYMENT true

SCM_LOGSTREAM_TIMEOUT

Hiermee bepaalt u de time-out, in seconden, wanneer deze is verbonden met streaminglogboeken. De standaardwaarde is 7200 (2 uur).

Sleutel Voorbeeldwaarde
SCM_LOGSTREAM_TIMEOUT 1800

Met de bovenstaande voorbeeldwaarde wordt 1800 een time-out van 30 minuten ingesteld. Zie Logboeken voor streaming-uitvoering inschakelen in Azure Functions voor meer informatie.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Verbindingsreeks voor opslagaccount waarin de code en configuratie van de functie-app worden opgeslagen in gebeurtenisgestuurde schaalplannen. Zie de verbindingsinstelling voor het opslagaccount voor meer informatie.

Sleutel Voorbeeldwaarde
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=...

Deze instelling is vereist voor verbruiks- en Elastic Premium-abonnements-apps die worden uitgevoerd op zowel Windows als Linux. Het is niet vereist voor toegewezen plan-apps, die niet dynamisch worden geschaald door Functions.

Als u deze instelling wijzigt of verwijdert, kan uw functie-app niet worden gestart. Zie dit artikel voor probleemoplossing voor meer informatie.

Azure Files biedt geen ondersteuning voor het gebruik van beheerde identiteit bij het openen van de bestandsshare. Zie ondersteunde verificatiescenario's voor Azure Files voor meer informatie.

WEBSITE_CONTENTOVERVNET

Belangrijk

WEBSITE_CONTENTOVERVNET is een verouderde app-instelling die is vervangen door de site-eigenschap vnetContentShareEnabled .

Een waarde waarmee 1 uw functie-app kan worden geschaald wanneer uw opslagaccount is beperkt tot een virtueel netwerk. Schakel deze instelling in wanneer u uw opslagaccount beperkt tot een virtueel netwerk. Alleen vereist bij gebruik WEBSITE_CONTENTSHARE en WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Zie Uw opslagaccount beperken tot een virtueel netwerk voor meer informatie.

Sleutel Voorbeeldwaarde
WEBSITE_CONTENTOVERVNET 1

Deze app-instelling is vereist voor de Elastic Premium - en Dedicated-abonnementen (App Service) (Standard en hoger). Niet ondersteund bij het uitvoeren van een verbruiksabonnement.

Notitie

U moet er speciaal voor zorgen dat u doorsturen naar de inhoudsshare in een opslagaccount dat wordt gedeeld door meerdere functie-apps in hetzelfde plan. Zie consistent routeren via virtuele netwerken in het artikel Over overwegingen voor opslag voor meer informatie.

WEBSITE_CONTENTSHARE

De naam van de bestandsshare die Functions gebruikt om code en configuratiebestanden van de functie-app op te slaan. Deze inhoud is vereist voor gebeurtenisgestuurde schaalplannen. Gebruikt met WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. De standaardwaarde is een unieke tekenreeks die wordt gegenereerd door de runtime, die begint met de naam van de functie-app. Zie de verbindingsinstelling voor het opslagaccount voor meer informatie.

Sleutel Voorbeeldwaarde
WEBSITE_CONTENTSHARE functionapp091999e2

Deze instelling is vereist voor verbruiks- en Premium-abonnements-apps in zowel Windows als Linux. Het is niet vereist voor toegewezen plan-apps, die niet dynamisch worden geschaald door Functions.

De share wordt gemaakt wanneer uw functie-app wordt gemaakt. Als u deze instelling wijzigt of verwijdert, kan uw functie-app niet worden gestart. Zie dit artikel voor probleemoplossing voor meer informatie.

De volgende overwegingen zijn van toepassing wanneer u een ARM-sjabloon (Azure Resource Manager) of Bicep-bestand gebruikt om een functie-app te maken tijdens de implementatie:

  • Wanneer u geen WEBSITE_CONTENTSHARE waarde instelt voor de hoofdfunctie-app of apps in sleuven, worden unieke sharewaarden voor u gegenereerd. WEBSITE_CONTENTSHARE Het is niet de aanbevolen methode voor een ARM-sjabloonimplementatie.
  • Er zijn scenario's waarin u de WEBSITE_CONTENTSHARE waarde moet instellen op een vooraf gedefinieerde waarde, bijvoorbeeld wanneer u een beveiligd opslagaccount in een virtueel netwerk gebruikt. In dit geval moet u een unieke sharenaam instellen voor de hoofdfunctie-app en de app voor elke implementatiesite. In het geval van een opslagaccount dat wordt beveiligd door een virtueel netwerk, moet u ook de share zelf maken als onderdeel van uw geautomatiseerde implementatie. Zie Beveiligde implementaties voor meer informatie.
  • Maak geen WEBSITE_CONTENTSHARE site-instelling.
  • Wanneer u opgeeftWEBSITE_CONTENTSHARE, moet de waarde deze richtlijnen voor sharenamen volgen.

WEBSITE_DNS_SERVER

Hiermee stelt u de DNS-server in die door een app wordt gebruikt bij het omzetten van IP-adressen. Deze instelling is vaak vereist bij het gebruik van bepaalde netwerkfunctionaliteit, zoals privézones van Azure DNS en privé-eindpunten.

Sleutel Voorbeeldwaarde
WEBSITE_DNS_SERVER 168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

Hiermee bepaalt u of Brotli-codering wordt gebruikt voor compressie in plaats van de standaard gzip-compressie. Wanneer WEBSITE_ENABLE_BROTLI_ENCODING deze is ingesteld 1op, wordt Brotli-codering gebruikt; anders wordt gzip-codering gebruikt.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Hiermee schakelt u caching uit bij het implementeren van functie-apps met behulp van ARM-sjablonen (Azure Resource Manager).

Sleutel Voorbeeldwaarde
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED 0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Het maximum aantal exemplaren waarnaar de app kan worden uitgeschaald. De standaardwaarde is geen limiet.

Belangrijk

Deze instelling is in preview. Er is een app-eigenschap toegevoegd voor het maximale uitschalen van functies en is de aanbevolen manier om uitschalen te beperken.

Sleutel Voorbeeldwaarde
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 5

WEBSITE_NODE_DEFAULT_VERSION

Alleen Windows. Hiermee stelt u de versie van Node.js in die moet worden gebruikt bij het uitvoeren van uw functie-app in Windows. U moet een tilde (~) gebruiken om de runtime de meest recente beschikbare versie van de doel primaire versie te laten gebruiken. Wanneer dit bijvoorbeeld is ingesteld ~18, wordt de nieuwste versie van Node.js 18 gebruikt. Wanneer een primaire versie is gericht op een tilde, hoeft u de secundaire versie niet handmatig bij te werken.

Sleutel Voorbeeldwaarde
WEBSITE_NODE_DEFAULT_VERSION ~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Wanneer u een sitewisseling uitvoert voor een functie-app die wordt uitgevoerd in een Premium-abonnement, kan de wissel mislukken wanneer het toegewezen opslagaccount dat door de app wordt gebruikt, is beperkt tot het netwerk. Deze fout wordt veroorzaakt door een verouderde functie voor toepassingslogboeken, die wordt gedeeld door zowel Functions als App Service. Met deze instelling wordt de verouderde functie voor logboekregistratie overschreven en kan de wissel plaatsvinden.

Sleutel Voorbeeldwaarde
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS 0

Voeg WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS een waarde toe aan 0 alle sites om ervoor te zorgen dat verouderde diagnostische instellingen uw wisselingen niet blokkeren. U kunt deze instelling en waarde ook toevoegen aan alleen de productiesite als een sticky-instelling (implementatiesite).

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

Standaard zijn de versie-instellingen voor functie-apps specifiek voor elke site. Deze instelling wordt gebruikt bij het upgraden van functies met behulp van implementatiesites. Dit voorkomt onverwacht gedrag als gevolg van het wijzigen van versies na een wissel. Ingesteld op 0 in productie en in de site om ervoor te zorgen dat alle versie-instellingen ook worden gewisseld. Zie Upgraden met behulp van sites voor meer informatie.

Sleutel Voorbeeldwaarde
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS 0

WEBSITE_RUN_FROM_PACKAGE

Hiermee kan uw functie-app worden uitgevoerd vanuit een pakketbestand, dat lokaal kan worden gekoppeld of geïmplementeerd in een externe URL.

Sleutel Voorbeeldwaarde
WEBSITE_RUN_FROM_PACKAGE 1

Geldige waarden zijn een URL die wordt omgezet in de locatie van een extern implementatiepakketbestand of 1. Als dit is ingesteld 1, moet het pakket zich in de d:\home\data\SitePackages map bevinden. Wanneer u zip-implementatie gebruikt met WEBSITE_RUN_FROM_PACKAGE ingeschakeld, wordt het pakket automatisch geüpload naar deze locatie. In de preview is deze instelling benoemd WEBSITE_RUN_FROM_ZIP. Zie Uw functies uitvoeren vanuit een pakketbestand voor meer informatie.

Wanneer u implementeert vanuit een externe pakket-URL, moet u ook handmatig triggers synchroniseren. Zie Synchronisatie van triggers voor meer informatie.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

De instellingen voor WEBSITE_CONTENTAZUREFILECONNECTIONSTRING en WEBSITE_CONTENTSHARE hebben extra validatiecontroles om ervoor te zorgen dat de app correct kan worden gestart. Het maken van toepassingsinstellingen mislukt wanneer de functie-app het downstreamopslagaccount of key vault niet correct kan aanroepen vanwege netwerkbeperkingen of andere beperkende factoren. Wanneer WEBSITE_SKIP_CONTENTSHARE_VALIDATION is ingesteld 1op, wordt de validatiecontrole overgeslagen; anders wordt de waarde standaard 0 ingesteld en vindt de validatie plaats.

Sleutel Voorbeeldwaarde
WEBSITE_SKIP_CONTENTSHARE_VALIDATION 1

Als de validatie wordt overgeslagen en de verbindingsreeks of inhoudsshare niet geldig is, kan de app niet goed worden gestart. In dit geval retourneren functies HTTP 500-fouten. Zie Fout oplossen voor meer informatie: 'Azure Functions Runtime is onbereikbaar'

WEBSITE_SLOT_NAME

Alleen-lezen. Naam van de huidige implementatiesite. De naam van de productiesite is Production.

Sleutel Voorbeeldwaarde
WEBSITE_SLOT_NAME Production

WEBSITE_TIME_ZONE

Hiermee kunt u de tijdzone voor uw functie-app instellen.

Sleutel Besturingssysteem Voorbeeldwaarde
WEBSITE_TIME_ZONE Windows Eastern Standard Time
WEBSITE_TIME_ZONE Linux America/New_York

De standaardtijdzone die wordt gebruikt met CRON-expressies is Coordinated Universal Time (UTC). Als u uw CRON-expressie wilt laten gebaseerd op een andere tijdzone, maakt u een app-instelling voor uw functie-app met de naam WEBSITE_TIME_ZONE.

De waarde van deze instelling is afhankelijk van het besturingssysteem en de planning waarop uw functie-app wordt uitgevoerd.

Besturingssysteem Plannen Weergegeven als
Windows Alle Stel de waarde in op de naam van de gewenste tijdzone, zoals opgegeven door de tweede regel van elk paar dat is opgegeven door de Windows-opdracht tzutil.exe /L
Linux Premium
Toegewezen		 Stel de waarde in op de naam van de gewenste tijdzone, zoals wordt weergegeven in de tz-database.

Notitie

WEBSITE_TIME_ZONE en TZ worden momenteel niet ondersteund bij uitvoering op Linux in een verbruiksabonnement. In dit geval kunt u ssl-gerelateerde problemen instellen WEBSITE_TIME_ZONE of TZ maken en ervoor zorgen dat metrische gegevens niet meer werken voor uw app.

Eastern Time in de VS (vertegenwoordigd door Eastern Standard Time (Windows) of America/New_York (Linux)) gebruikt momenteel UTC-05:00 tijdens de standaardtijd en UTC-04:00 tijdens de zomertijd. Als u elke dag een timertrigger wilt activeren om 10:00 uur Eastern Time, maakt u een app-instelling voor uw functie-app met de naam WEBSITE_TIME_ZONE, stelt u de waarde Eastern Standard Time in op (Windows) of America/New_York (Linux) en gebruikt u vervolgens de volgende NCRONTAB-expressie:

"0 0 10 * * *"

Wanneer u de tijd gebruikt WEBSITE_TIME_ZONE , wordt aangepast voor tijdwijzigingen in de specifieke tijdzone, inclusief zomertijd en wijzigingen in de standaardtijd.

WEBSITE_USE_PLACEHOLDER

Hiermee wordt aangegeven of u een specifieke optimalisatie voor koude start wilt gebruiken bij het uitvoeren van het verbruiksabonnement. Ingesteld om 0 de optimalisatie voor koude start uit te schakelen voor het verbruiksabonnement.

Sleutel Voorbeeldwaarde
WEBSITE_USE_PLACEHOLDER 1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Hiermee wordt aangegeven of u een specifieke optimalisatie voor koude start moet gebruiken bij het uitvoeren van .NET geïsoleerde werkprocesfuncties in het verbruiksabonnement. Ingesteld om 0 de optimalisatie voor koude start uit te schakelen voor het verbruiksabonnement.

Sleutel Voorbeeldwaarde
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED 1

WEBSITE_VNET_ROUTE_ALL

Belangrijk

WEBSITE_VNET_ROUTE_ALL is een verouderde app-instelling die is vervangen door de site-instelling vnetRouteAllEnabled .

Hiermee wordt aangegeven of al het uitgaande verkeer van de app wordt gerouteerd via het virtuele netwerk. Een instellingswaarde waarmee 1 wordt aangegeven dat al het toepassingsverkeer wordt gerouteerd via het virtuele netwerk. U hebt deze instelling nodig bij het configureren van regionale virtuele netwerkintegratie in de Elastic Premium- en Dedicated-hostingabonnementen. Deze wordt ook gebruikt wanneer een NAT-gateway van een virtueel netwerk wordt gebruikt om een statisch uitgaand IP-adres te definiëren.

Sleutel Voorbeeldwaarde
WEBSITE_VNET_ROUTE_ALL 1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Hiermee wordt aangegeven of de /home map wordt gedeeld tussen geschaalde exemplaren, met een standaardwaarde van true. U moet dit instellen wanneer false u uw functie-app in een container implementeert.

App Service-site-instellingen

Sommige configuraties moeten worden onderhouden op App Service-niveau als site-instellingen, zoals taalversies. Deze instellingen worden beheerd in de portal, met behulp van REST API's of met behulp van Azure CLI of Azure PowerShell. Hieronder vindt u site-instellingen die mogelijk vereist zijn, afhankelijk van uw runtimetaal, besturingssysteem en versies:

AcrUseManagedIdentityCreds

Hiermee wordt aangegeven of de installatiekopieën worden verkregen van een Azure Container Registry-exemplaar met behulp van verificatie van beheerde identiteiten. Een waarde van true vereist dat beheerde identiteit wordt gebruikt, wat wordt aanbevolen voor opgeslagen verificatiereferenties als een best practice voor beveiliging.

AcrUserManagedIdentityID

Geeft de beheerde identiteit aan die moet worden gebruikt bij het verkrijgen van de installatiekopieën van een Azure Container Registry-exemplaar. Vereist dat deze AcrUseManagedIdentityCreds is ingesteld op true. Dit zijn de geldige waarden:

Weergegeven als Beschrijving
system De door het systeem toegewezen beheerde identiteit van de functie-app wordt gebruikt.
<USER_IDENTITY_RESOURCE_ID> De volledig gekwalificeerde resource-id van een door de gebruiker toegewezen beheerde identiteit.

De identiteit die u opgeeft, moet worden toegevoegd aan de ACRPull rol in het containerregister. Zie Een functie-app maken en configureren in Azure met de installatiekopieën voor meer informatie.

alwaysOn

In een functie-app die wordt uitgevoerd in een Toegewezen (App Service)-plan, wordt de Functions-runtime na een paar minuten inactiviteit inactief, waardoor alleen aanvragen naar een HTTP-trigger worden geactiveerd wanneer uw functie-app wordt geactiveerd. Om ervoor te zorgen dat uw niet-HTTP geactiveerde functies correct worden uitgevoerd, inclusief timertriggerfuncties, schakelt u AlwaysOn in voor de functie-app door de alwaysOn site-instelling in te stellen op een waarde van true.

functionsRuntimeAdminIsolationEnabled

Bepaalt of de ingebouwde beheerderseindpunten in/admin uw functie-app toegankelijk zijn. Wanneer deze optie is ingesteld op false (de standaardinstelling), staat de app aanvragen toe aan eindpunten onder /admin wanneer deze aanvragen een hoofdsleutel in de aanvraag presenteren. Wanneer true, /admin eindpunten kunnen niet worden geopend, zelfs met een hoofdsleutel.

Deze eigenschap kan niet worden ingesteld voor apps die worden uitgevoerd op de linux-verbruiks-SKU en kan niet worden ingesteld voor apps die worden uitgevoerd op versie 1.x van Azure Functions. Als u versie 1.x gebruikt, moet u eerst migreren naar versie 4.x.

linuxFxVersion

Voor functie-apps die worden uitgevoerd in Linux, linuxFxVersion geeft u de taal en versie voor het taalspecifieke werkproces aan. Deze informatie wordt gebruikt, samen met FUNCTIONS_EXTENSION_VERSION, om te bepalen welke specifieke Linux-containerinstallatiekopieën zijn geïnstalleerd om uw functie-app uit te voeren. Deze instelling kan worden ingesteld op een vooraf gedefinieerde waarde of een aangepaste afbeeldings-URI.

Deze waarde wordt voor u ingesteld wanneer u uw Linux-functie-app maakt. Mogelijk moet u deze instellen voor ARM-sjabloon en Bicep-implementaties en in bepaalde upgradescenario's.

Geldige linuxFxVersion-waarden

U kunt de volgende Azure CLI-opdracht gebruiken om een tabel met huidige linuxFxVersion waarden weer te geven, door de ondersteunde runtimeversie van Functions:

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

Voor de vorige opdracht moet u upgraden naar versie 2.40 van de Azure CLI.

Aangepaste installatiekopieën

Wanneer u uw eigen aangepaste Linux-container voor uw functie-app maakt en onderhoudt, heeft de linuxFxVersion waarde in plaats daarvan de indeling DOCKER|<IMAGE_URI>, zoals in het volgende voorbeeld:

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

Dit geeft de registerbron van de geïmplementeerde container aan. Zie Werken met containers en Azure Functions voor meer informatie.

Belangrijk

Wanneer u uw eigen containers maakt, moet u de basisinstallatiekopieën van uw container bijwerken naar de meest recente ondersteunde basisinstallatiekopieën. Ondersteunde basisinstallatiekopieën voor Azure Functions zijn taalspecifiek en bevinden zich in de basisinstallatiekopieën van Azure Functions.

Het Functions-team zet zich in voor het publiceren van maandelijkse updates voor deze basisinstallatiekopieën. Regelmatige updates bevatten de meest recente secundaire versie-updates en beveiligingscorrecties voor zowel de Functions-runtime als de talen. Werk uw container regelmatig bij vanaf de meest recente basisinstallatiekopie en implementeer de bijgewerkte versie van uw container opnieuw.

netFrameworkVersion

Hiermee stelt u de specifieke versie van .NET voor C#-functies in. Zie Uw functie-app bijwerken in Azure voor meer informatie.

powerShellVersion

Hiermee stelt u de specifieke versie van PowerShell in waarop uw functies worden uitgevoerd. Zie De PowerShell-versie wijzigen voor meer informatie.

Wanneer u lokaal werkt, gebruikt u in plaats daarvan de FUNCTIONS_WORKER_RUNTIME_VERSION instelling in het local.settings.json-bestand.

vnetContentShareEnabled

Apps die worden uitgevoerd in een Premium-abonnement gebruiken een bestandsshare om inhoud op te slaan. De naam van deze inhoudsshare wordt opgeslagen in de app-instelling en de WEBSITE_CONTENTSHARE bijbehorende verbindingsreeks wordt opgeslagen in WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Als u verkeer wilt routeren tussen uw functie-app en inhoudsshare via een virtueel netwerk, moet u ook instellen op vnetContentShareEnabled true. Het inschakelen van deze site-eigenschap is een vereiste wanneer u uw opslagaccount beperkt tot een virtueel netwerk in de Elastic Premium- en Dedicated-hostingabonnementen.

Notitie

U moet er speciaal voor zorgen dat u doorsturen naar de inhoudsshare in een opslagaccount dat wordt gedeeld door meerdere functie-apps in hetzelfde plan. Zie consistent routeren via virtuele netwerken in het artikel Over overwegingen voor opslag voor meer informatie.

Deze site-eigenschap vervangt de verouderde WEBSITE_CONTENTOVERVNET instelling.

vnetImagePullEnabled

Functions ondersteunt functie-apps die worden uitgevoerd in Linux-containers. Als u verbinding wilt maken en ophalen uit een containerregister in een virtueel netwerk, moet u instellen op vnetImagePullEnabled true. Deze site-eigenschap wordt ondersteund in de Elastic Premium- en Dedicated-hostingabonnementen. Het Flex Consumption-abonnement is niet afhankelijk van site-eigenschappen of app-instellingen voor het configureren van netwerken. Zie Afschaffingen van flexverbruiksabonnementen voor meer informatie.

vnetRouteAllEnabled

Hiermee wordt aangegeven of al het uitgaande verkeer van de app wordt gerouteerd via het virtuele netwerk. Een instellingswaarde waarmee true wordt aangegeven dat al het toepassingsverkeer wordt gerouteerd via het virtuele netwerk. Gebruik deze instelling bij het configureren van regionale virtuele netwerkintegratie in de Elastic Premium- en Dedicated-abonnementen. Deze wordt ook gebruikt wanneer een NAT-gateway van een virtueel netwerk wordt gebruikt om een statisch uitgaand IP-adres te definiëren. Zie Toepassingsroutering configureren voor meer informatie.

Deze site-instelling vervangt de verouderde WEBSITE_VNET_ROUTE_ALL instelling.

Afschaffingen van Flex Consumption-abonnement

In het Flex Consumption-abonnement worden deze site-eigenschappen en toepassingsinstellingen afgeschaft en mogen deze niet worden gebruikt bij het maken van resources voor functie-apps:

Instelling/eigenschap Reden
ENABLE_ORYX_BUILD Vervangen door de parameter bij de remoteBuild implementatie in Flex Consumption
FUNCTIONS_EXTENSION_VERSION App-instelling wordt ingesteld door de back-end. Een waarde van ~1 kan worden genegeerd.
FUNCTIONS_WORKER_RUNTIME Vervangen door name in properties.functionAppConfig.runtime
FUNCTIONS_WORKER_RUNTIME_VERSION Vervangen door version in properties.functionAppConfig.runtime
FUNCTIONS_MAX_HTTP_CONCURRENCY Vervangen door de triggersectie van schaal en gelijktijdigheid
FUNCTIONS_WORKER_PROCESS_COUNT Instelling is ongeldig
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED Instelling is ongeldig
SCM_DO_BUILD_DURING_DEPLOYMENT Vervangen door de parameter bij de remoteBuild implementatie in Flex Consumption
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Vervangen door de implementatiesectie van functionAppConfig
WEBSITE_CONTENTOVERVNET Niet gebruikt voor netwerken in Flex Consumption
WEBSITE_CONTENTSHARE Vervangen door de implementatiesectie van functionAppConfig
WEBSITE_DNS_SERVER DNS wordt overgenomen van het geïntegreerde virtuele netwerk in Flex
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Vervangen door maximumInstanceCount in properties.functionAppConfig.scaleAndConcurrency
WEBSITE_NODE_DEFAULT_VERSION Vervangen door version in properties.functionAppConfig.runtime
WEBSITE_RUN_FROM_PACKAGE Niet gebruikt voor implementaties in Flex Consumption
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Inhoudsshare wordt niet gebruikt in Flex Consumption
WEBSITE_VNET_ROUTE_ALL Niet gebruikt voor netwerken in Flex Consumption
properties.alwaysOn Niet geldig
properties.containerSize Hernoemd als instanceMemoryMB
properties.ftpsState FTPS wordt niet ondersteund
properties.isReserved Niet geldig
properties.IsXenon Niet geldig
properties.javaVersion Vervangen door version in properties.functionAppConfig.runtime
properties.LinuxFxVersion Vervangen door properties.functionAppConfig.runtime
properties.netFrameworkVersion Vervangen door version in properties.functionAppConfig.runtime
properties.powerShellVersion Vervangen door version in properties.functionAppConfig.runtime
properties.siteConfig.functionAppScaleLimit Hernoemd als maximumInstanceCount
properties.siteConfig.preWarmedInstanceCount Hernoemd als alwaysReadyInstances
properties.use32BitWorkerProcess 32-bits wordt niet ondersteund
properties.vnetBackupRestoreEnabled Niet gebruikt voor netwerken in Flex Consumption
properties.vnetContentShareEnabled Niet gebruikt voor netwerken in Flex Consumption
properties.vnetImagePullEnabled Niet gebruikt voor netwerken in Flex Consumption
properties.vnetRouteAllEnabled Niet gebruikt voor netwerken in Flex Consumption
properties.windowsFxVersion Niet geldig

Volgende stappen

Meer informatie over het bijwerken van app-instellingen

Configuratie-instellingen in het host.json-bestand bekijken

Andere app-instellingen voor App Service-apps bekijken