Delen via


Web Apps - Create Or Update Configuration

Beschrijving voor Werkt de configuratie van een app bij.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/web?api-version=2025-05-01

URI-parameters

Name In Vereist Type Description
name
path True

string

Naam van de app.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
kind

string

Soort resource. Als de resource een app is, kunt u verwijzen naar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference voor meer informatie over ondersteunde waarden voor soort.

properties.acrUseManagedIdentityCreds

boolean

Vlag voor het gebruik van Managed Identity Creds voor ACR-pull

properties.acrUserManagedIdentityID

string

Als u een door de gebruiker beheerde identiteit gebruikt, wordt de client-id van de door de gebruiker beheerde identiteit gebruikt

properties.alwaysOn

boolean

true als Altijd aan is ingeschakeld; anders, false.

properties.apiDefinition

ApiDefinitionInfo

Informatie over de formele API-definitie voor de app.

properties.apiManagementConfig

ApiManagementConfig

Azure API Management-instellingen die zijn gekoppeld aan de app.

properties.appCommandLine

string

De opdrachtregel van de app om te starten.

properties.appSettings

NameValuePair[]

Toepassingsinstellingen. Deze eigenschap wordt niet geretourneerd als reactie op normale aanmaak- en leesverzoeken, omdat deze gevoelige informatie kan bevatten.

properties.autoHealEnabled

boolean

true als Automatisch genezen is ingeschakeld; anders, false.

properties.autoHealRules

AutoHealRules

Regels voor automatisch herstellen.

properties.autoSwapSlotName

string

Naam van automatisch wisselen van site.

properties.azureStorageAccounts

<string,  AzureStorageInfoValue>

Lijst met Azure Storage-accounts.

properties.connectionStrings

ConnStringInfo[]

Verbindingsreeksen Deze eigenschap wordt niet geretourneerd als reactie op normale aanmaak- en leesverzoeken, omdat deze gevoelige informatie kan bevatten.

properties.cors

CorsSettings

CORS-instellingen (Cross-Origin Resource Sharing).

properties.defaultDocuments

string[]

Standaarddocumenten.

properties.detailedErrorLoggingEnabled

boolean

true als gedetailleerde foutregistratie is ingeschakeld; anders, false.

properties.documentRoot

string

Hoofdmap van het document.

properties.elasticWebAppScaleLimit

integer (int32)

minimum: 0

Maximum aantal werknemers waarnaar een site kan worden uitgeschaald. Deze instelling is alleen van toepassing op apps in abonnementen waarop ElasticScaleEnabled is true

properties.experiments

Experiments

Dit is een oplossing voor polymorfe typen.

properties.ftpsState

FtpsState

Status van FTP/FTPS-service

properties.functionAppScaleLimit

integer (int32)

minimum: 0

Maximum aantal werknemers waarnaar een site kan worden uitgeschaald. Deze instelling is alleen van toepassing op de abonnementen Verbruik en Elastic Premium

properties.functionsRuntimeScaleMonitoringEnabled

boolean

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of bewaking van de runtimeschaal van functions is ingeschakeld. Als deze optie is ingeschakeld, controleert de ScaleController de gebeurtenisbronnen niet rechtstreeks, maar roept deze in plaats daarvan de runtime aan om de schaalstatus op te halen.

properties.handlerMappings

HandlerMapping[]

Handlertoewijzingen.

properties.healthCheckPath

string

Pad voor statuscontrole

properties.http20Enabled

boolean

Http20Enabled: hiermee configureert u een website zodat clients verbinding kunnen maken via http2.0

properties.http20ProxyFlag

integer (int32)

Http20ProxyFlag: Configureert een website om toe te staan dat http2.0 wordt doorgegeven aan de app. 0 = uitgeschakeld, 1 = al het http2-verkeer doorgeven, 2 = alleen door gRPC gaan.

properties.httpLoggingEnabled

boolean

true als HTTP-logging is ingeschakeld; anders, false.

properties.ipSecurityRestrictions

IpSecurityRestriction[]

IP-beveiligingsbeperkingen voor de hoofdmap.

properties.ipSecurityRestrictionsDefaultAction

DefaultAction

Standaardactie voor hoofdtoegangsbeperking als er geen regels overeenkomen.

properties.javaContainer

string

Java-container.

properties.javaContainerVersion

string

Java-containerversie.

properties.javaVersion

string

Java-versie.

properties.keyVaultReferenceIdentity

string

Identiteit die moet worden gebruikt voor Key Vault-referentieverificatie.

properties.limits

SiteLimits

Sitelimieten.

properties.linuxFxVersion

string

Linux App Framework en versie

properties.loadBalancing

SiteLoadBalancing

Sitetaakverdeling.

properties.localMySqlEnabled

boolean

true om lokale MySQL mogelijk te maken; anders, false.

properties.logsDirectorySizeLimit

integer (int32)

Limiet voor mapgrootte van HTTP-logboeken.

properties.managedPipelineMode

ManagedPipelineMode

Beheerde pijplijnmodus.

properties.managedServiceIdentityId

integer (int32)

Id van beheerde service-id

properties.metadata

NameValuePair[]

Metagegevens van toepassingen. Deze eigenschap kan niet worden opgehaald, omdat deze geheimen kan bevatten.

properties.minTlsCipherSuite

TlsCipherSuites

De minimaal toegestane TLS-coderingssuite voor een toepassing

properties.minTlsVersion

SupportedTlsVersions

MinTlsVersion: configureert de minimale versie van TLS die is vereist voor SSL-aanvragen

properties.minimumElasticInstanceCount

integer (int32)

minimum: 0
maximum: 20

Minimaal aantal exemplaren voor een site Deze instelling is alleen van toepassing op de elastische plannen

properties.netFrameworkVersion

string

.NET Framework-versie.

properties.nodeVersion

string

Versie van Node.js.

properties.numberOfWorkers

integer (int32)

Aantal werknemers.

properties.phpVersion

string

Versie van PHP.

properties.powerShellVersion

string

Versie van PowerShell.

properties.preWarmedInstanceCount

integer (int32)

minimum: 0
maximum: 10

Aantal voorafwarmde exemplaren. Deze instelling is alleen van toepassing op de verbruiks- en elastische abonnementen

properties.publicNetworkAccess

string

Eigenschap om al het openbare verkeer toe te staan of te blokkeren.

properties.publishingUsername

string

Gebruikersnaam publiceren.

properties.push

PushSettings

Push-eindpuntinstellingen.

properties.pythonVersion

string

Versie van Python.

properties.remoteDebuggingEnabled

boolean

true als foutopsporing op afstand is ingeschakeld; anders, false.

properties.remoteDebuggingVersion

string

Versie voor foutopsporing op afstand.

properties.requestTracingEnabled

boolean

true als tracering van verzoeken is ingeschakeld; anders, false.

properties.requestTracingExpirationTime

string (date-time)

Verlooptijd van tracering aanvragen.

properties.scmIpSecurityRestrictions

IpSecurityRestriction[]

IP-beveiligingsbeperkingen voor scm.

properties.scmIpSecurityRestrictionsDefaultAction

DefaultAction

Standaardactie voor scm-toegangsbeperking als er geen regels overeenkomen.

properties.scmIpSecurityRestrictionsUseMain

boolean

IP-beveiligingsbeperkingen voor scm om hoofd te gebruiken.

properties.scmMinTlsVersion

SupportedTlsVersions

ScmMinTlsVersion: configureert de minimale versie van TLS die is vereist voor SSL-aanvragen voor SCM-site

properties.scmType

ScmType

SCM-type.

properties.tracingOptions

string

Traceringsopties.

properties.use32BitWorkerProcess

boolean

true om 32-bits werkprocessen te gebruiken; anders, false.

properties.virtualApplications

VirtualApplication[]

Virtuele toepassingen.

properties.vnetName

string

Naam van virtueel netwerk.

properties.vnetPrivatePortsCount

integer (int32)

Het aantal privépoorten dat aan deze app is toegewezen. Deze worden dynamisch toegewezen in runtime.

properties.vnetRouteAllEnabled

boolean

Virtual Network Route All ingeschakeld. Dit zorgt ervoor dat al het uitgaande verkeer virtuele netwerkbeveiligingsgroepen en door de gebruiker gedefinieerde routes heeft toegepast.

properties.webSocketsEnabled

boolean

true als WebSocket is ingeschakeld; anders, false.

properties.websiteTimeZone

string

Hiermee stelt u de tijdzone in die een site gebruikt voor het genereren van tijdstempels. Compatibel met Linux en Windows App Service. Het instellen van de WEBSITE_TIME_ZONE app-instelling heeft voorrang op deze configuratie. Voor Linux worden tz-databasewaarden verwacht https://www.iana.org/time-zones (zie https://en.wikipedia.org/wiki/List_of_tz_database_time_zonesvoor een beknopt overzicht). Voor Windows verwacht u een van de tijdzones die worden vermeld onder HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones

properties.windowsFxVersion

string

Xenon App Framework en versie

properties.xManagedServiceIdentityId

integer (int32)

Expliciete id van beheerde service-id

Antwoorden

Name Type Description
200 OK

SiteConfigResource

De updateoperatie van de bron 'SiteConfigResource' is geslaagd

Other Status Codes

DefaultErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Update Site Config

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/config/web?api-version=2025-05-01

{
  "properties": {
    "acrUseManagedIdentityCreds": false,
    "alwaysOn": false,
    "appCommandLine": "",
    "autoHealEnabled": false,
    "azureStorageAccounts": {},
    "defaultDocuments": [
      "Default.htm",
      "Default.html",
      "Default.asp",
      "index.htm",
      "index.html",
      "iisstart.htm",
      "default.aspx",
      "index.php",
      "hostingstart.html"
    ],
    "detailedErrorLoggingEnabled": false,
    "ftpsState": "AllAllowed",
    "functionAppScaleLimit": 0,
    "functionsRuntimeScaleMonitoringEnabled": false,
    "http20Enabled": false,
    "httpLoggingEnabled": false,
    "linuxFxVersion": "",
    "loadBalancing": "LeastRequests",
    "logsDirectorySizeLimit": 35,
    "managedPipelineMode": "Integrated",
    "minTlsVersion": "1.2",
    "minimumElasticInstanceCount": 0,
    "netFrameworkVersion": "v4.0",
    "nodeVersion": "",
    "numberOfWorkers": 1,
    "phpVersion": "5.6",
    "powerShellVersion": "",
    "pythonVersion": "",
    "remoteDebuggingEnabled": false,
    "requestTracingEnabled": false,
    "scmMinTlsVersion": "1.2",
    "use32BitWorkerProcess": true,
    "virtualApplications": [
      {
        "physicalPath": "site\\wwwroot",
        "preloadEnabled": false,
        "virtualPath": "/"
      }
    ],
    "vnetName": "",
    "vnetPrivatePortsCount": 0,
    "vnetRouteAllEnabled": false,
    "webSocketsEnabled": false
  }
}

Voorbeeldrespons

{
  "name": "web",
  "type": "Microsoft.Web/sites/config",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141/config/web",
  "kind": "app",
  "properties": {
    "acrUseManagedIdentityCreds": false,
    "alwaysOn": false,
    "appCommandLine": "",
    "autoHealEnabled": false,
    "azureStorageAccounts": {},
    "defaultDocuments": [
      "Default.htm",
      "Default.html",
      "Default.asp",
      "index.htm",
      "index.html",
      "iisstart.htm",
      "default.aspx",
      "index.php",
      "hostingstart.html"
    ],
    "detailedErrorLoggingEnabled": false,
    "ftpsState": "AllAllowed",
    "functionAppScaleLimit": 0,
    "functionsRuntimeScaleMonitoringEnabled": false,
    "http20Enabled": false,
    "httpLoggingEnabled": false,
    "linuxFxVersion": "",
    "loadBalancing": "LeastRequests",
    "logsDirectorySizeLimit": 35,
    "managedPipelineMode": "Integrated",
    "minTlsVersion": "1.2",
    "minimumElasticInstanceCount": 0,
    "netFrameworkVersion": "v4.0",
    "nodeVersion": "",
    "numberOfWorkers": 1,
    "phpVersion": "5.6",
    "powerShellVersion": "",
    "pythonVersion": "",
    "remoteDebuggingEnabled": false,
    "requestTracingEnabled": false,
    "scmMinTlsVersion": "1.2",
    "use32BitWorkerProcess": true,
    "virtualApplications": [
      {
        "physicalPath": "site\\wwwroot",
        "preloadEnabled": false,
        "virtualPath": "/"
      }
    ],
    "vnetName": "",
    "vnetPrivatePortsCount": 0,
    "vnetRouteAllEnabled": false,
    "webSocketsEnabled": false
  }
}

Definities

Name Description
ApiDefinitionInfo

Informatie over de formele API-definitie voor de app.

ApiManagementConfig

Configuratie van Azure API-beheer (APIM) gekoppeld aan de app.

AutoHealActions

Acties die door de auto-heal-module moeten worden ondernomen wanneer een regel wordt geactiveerd.

AutoHealActionType

Vooraf gedefinieerde actie die moet worden uitgevoerd.

AutoHealCustomAction

Aangepaste actie die moet worden uitgevoerd wanneer een regel voor automatisch herstellen wordt geactiveerd.

AutoHealRules

Regels die kunnen worden gedefinieerd voor automatisch herstellen.

AutoHealTriggers

Triggers voor automatisch genezen.

AzureStorageInfoValue

Azure Files of Blob Storage toegangsinformatiewaarde voor woordenboekopslag.

AzureStorageProtocol

Koppelingsprotocol dat moet worden gebruikt voor het opslagaccount.

AzureStorageState

Status van het opslagaccount.

AzureStorageType

Type opslag.

ConnectionStringType

Type database.

ConnStringInfo

Informatie over de verbindingsreeks van de database.

CorsSettings

Instellingen voor Cross-Origin Resource Sharing (CORS) voor de app.

createdByType

Het type identiteit waarmee de resource is gemaakt.

DefaultAction

Standaardactie voor hoofdtoegangsbeperking als er geen regels overeenkomen.

DefaultErrorResponse

Foutreactie van App Service.

DefaultErrorResponseError

Foutmodel.

DefaultErrorResponseErrorDetailsItem

Gedetailleerde fouten.

Experiments

Routingregels in productie-experimenten.

FtpsState

Status van FTP/FTPS-service

HandlerMapping

De IIS-handlertoewijzingen die worden gebruikt om te definiëren welke handler HTTP-aanvragen met een bepaalde extensie verwerkt. Het wordt bijvoorbeeld gebruikt om php-cgi.exe proces te configureren om alle HTTP-verzoeken met de extensie *.php af te handelen.

IpFilterTag

Hiermee definieert u waarvoor dit IP-filter wordt gebruikt. Dit is bedoeld ter ondersteuning van IP-filtering op proxy's.

IpSecurityRestriction

IP-beveiligingsbeperking op een app.

ManagedPipelineMode

Beheerde pijplijnmodus.

NameValuePair

Naam waarde paar.

PushSettings

Push de instellingen voor de app.

RampUpRule

Routeringsregels voor het opvoeren van testen. Deze regel maakt het mogelijk om statisch verkeer % om te leiden naar een slot of om de routering % geleidelijk te wijzigen op basis van prestaties.

RequestsBasedTrigger

Trigger op basis van het totale aantal aanvragen.

ScmType

SCM-type.

SiteConfigResource

Configuratie van web-app ARM-bron.

SiteLimits

Metrische limieten die zijn ingesteld voor een app.

SiteLoadBalancing

Sitetaakverdeling.

SiteMachineKey

MachineKey van een app.

SlowRequestsBasedTrigger

Trigger op basis van de uitvoeringstijd van de aanvraag.

StatusCodesBasedTrigger

Trigger op basis van statuscode.

StatusCodesRangeBasedTrigger

Trigger op basis van het bereik van statuscodes.

SupportedTlsVersions

MinTlsVersion: configureert de minimale versie van TLS die is vereist voor SSL-aanvragen

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

TlsCipherSuites

De minimaal toegestane TLS-coderingssuite voor een toepassing

VirtualApplication

Virtuele applicatie in een app.

VirtualDirectory

Directory voor virtuele toepassing.

ApiDefinitionInfo

Informatie over de formele API-definitie voor de app.

Name Type Description
url

string

De URL van de API-definitie.

ApiManagementConfig

Configuratie van Azure API-beheer (APIM) gekoppeld aan de app.

Name Type Description
id

string

APIM-Api id.

AutoHealActions

Acties die door de auto-heal-module moeten worden ondernomen wanneer een regel wordt geactiveerd.

Name Type Description
actionType

AutoHealActionType

Vooraf gedefinieerde actie die moet worden uitgevoerd.

customAction

AutoHealCustomAction

Aangepaste actie die moet worden uitgevoerd.

minProcessExecutionTime

string

Minimale tijd die het proces moet uitvoeren voordat de actie wordt ondernomen

AutoHealActionType

Vooraf gedefinieerde actie die moet worden uitgevoerd.

Waarde Description
Recycle
LogEvent
CustomAction

AutoHealCustomAction

Aangepaste actie die moet worden uitgevoerd wanneer een regel voor automatisch herstellen wordt geactiveerd.

Name Type Description
exe

string

Uitvoerbaar bestand dat moet worden uitgevoerd.

parameters

string

Parameters voor het uitvoerbare bestand.

AutoHealRules

Regels die kunnen worden gedefinieerd voor automatisch herstellen.

Name Type Description
actions

AutoHealActions

Acties die moeten worden uitgevoerd wanneer een regel wordt geactiveerd.

triggers

AutoHealTriggers

Voorwaarden die beschrijven wanneer de acties voor automatisch herstellen moeten worden uitgevoerd.

AutoHealTriggers

Triggers voor automatisch genezen.

Name Type Description
privateBytesInKB

integer (int32)

Een regel op basis van privébytes.

requests

RequestsBasedTrigger

Een regel op basis van het totale aantal aanvragen.

slowRequests

SlowRequestsBasedTrigger

Een regel op basis van de uitvoeringstijd van de aanvraag.

slowRequestsWithPath

SlowRequestsBasedTrigger[]

Een regel op basis van meerdere regel voor langzame aanvragen met pad

statusCodes

StatusCodesBasedTrigger[]

Een regel op basis van statuscodes.

statusCodesRange

StatusCodesRangeBasedTrigger[]

Een regel op basis van statuscodesbereiken.

AzureStorageInfoValue

Azure Files of Blob Storage toegangsinformatiewaarde voor woordenboekopslag.

Name Type Description
accessKey

string (password)

Toegangssleutel voor het opslagaccount.

accountName

string

Naam van het opslagaccount.

mountPath

string

Pad naar het koppelen van de opslag in de runtime-omgeving van de site.

protocol

AzureStorageProtocol

Koppelingsprotocol dat moet worden gebruikt voor het opslagaccount.

shareName

string

Naam van de bestandsshare (containernaam voor Blob Storage).

state

AzureStorageState

Status van het opslagaccount.

type

AzureStorageType

Type opslag.

AzureStorageProtocol

Koppelingsprotocol dat moet worden gebruikt voor het opslagaccount.

Waarde Description
Smb
Http
Nfs

AzureStorageState

Status van het opslagaccount.

Waarde Description
Ok
InvalidCredentials
InvalidShare
NotValidated

AzureStorageType

Type opslag.

Waarde Description
AzureFiles
AzureBlob

ConnectionStringType

Type database.

Waarde Description
MySql
SQLServer
SQLAzure
Custom
NotificationHub
ServiceBus
EventHub
ApiHub
DocDb
RedisCache
PostgreSQL

ConnStringInfo

Informatie over de verbindingsreeks van de database.

Name Type Description
connectionString

string

Verbindingsreekswaarde.

name

string

Naam van verbindingsreeks.

type

ConnectionStringType

Type database.

CorsSettings

Instellingen voor Cross-Origin Resource Sharing (CORS) voor de app.

Name Type Description
allowedOrigins

string[]

Hiermee haalt u de lijst met oorsprongen op die moeten worden toegestaan om cross-origin-aanroepen te maken (bijvoorbeeld: http://example.com:12345). Gebruik *om alles toe te staan.

supportCredentials

boolean

Hiermee wordt aangegeven of CORS-aanvragen met referenties zijn toegestaan. Zie https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials voor meer informatie.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

DefaultAction

Standaardactie voor hoofdtoegangsbeperking als er geen regels overeenkomen.

Waarde Description
Allow
Deny

DefaultErrorResponse

Foutreactie van App Service.

Name Type Description
error

DefaultErrorResponseError

Foutmodel.

DefaultErrorResponseError

Foutmodel.

Name Type Description
code

string

Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.

details

DefaultErrorResponseErrorDetailsItem[]

Gedetailleerde fouten.

innererror

string

Meer informatie om fouten op te sporen.

message

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

target

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

DefaultErrorResponseErrorDetailsItem

Gedetailleerde fouten.

Name Type Description
code

string

Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.

message

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

target

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

Experiments

Routingregels in productie-experimenten.

Name Type Description
rampUpRules

RampUpRule[]

Lijst met oplopende regels.

FtpsState

Status van FTP/FTPS-service

Waarde Description
AllAllowed
FtpsOnly
Disabled

HandlerMapping

De IIS-handlertoewijzingen die worden gebruikt om te definiëren welke handler HTTP-aanvragen met een bepaalde extensie verwerkt. Het wordt bijvoorbeeld gebruikt om php-cgi.exe proces te configureren om alle HTTP-verzoeken met de extensie *.php af te handelen.

Name Type Description
arguments

string

Opdrachtregelargumenten die moeten worden doorgegeven aan de scriptprocessor.

extension

string

Aanvragen met deze extensie worden verwerkt met behulp van de opgegeven FastCGI-toepassing.

scriptProcessor

string

Het absolute pad naar de FastCGI-toepassing.

IpFilterTag

Hiermee definieert u waarvoor dit IP-filter wordt gebruikt. Dit is bedoeld ter ondersteuning van IP-filtering op proxy's.

Waarde Description
Default
XffProxy
ServiceTag

IpSecurityRestriction

IP-beveiligingsbeperking op een app.

Name Type Description
action

string

Toegang voor dit IP-bereik toestaan of weigeren.

description

string

Beschrijving van IP-beperkingsregel.

headers

object

Headers van IP-beperkingsregels. X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples). De overeenkomende logica is ..

  • Als de eigenschap null of empty is (standaard), zijn alle hosts (of het ontbreken van) toegestaan.
  • Een waarde wordt vergeleken met behulp van ordinal-ignore-case (exclusief poortnummer).
  • Jokertekens voor subdomeinen zijn toegestaan, maar komen niet overeen met het hoofddomein. *.contoso.com komt bijvoorbeeld overeen met het subdomein foo.contoso.com, maar niet met het hoofddomein contoso.com of foo.bar.contoso.com met meerdere niveaus
  • Unicode-hostnamen zijn toegestaan, maar worden geconverteerd naar Punycode om te matchen.

X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples). De overeenkomende logica is ..

  • Als de eigenschap null of empty is (standaard), zijn alle doorgestuurde ketens (of het ontbreken van) toegestaan.
  • Als een adres (exclusief poortnummer) in de keten (gescheiden door komma's) overeenkomt met de CIDR die door de eigenschap is gedefinieerd.

X-Azure-FDID en X-FD-HealthProbe. De overeenkomende logica komt exact overeen.

ipAddress

string

IP-adres waarvoor de beveiligingsbeperking geldig is. Het kan de vorm hebben van een puur ipv4-adres (vereiste SubnetMask-eigenschap) of CIDR-notatie zoals ipv4/mask (leading bit match). Voor CIDR mag de eigenschap SubnetMask niet worden opgegeven.

name

string

Naam van IP-beperkingsregel.

priority

integer (int32)

Prioriteit van IP-beperkingsregel.

subnetMask

string

Subnetmasker voor het bereik van IP-adressen waarvoor de beperking geldig is.

subnetTrafficTag

integer (int32)

(intern) Subnetverkeerstag

tag

IpFilterTag

Hiermee definieert u waarvoor dit IP-filter wordt gebruikt. Dit is bedoeld ter ondersteuning van IP-filtering op proxy's.

vnetSubnetResourceId

string

Resource-id van virtueel netwerk

vnetTrafficTag

integer (int32)

(intern) VNet-verkeerstag

ManagedPipelineMode

Beheerde pijplijnmodus.

Waarde Description
Integrated
Classic

NameValuePair

Naam waarde paar.

Name Type Description
name

string

Paarnaam.

value

string

Paarwaarde.

PushSettings

Push de instellingen voor de app.

Name Type Description
id

string

Resource-id.

kind

string

Soort resource.

name

string

Naam van de bron.

properties.dynamicTagsJson

string

Hiermee haalt u een JSON-tekenreeks op die een lijst met dynamische tags bevat die worden geëvalueerd op basis van gebruikersclaims in het eindpunt voor pushregistratie.

properties.isPushEnabled

boolean

Hiermee wordt een vlag ophaalt of ingesteld die aangeeft of het Push-eindpunt is ingeschakeld.

properties.tagWhitelistJson

string

Hiermee wordt een JSON-tekenreeks opgehaald of ingesteld die een lijst met tags bevat die zijn opgenomen in de whitelist voor gebruik door het eindpunt voor pushregistratie.

properties.tagsRequiringAuth

string

Hiermee haalt u een JSON-tekenreeks op die een lijst met tags bevat waarvoor gebruikersverificatie moet worden gebruikt in het eindpunt voor pushregistratie. Tags kunnen bestaan uit alfanumerieke tekens en de volgende: '_', '@', '#', '.', ':', '-'. Validatie moet worden uitgevoerd bij PushRequestHandler.

type

string

Type bron

RampUpRule

Routeringsregels voor het opvoeren van testen. Deze regel maakt het mogelijk om statisch verkeer % om te leiden naar een slot of om de routering % geleidelijk te wijzigen op basis van prestaties.

Name Type Description
actionHostName

string

Hostnaam van een site waarnaar het verkeer wordt omgeleid als dit wordt besloten. Bijvoorbeeld myapp-stage.azurewebsites.net.

changeDecisionCallbackUrl

string

Aangepast beslissingsalgoritmen kunnen worden opgegeven in de TiPCallback-site-extensie, welke URL kan worden opgegeven.

changeIntervalInMinutes

integer (int32)

Hiermee geeft u het interval in minuten om ReroutePercentage opnieuw te evalueeren.

changeStep

number (double)

In het scenario van automatisch opstarten is dit de stap om toe te voegen/verwijderen totdat ReroutePercentage het \nMinReroutePercentage of bereikt MaxReroutePercentage. Sitestatistieken worden elke N minuten gecontroleerd die zijn gespecificeerd in ChangeIntervalInMinutes.\nAlgoritme voor aangepaste beslissingen kan worden geleverd in de TiPCallback-site-extensie waarvan de URL kan worden gespecificeerd in ChangeDecisionCallbackUrl.

maxReroutePercentage

number (double)

Hiermee geeft u de bovengrens onder welke ReroutePercentage blijft.

minReroutePercentage

number (double)

Hiermee geeft u de ondergrens waarboven ReroutePercentage blijft.

name

string

Naam van de routeringsregel. De aanbevolen naam is om te verwijzen naar de site die het verkeer in het experiment ontvangt.

reroutePercentage

number (double)

Percentage van het verkeer dat wordt omgeleid naar ActionHostName.

RequestsBasedTrigger

Trigger op basis van het totale aantal aanvragen.

Name Type Description
count

integer (int32)

Aantal aanvragen.

timeInterval

string

Tijdsinterval.

ScmType

SCM-type.

Waarde Description
None
Dropbox
Tfs
LocalGit
GitHub
CodePlexGit
CodePlexHg
BitbucketGit
BitbucketHg
ExternalGit
ExternalHg
OneDrive
VSO
VSTSRM

SiteConfigResource

Configuratie van web-app ARM-bron.

Name Type Default value Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"

kind

string

Soort resource. Als de resource een app is, kunt u verwijzen naar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference voor meer informatie over ondersteunde waarden voor soort.

name

string

De naam van de resource

properties.acrUseManagedIdentityCreds

boolean

Vlag voor het gebruik van Managed Identity Creds voor ACR-pull

properties.acrUserManagedIdentityID

string

Als u een door de gebruiker beheerde identiteit gebruikt, wordt de client-id van de door de gebruiker beheerde identiteit gebruikt

properties.alwaysOn

boolean

true als Altijd aan is ingeschakeld; anders, false.

properties.apiDefinition

ApiDefinitionInfo

Informatie over de formele API-definitie voor de app.

properties.apiManagementConfig

ApiManagementConfig

Azure API Management-instellingen die zijn gekoppeld aan de app.

properties.appCommandLine

string

De opdrachtregel van de app om te starten.

properties.appSettings

NameValuePair[]

Toepassingsinstellingen. Deze eigenschap wordt niet geretourneerd als reactie op normale aanmaak- en leesverzoeken, omdat deze gevoelige informatie kan bevatten.

properties.autoHealEnabled

boolean

true als Automatisch genezen is ingeschakeld; anders, false.

properties.autoHealRules

AutoHealRules

Regels voor automatisch herstellen.

properties.autoSwapSlotName

string

Naam van automatisch wisselen van site.

properties.azureStorageAccounts

<string,  AzureStorageInfoValue>

Lijst met Azure Storage-accounts.

properties.connectionStrings

ConnStringInfo[]

Verbindingsreeksen Deze eigenschap wordt niet geretourneerd als reactie op normale aanmaak- en leesverzoeken, omdat deze gevoelige informatie kan bevatten.

properties.cors

CorsSettings

CORS-instellingen (Cross-Origin Resource Sharing).

properties.defaultDocuments

string[]

Standaarddocumenten.

properties.detailedErrorLoggingEnabled

boolean

true als gedetailleerde foutregistratie is ingeschakeld; anders, false.

properties.documentRoot

string

Hoofdmap van het document.

properties.elasticWebAppScaleLimit

integer (int32)

minimum: 0

Maximum aantal werknemers waarnaar een site kan worden uitgeschaald. Deze instelling is alleen van toepassing op apps in abonnementen waarop ElasticScaleEnabled is true

properties.experiments

Experiments

Dit is een oplossing voor polymorfe typen.

properties.ftpsState

FtpsState

Status van FTP/FTPS-service

properties.functionAppScaleLimit

integer (int32)

minimum: 0

Maximum aantal werknemers waarnaar een site kan worden uitgeschaald. Deze instelling is alleen van toepassing op de abonnementen Verbruik en Elastic Premium

properties.functionsRuntimeScaleMonitoringEnabled

boolean

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of bewaking van de runtimeschaal van functions is ingeschakeld. Als deze optie is ingeschakeld, controleert de ScaleController de gebeurtenisbronnen niet rechtstreeks, maar roept deze in plaats daarvan de runtime aan om de schaalstatus op te halen.

properties.handlerMappings

HandlerMapping[]

Handlertoewijzingen.

properties.healthCheckPath

string

Pad voor statuscontrole

properties.http20Enabled

boolean

True

Http20Enabled: hiermee configureert u een website zodat clients verbinding kunnen maken via http2.0

properties.http20ProxyFlag

integer (int32)

0

Http20ProxyFlag: Configureert een website om toe te staan dat http2.0 wordt doorgegeven aan de app. 0 = uitgeschakeld, 1 = al het http2-verkeer doorgeven, 2 = alleen door gRPC gaan.

properties.httpLoggingEnabled

boolean

true als HTTP-logging is ingeschakeld; anders, false.

properties.ipSecurityRestrictions

IpSecurityRestriction[]

IP-beveiligingsbeperkingen voor de hoofdmap.

properties.ipSecurityRestrictionsDefaultAction

DefaultAction

Standaardactie voor hoofdtoegangsbeperking als er geen regels overeenkomen.

properties.javaContainer

string

Java-container.

properties.javaContainerVersion

string

Java-containerversie.

properties.javaVersion

string

Java-versie.

properties.keyVaultReferenceIdentity

string

Identiteit die moet worden gebruikt voor Key Vault-referentieverificatie.

properties.limits

SiteLimits

Sitelimieten.

properties.linuxFxVersion

string

Linux App Framework en versie

properties.loadBalancing

SiteLoadBalancing

Sitetaakverdeling.

properties.localMySqlEnabled

boolean

False

true om lokale MySQL mogelijk te maken; anders, false.

properties.logsDirectorySizeLimit

integer (int32)

Limiet voor mapgrootte van HTTP-logboeken.

properties.machineKey

SiteMachineKey

Site MachineKey.

properties.managedPipelineMode

ManagedPipelineMode

Beheerde pijplijnmodus.

properties.managedServiceIdentityId

integer (int32)

Id van beheerde service-id

properties.metadata

NameValuePair[]

Metagegevens van toepassingen. Deze eigenschap kan niet worden opgehaald, omdat deze geheimen kan bevatten.

properties.minTlsCipherSuite

TlsCipherSuites

De minimaal toegestane TLS-coderingssuite voor een toepassing

properties.minTlsVersion

SupportedTlsVersions

MinTlsVersion: configureert de minimale versie van TLS die is vereist voor SSL-aanvragen

properties.minimumElasticInstanceCount

integer (int32)

minimum: 0
maximum: 20

Minimaal aantal exemplaren voor een site Deze instelling is alleen van toepassing op de elastische plannen

properties.netFrameworkVersion

string

v4.6

.NET Framework-versie.

properties.nodeVersion

string

Versie van Node.js.

properties.numberOfWorkers

integer (int32)

Aantal werknemers.

properties.phpVersion

string

Versie van PHP.

properties.powerShellVersion

string

Versie van PowerShell.

properties.preWarmedInstanceCount

integer (int32)

minimum: 0
maximum: 10

Aantal voorafwarmde exemplaren. Deze instelling is alleen van toepassing op de verbruiks- en elastische abonnementen

properties.publicNetworkAccess

string

Eigenschap om al het openbare verkeer toe te staan of te blokkeren.

properties.publishingUsername

string

Gebruikersnaam publiceren.

properties.push

PushSettings

Push-eindpuntinstellingen.

properties.pythonVersion

string

Versie van Python.

properties.remoteDebuggingEnabled

boolean

true als foutopsporing op afstand is ingeschakeld; anders, false.

properties.remoteDebuggingVersion

string

Versie voor foutopsporing op afstand.

properties.requestTracingEnabled

boolean

true als tracering van verzoeken is ingeschakeld; anders, false.

properties.requestTracingExpirationTime

string (date-time)

Verlooptijd van tracering aanvragen.

properties.scmIpSecurityRestrictions

IpSecurityRestriction[]

IP-beveiligingsbeperkingen voor scm.

properties.scmIpSecurityRestrictionsDefaultAction

DefaultAction

Standaardactie voor scm-toegangsbeperking als er geen regels overeenkomen.

properties.scmIpSecurityRestrictionsUseMain

boolean

IP-beveiligingsbeperkingen voor scm om hoofd te gebruiken.

properties.scmMinTlsVersion

SupportedTlsVersions

ScmMinTlsVersion: configureert de minimale versie van TLS die is vereist voor SSL-aanvragen voor SCM-site

properties.scmType

ScmType

SCM-type.

properties.tracingOptions

string

Traceringsopties.

properties.use32BitWorkerProcess

boolean

true om 32-bits werkprocessen te gebruiken; anders, false.

properties.virtualApplications

VirtualApplication[]

Virtuele toepassingen.

properties.vnetName

string

Naam van virtueel netwerk.

properties.vnetPrivatePortsCount

integer (int32)

Het aantal privépoorten dat aan deze app is toegewezen. Deze worden dynamisch toegewezen in runtime.

properties.vnetRouteAllEnabled

boolean

Virtual Network Route All ingeschakeld. Dit zorgt ervoor dat al het uitgaande verkeer virtuele netwerkbeveiligingsgroepen en door de gebruiker gedefinieerde routes heeft toegepast.

properties.webSocketsEnabled

boolean

true als WebSocket is ingeschakeld; anders, false.

properties.websiteTimeZone

string

Hiermee stelt u de tijdzone in die een site gebruikt voor het genereren van tijdstempels. Compatibel met Linux en Windows App Service. Het instellen van de WEBSITE_TIME_ZONE app-instelling heeft voorrang op deze configuratie. Voor Linux worden tz-databasewaarden verwacht https://www.iana.org/time-zones (zie https://en.wikipedia.org/wiki/List_of_tz_database_time_zonesvoor een beknopt overzicht). Voor Windows verwacht u een van de tijdzones die worden vermeld onder HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones

properties.windowsFxVersion

string

Xenon App Framework en versie

properties.xManagedServiceIdentityId

integer (int32)

Expliciete id van beheerde service-id

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

type

string

Het type bron. Bijv. "Microsoft.Compute/virtualMachines" of "Microsoft.Storage/storageAccounts"

SiteLimits

Metrische limieten die zijn ingesteld voor een app.

Name Type Description
maxDiskSizeInMb

integer (int64)

Maximaal toegestane schijfgroottegebruik in MB.

maxMemoryInMb

integer (int64)

Maximaal toegestaan geheugengebruik in MB.

maxPercentageCpu

number (double)

Maximaal toegestaan CPU-gebruikspercentage.

SiteLoadBalancing

Sitetaakverdeling.

Waarde Description
WeightedRoundRobin
LeastRequests
LeastResponseTime
WeightedTotalTraffic
RequestHash
PerSiteRoundRobin
LeastRequestsWithTieBreaker

SiteMachineKey

MachineKey van een app.

Name Type Description
decryption

string

Algoritme gebruikt voor decodering.

decryptionKey

string

Decoderingssleutel.

validation

string

MachineKey-validatie.

validationKey

string

Validatie sleutel.

SlowRequestsBasedTrigger

Trigger op basis van de uitvoeringstijd van de aanvraag.

Name Type Description
count

integer (int32)

Aantal aanvragen.

path

string

Aanvraagpad.

timeInterval

string

Tijdsinterval.

timeTaken

string

Tijd die nodig is.

StatusCodesBasedTrigger

Trigger op basis van statuscode.

Name Type Description
count

integer (int32)

Aantal aanvragen.

path

string

Aanvraagpad

status

integer (int32)

HTTP-statuscode.

subStatus

integer (int32)

Substatus aanvragen.

timeInterval

string

Tijdsinterval.

win32Status

integer (int32)

Win32-foutcode.

StatusCodesRangeBasedTrigger

Trigger op basis van het bereik van statuscodes.

Name Type Description
count

integer (int32)

Aantal aanvragen.

path

string

statusCodes

string

HTTP-statuscode.

timeInterval

string

Tijdsinterval.

SupportedTlsVersions

MinTlsVersion: configureert de minimale versie van TLS die is vereist voor SSL-aanvragen

Waarde Description
1.0
1.1
1.2
1.3

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

TlsCipherSuites

De minimaal toegestane TLS-coderingssuite voor een toepassing

Waarde Description
TLS_AES_256_GCM_SHA384
TLS_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA

VirtualApplication

Virtuele applicatie in een app.

Name Type Description
physicalPath

string

Fysiek pad.

preloadEnabled

boolean

true als vooraf laden is ingeschakeld; anders, false.

virtualDirectories

VirtualDirectory[]

Virtuele mappen voor virtuele toepassing.

virtualPath

string

Virtueel pad.

VirtualDirectory

Directory voor virtuele toepassing.

Name Type Description
physicalPath

string

Fysiek pad.

virtualPath

string

Pad naar virtuele toepassing.