Siti/slot Microsoft.Web

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa siti/slot può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Web/sites/slots, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Web/sites/slots@2022-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  parent: resourceSymbolicName
  extendedLocation: {
    name: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    clientAffinityEnabled: bool
    clientCertEnabled: bool
    clientCertExclusionPaths: 'string'
    clientCertMode: 'string'
    cloningInfo: {
      appSettingsOverrides: {}
      cloneCustomHostNames: bool
      cloneSourceControl: bool
      configureLoadBalancing: bool
      correlationId: 'string'
      hostingEnvironment: 'string'
      overwrite: bool
      sourceWebAppId: 'string'
      sourceWebAppLocation: 'string'
      trafficManagerProfileId: 'string'
      trafficManagerProfileName: 'string'
    }
    containerSize: int
    customDomainVerificationId: 'string'
    dailyMemoryTimeQuota: int
    enabled: bool
    hostingEnvironmentProfile: {
      id: 'string'
    }
    hostNamesDisabled: bool
    hostNameSslStates: [
      {
        hostType: 'string'
        name: 'string'
        sslState: 'string'
        thumbprint: 'string'
        toUpdate: bool
        virtualIP: 'string'
      }
    ]
    httpsOnly: bool
    hyperV: bool
    isXenon: bool
    keyVaultReferenceIdentity: 'string'
    managedEnvironmentId: 'string'
    publicNetworkAccess: 'string'
    redundancyMode: 'string'
    reserved: bool
    scmSiteAlsoStopped: bool
    serverFarmId: 'string'
    siteConfig: {
      acrUseManagedIdentityCreds: bool
      acrUserManagedIdentityID: 'string'
      alwaysOn: bool
      apiDefinition: {
        url: 'string'
      }
      apiManagementConfig: {
        id: 'string'
      }
      appCommandLine: 'string'
      appSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      autoHealEnabled: bool
      autoHealRules: {
        actions: {
          actionType: 'string'
          customAction: {
            exe: 'string'
            parameters: 'string'
          }
          minProcessExecutionTime: 'string'
        }
        triggers: {
          privateBytesInKB: int
          requests: {
            count: int
            timeInterval: 'string'
          }
          slowRequests: {
            count: int
            path: 'string'
            timeInterval: 'string'
            timeTaken: 'string'
          }
          slowRequestsWithPath: [
            {
              count: int
              path: 'string'
              timeInterval: 'string'
              timeTaken: 'string'
            }
          ]
          statusCodes: [
            {
              count: int
              path: 'string'
              status: int
              subStatus: int
              timeInterval: 'string'
              win32Status: int
            }
          ]
          statusCodesRange: [
            {
              count: int
              path: 'string'
              statusCodes: 'string'
              timeInterval: 'string'
            }
          ]
        }
      }
      autoSwapSlotName: 'string'
      azureStorageAccounts: {}
      connectionStrings: [
        {
          connectionString: 'string'
          name: 'string'
          type: 'string'
        }
      ]
      cors: {
        allowedOrigins: [
          'string'
        ]
        supportCredentials: bool
      }
      defaultDocuments: [
        'string'
      ]
      detailedErrorLoggingEnabled: bool
      documentRoot: 'string'
      elasticWebAppScaleLimit: int
      experiments: {
        rampUpRules: [
          {
            actionHostName: 'string'
            changeDecisionCallbackUrl: 'string'
            changeIntervalInMinutes: int
            changeStep: int
            maxReroutePercentage: int
            minReroutePercentage: int
            name: 'string'
            reroutePercentage: int
          }
        ]
      }
      ftpsState: 'string'
      functionAppScaleLimit: int
      functionsRuntimeScaleMonitoringEnabled: bool
      handlerMappings: [
        {
          arguments: 'string'
          extension: 'string'
          scriptProcessor: 'string'
        }
      ]
      healthCheckPath: 'string'
      http20Enabled: bool
      httpLoggingEnabled: bool
      ipSecurityRestrictions: [
        {
          action: 'string'
          description: 'string'
          headers: {}
          ipAddress: 'string'
          name: 'string'
          priority: int
          subnetMask: 'string'
          subnetTrafficTag: int
          tag: 'string'
          vnetSubnetResourceId: 'string'
          vnetTrafficTag: int
        }
      ]
      ipSecurityRestrictionsDefaultAction: 'string'
      javaContainer: 'string'
      javaContainerVersion: 'string'
      javaVersion: 'string'
      keyVaultReferenceIdentity: 'string'
      limits: {
        maxDiskSizeInMb: int
        maxMemoryInMb: int
        maxPercentageCpu: int
      }
      linuxFxVersion: 'string'
      loadBalancing: 'string'
      localMySqlEnabled: bool
      logsDirectorySizeLimit: int
      managedPipelineMode: 'string'
      managedServiceIdentityId: int
      metadata: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      minimumElasticInstanceCount: int
      minTlsVersion: 'string'
      netFrameworkVersion: 'string'
      nodeVersion: 'string'
      numberOfWorkers: int
      phpVersion: 'string'
      powerShellVersion: 'string'
      preWarmedInstanceCount: int
      publicNetworkAccess: 'string'
      publishingUsername: 'string'
      push: {
        kind: 'string'
        properties: {
          dynamicTagsJson: 'string'
          isPushEnabled: bool
          tagsRequiringAuth: 'string'
          tagWhitelistJson: 'string'
        }
      }
      pythonVersion: 'string'
      remoteDebuggingEnabled: bool
      remoteDebuggingVersion: 'string'
      requestTracingEnabled: bool
      requestTracingExpirationTime: 'string'
      scmIpSecurityRestrictions: [
        {
          action: 'string'
          description: 'string'
          headers: {}
          ipAddress: 'string'
          name: 'string'
          priority: int
          subnetMask: 'string'
          subnetTrafficTag: int
          tag: 'string'
          vnetSubnetResourceId: 'string'
          vnetTrafficTag: int
        }
      ]
      scmIpSecurityRestrictionsDefaultAction: 'string'
      scmIpSecurityRestrictionsUseMain: bool
      scmMinTlsVersion: 'string'
      scmType: 'string'
      tracingOptions: 'string'
      use32BitWorkerProcess: bool
      virtualApplications: [
        {
          physicalPath: 'string'
          preloadEnabled: bool
          virtualDirectories: [
            {
              physicalPath: 'string'
              virtualPath: 'string'
            }
          ]
          virtualPath: 'string'
        }
      ]
      vnetName: 'string'
      vnetPrivatePortsCount: int
      vnetRouteAllEnabled: bool
      websiteTimeZone: 'string'
      webSocketsEnabled: bool
      windowsFxVersion: 'string'
      xManagedServiceIdentityId: int
    }
    storageAccountRequired: bool
    virtualNetworkSubnetId: 'string'
    vnetContentShareEnabled: bool
    vnetImagePullEnabled: bool
    vnetRouteAllEnabled: bool
  }
}

Valori delle proprietà

sites/slots

Nome Descrizione valore
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.		 stringa (obbligatorio)

Limite di caratteri: 2-59

Caratteri validi:
Caratteri alfanumerici, trattini e Unicode di cui è possibile eseguire il mapping a Punycode
posizione Posizione risorsa. stringa (obbligatorio)
tags Tag delle risorse. Dizionario di nomi e valori di tag. Vedere Tag nei modelli
kind Tipo di risorsa. string
padre In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere Risorsa figlio esterna alla risorsa padre.		 Nome simbolico per la risorsa di tipo: siti
extendedLocation Posizione estesa. ExtendedLocation
identity Identità del servizio gestito. ManagedServiceIdentity
properties Proprietà specifiche delle risorse del sito Proprietà sito

ExtendedLocation

Nome Descrizione valore
name Nome della posizione estesa. string

ManagedServiceIdentity

Nome Descrizione Valore
tipo Tipo di identità del servizio gestito. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} object

Proprietà sito

Nome Descrizione Valore
clientAffinityEnabled true per abilitare l'affinità client; false per interrompere l'invio dei cookie di affinità di sessione, che instradano le richieste client nella stessa sessione alla stessa istanza. Il valore predefinito è true. bool
clientCertEnabled true per abilitare l'autenticazione del certificato client (autenticazione reciproca TLS); in caso contrario, false. Il valore predefinito è false. bool
clientCertExclusionPaths percorsi di esclusione delimitati da virgole per l'autenticazione del certificato client string
clientCertMode Viene creato con l'impostazione ClientCertEnabled.
- ClientCertEnabled: false indica che ClientCert viene ignorato.
- ClientCertEnabled: true e ClientCertMode: obbligatorio significa che ClientCert è obbligatorio.
- ClientCertEnabled: true e ClientCertMode: facoltativo significa che ClientCert è facoltativo o accettato.		 'Facoltativo'
'OptionalInteractiveUser'
'Obbligatorio'
cloningInfo Se specificato durante la creazione dell'app, l'app viene clonata da un'app di origine. CloningInfo
containerSize Dimensioni del contenitore di funzioni. INT
customDomainVerificationId Identificatore univoco che verifica i domini personalizzati assegnati all'app. Il cliente aggiungerà questo ID a un record txt per la verifica. string
dailyMemoryTimeQuota Quota massima consentita per il tempo di memoria giornaliero (applicabile solo alle app dinamiche). INT
Enabled true se l'app è abilitata; in caso contrario, false. L'impostazione di questo valore su false disabilita l'app (porta l'app offline). bool
hostingEnvironmentProfile ambiente del servizio app da usare per l'app. HostingEnvironmentProfile
hostNamesDisabled true per disabilitare i nomi host pubblici dell'app; in caso contrario, false.
Se true, l'app è accessibile solo tramite il processo di gestione API.		 bool
hostNameSslStates Gli stati SSL del nome host vengono usati per gestire le associazioni SSL per i nomi host dell'app. HostNameSslState[]
httpsOnly HttpsOnly: configura un sito Web per accettare solo le richieste HTTPS. Problemi di reindirizzamento per
richieste HTTP		 bool
HyperV Sandbox Hyper-V. bool
isXenon Obsoleto: sandbox Hyper-V. bool
keyVaultReferenceIdentity Identità da usare per l'autenticazione di riferimento Key Vault. string
managedEnvironmentId Azure Resource Manager ID dell'ambiente gestito selezionato del cliente in cui ospitare l'app. Deve essere nel formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} string
publicNetworkAccess Proprietà per consentire o bloccare tutto il traffico pubblico. Valori consentiti: 'Enabled', 'Disabled' o una stringa vuota. string
redundancyMode Modalità di ridondanza del sito 'ActiveActive'
'Failover'
'GeoRedundant'
'Manual'
'Nessuno'
reserved true se riservato; in caso contrario, false. bool
scmSiteAlsoStopped true per arrestare il sito SCM (KUDU) quando l'app viene arrestata; in caso contrario, false. Il valore predefinito è false. bool
serverFarmId ID risorsa del piano di servizio app associato, formattato come: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". string
siteConfig Configurazione dell'app. SiteConfig
storageAccountRequired Verifica se è necessario l'account di archiviazione fornito dal cliente bool
virtualNetworkSubnetId Azure Resource Manager ID della rete virtuale e della subnet da aggiungere all'integrazione rete virtuale a livello di area.
Deve essere nel formato /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}		 string
vnetContentShareEnabled Per abilitare l'accesso al contenuto tramite rete virtuale bool
vnetImagePullEnabled Per abilitare il pull dell'immagine su Rete virtuale bool
vnetRouteAllEnabled Rete virtuale Instrada tutto abilitato. Ciò fa sì che tutto il traffico in uscita abbia Rete virtuale gruppi di sicurezza e route definite dall'utente applicati. bool

CloningInfo

Nome Descrizione Valore
appSettingsOverrides Override dell'impostazione dell'applicazione per l'app clonata. Se specificato, queste impostazioni sostituiscono le impostazioni clonate
dall'app di origine. In caso contrario, le impostazioni dell'applicazione dall'app di origine vengono mantenute.		 object
cloneCustomHostNames true per clonare nomi host personalizzati dall'app di origine; in caso contrario, false. bool
cloneSourceControl true per clonare il controllo del codice sorgente dall'app di origine; in caso contrario, false. bool
configureLoadBalancing true per configurare il bilanciamento del carico per l'app di origine e destinazione. bool
correlationId ID di correlazione dell'operazione di clonazione. Questo ID associa più operazioni di clonazione
insieme per usare lo stesso snapshot.		 string
hostingEnvironment ambiente del servizio app. string
overwrite true per sovrascrivere l'app di destinazione; in caso contrario, false. bool
sourceWebAppId ID risorsa ARM dell'app di origine. ID risorsa app è del modulo
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} per slot di produzione e
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slot/{slotName} per altri slot.		 stringa (obbligatoria)
sourceWebAppLocation Posizione dell'app di origine ex: Stati Uniti occidentali o Europa settentrionale string
trafficManagerProfileId ID risorsa ARM del profilo di Gestione traffico da usare, se presente. ID risorsa di Gestione traffico è del modulo
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.		 string
trafficManagerProfileName Nome del profilo di Gestione traffico da creare. Questa operazione è necessaria solo se il profilo di Gestione traffico non esiste già. string

HostingEnvironmentProfile

Nome Descrizione Valore
id ID risorsa del ambiente del servizio app. string

HostNameSslState

Nome Descrizione Valore
hostType Indica se il nome host è un nome host standard o repository. 'Repository'
'Standard'
name Nome host. string
sslState Tipo SSL. 'Disabilitato'
'IpBasedEnabled'
'SniEnabled'
thumbprint Identificazione personale del certificato SSL. string
toUpdate Impostare su per true aggiornare il nome host esistente. bool
virtualIP Indirizzo IP virtuale assegnato al nome host se è abilitato SSL basato su IP. string

SiteConfig

Nome Descrizione Valore
acrUseManagedIdentityCreds Contrassegno per l'uso dei cred di identità gestita per il pull del Registro Azure Container bool
acrUserManagedIdentityID Se si usa l'identità gestita dall'utente, clientId dell'identità gestita dall'utente string
Alwayson truese Always On è abilitato; in caso contrario, false. bool
apiDefinition Informazioni sulla definizione dell'API formale per l'app. ApiDefinitionInfo
apiManagementConfig Impostazioni di gestione API di Azure collegate all'app. ApiManagementConfig
appCommandLine Riga di comando dell'app da avviare. string
appSettings Impostazioni delle applicazioni. NameValuePair[]
autoHealEnabled true se Auto Heal è abilitato; in caso contrario, false. bool
autoHealRules Regole di ripristino automatico. AutoHealRules
autoSwapSlotName Nome dello slot di scambio automatico. string
azureStorageAccounts Elenco degli account di archiviazione di Azure. object
connectionStrings Stringhe di connessione. ConnStringInfo[]
CORS Impostazioni CORS (Cross-Origin Resource Sharing). CorsSettings
defaultDocuments Documenti predefiniti. string[]
detailedErrorLoggingEnabled true se la registrazione dettagliata degli errori è abilitata; in caso contrario, false. bool
documentRoot Radice del documento. string
elasticWebAppScaleLimit Numero massimo di lavoratori a cui un sito può aumentare il numero massimo.
Questa impostazione si applica solo alle app nei piani in cui ElasticScaleEnabled è true		 INT
Esperimenti Questo è il problema per i tipi polimorfici. Sperimentazioni
ftpsState Stato del servizio FTP/FTPS 'AllAllowed'
'Disabilitato'
'FtpsOnly'
functionAppScaleLimit Numero massimo di lavoratori a cui un sito può aumentare il numero massimo.
Questa impostazione si applica solo ai piani Consumo e Premium elastici		 INT
functionsRuntimeScaleMonitoringEnabled Ottiene o imposta un valore che indica se il monitoraggio della scalabilità di runtime delle funzioni è abilitato. Se abilitata,
ScaleController non monitorerà direttamente le origini eventi, ma chiamerà invece all'oggetto
runtime per ottenere lo stato di scalabilità.		 bool
gestoreMappings Mapping dei gestori. HandlerMapping[]
healthCheckPath Percorso di controllo dell'integrità string
http20Enabled Http20Enabled: configura un sito Web per consentire ai client di connettersi tramite http2.0 bool
httpLoggingEnabled true se la registrazione HTTP è abilitata; in caso contrario, false. bool
ipSecurityRestrictions Restrizioni di sicurezza IP per main. IpSecurityRestriction[]
ipSecurityRestrictionsDefaultAction Azione predefinita per la restrizione di accesso principale se non vengono corrispondenti regole. 'Allow'
'Deny'
javaContainer Contenitore Java. string
javaContainerVersion Versione del contenitore Java. string
javaVersion Versione Java. string
keyVaultReferenceIdentity Identità da usare per l'autenticazione di riferimento Key Vault. string
limiti Limiti del sito. SiteLimits
linuxFxVersion Framework e versione di Linux App Framework string
loadBalancing Bilanciamento del carico del sito. 'LeastRequests'
'LeastResponseTime'
'PerSiteRoundRobin'
'RequestHash'
'WeightedRoundRobin'
'WeightedTotalTraffic'
localMySqlEnabled true per abilitare MySQL locale; in caso contrario, false. bool
logsDirectorySizeLimit Limite di dimensioni della directory dei log HTTP. INT
managedPipelineMode Modalità pipeline gestita. 'Classico'
'Integrato'
managedServiceIdentityId ID identità del servizio gestito INT
metadata Metadati dell'applicazione. Questa proprietà non può essere recuperata, poiché può contenere segreti. NameValuePair[]
minimumElasticInstanceCount Numero di numero minimo di istanze per un sito
Questa impostazione si applica solo ai piani elastici		 INT
minTlsVersion MinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL '1.0'
'1.1'
'1.2'
netFrameworkVersion Versione di .NET Framework. string
nodeVersion Versione di Node.js. string
numberOfWorkers Numero di ruoli di lavoro. INT
phpVersion Versione di PHP. string
powerShellVersion Versione di PowerShell. string
preWarmedInstanceCount Numero di istanze preWarmed.
Questa impostazione si applica solo ai piani elastici e di consumo		 INT
publicNetworkAccess Proprietà per consentire o bloccare tutto il traffico pubblico. string
publishingUsername Pubblicazione del nome utente. string
push Impostazioni dell'endpoint push. PushSettings
PythonVersion Versione di Python. string
remoteDebuggingEnabled true se il debug remoto è abilitato; in caso contrario, false. bool
remoteDebuggingVersion Versione di debug remoto. string
requestTracingEnabled true se la traccia delle richieste è abilitata; in caso contrario, false. bool
requestTracingExpirationTime Data di scadenza della traccia delle richieste. string
scmIpSecurityRestrictions Restrizioni di sicurezza IP per scm. IpSecurityRestriction[]
scmIpSecurityRestrictionsDefaultAction Azione predefinita per la restrizione di accesso scm se non vengono corrispondenti regole. 'Allow'
'Deny'
scmIpSecurityRestrictionsUseMain Restrizioni di sicurezza IP per scm da usare main. bool
scmMinTlsVersion ScmMinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL per il sito SCM '1.0'
'1.1'
'1.2'
scmType Tipo SCM. 'BitbucketGit'
'BitbucketHg'
'CodePlexGit'
'CodePlexHg'
'Dropbox'
'ExternalGit'
'ExternalHg'
'GitHub'
'LocalGit'
'Nessuno'
'OneDrive'
'Tfs'
'VSO'
'VSTSRM'
tracingOptions Opzioni di traccia. string
use32BitWorkerProcess true per usare il processo di lavoro a 32 bit; in caso contrario, false. bool
virtualApplications Applicazioni virtuali. VirtualApplication[]
vnetName Rete virtuale nome. string
vnetPrivatePortsCount Numero di porte private assegnate a questa app. Questi verranno assegnati dinamicamente in fase di esecuzione. INT
vnetRouteAllEnabled Rete virtuale Instrada tutto abilitato. Ciò fa sì che tutto il traffico in uscita abbia Rete virtuale gruppi di sicurezza e route definite dall'utente applicati. bool
websiteTimeZone Imposta il fuso orario utilizzato da un sito per la generazione di timestamp. Compatibile con Linux e Windows servizio app. L'impostazione dell'impostazione dell'app WEBSITE_TIME_ZONE ha la precedenza su questa configurazione. Per Linux, prevede valori https://www.iana.org/time-zones di database tz (per un riferimento rapido vedere https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Per Windows, prevede uno dei fusi orari elencati in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones string
webSocketsEnabled true se WebSocket è abilitato; in caso contrario, false. bool
windowsFxVersion Xenon App Framework e versione string
xManagedServiceIdentityId ID identità del servizio gestito esplicito INT

ApiDefinitionInfo

Nome Descrizione Valore
url URL della definizione dell'API. string

ApiManagementConfig

Nome Descrizione Valore
id APIM-Api Identificatore. string

NameValuePair

Nome Descrizione valore
name Nome coppia. string
Valore Valore di coppia. string

AutoHealRules

Nome Descrizione Valore
Azioni Azioni da eseguire quando viene attivata una regola. AutoHealActions
trigger Condizioni che descrivono quando eseguire le azioni di correzione automatica. AutoHealTriggers

AutoHealActions

Nome Descrizione Valore
actionType Azione predefinita da eseguire. 'CustomAction'
'LogEvent'
'Recycle'
Customaction Azione personalizzata da eseguire. AutoHealCustomAction
minProcessExecutionTime Tempo minimo di esecuzione del processo
prima di eseguire l'azione
 string

AutoHealCustomAction

Nome Descrizione Valore
exe Eseguibile da eseguire. string
parametri Parametri per l'eseguibile. string

AutoHealTriggers

Nome Descrizione Valore
privateBytesInKB Regola basata su byte privati. INT
requests Regola basata sulle richieste totali. RequestsBasedTrigger
slowRequests Regola basata sul tempo di esecuzione della richiesta. SlowRequestsBasedTrigger
slowRequestsWithPath Regola basata su più regole richieste lente con percorso SlowRequestsBasedTrigger[]
statusCodes Regola basata sui codici di stato. StatusCodesBasedTrigger[]
statusCodesRange Regola basata sugli intervalli di codici di stato. StatusCodesRangeBasedTrigger[]

RichiesteBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
timeInterval Intervallo di tempo. string

SlowRequestsBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
path Percorso richiesta. string
timeInterval Intervallo di tempo. string
timeTaken Tempo impiegato. string

StatusCodesBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
path Percorso della richiesta string
status Codice stato HTTP. INT
subStatus Stato della sotto richiesta. INT
timeInterval Intervallo di tempo. string
win32Status Codice di errore Win32. INT

StatusCodesRangeBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
path string
statusCodes Codice stato HTTP. string
timeInterval Intervallo di tempo. string

ConnStringInfo

Nome Descrizione Valore
connectionString Valore stringa di connessione. string
name Nome della stringa di connessione. string
type Tipo di database. 'ApiHub'
'Personalizzato'
'DocDb'
'EventHub'
'MySql'
'NotificationHub'
'PostgreSQL'
'RedisCache'
'SQLAzure'
'SQLServer'
'ServiceBus'

CorsSettings

Nome Descrizione Valore
allowedOrigins Ottiene o imposta l'elenco di origini che devono essere consentite per rendere l'origine incrociata
chiamate (ad esempio: http://example.com:12345). Usare "*" per consentirli tutti.		 string[]
supportCredentials Ottiene o imposta se le richieste CORS con credenziali sono consentite. Vedere
https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials
per altri dettagli.
 bool

Sperimentazioni

Nome Descrizione Valore
rampUpRules Elenco delle regole di ramp-up. RampUpRule[]

RampUpRule

Nome Descrizione Valore
actionHostName Nome host di uno slot a cui verrà reindirizzato il traffico se si decide. Ad esempio, myapp-stage.azurewebsites.net. string
changeDecisionCallbackUrl L'algoritmo decisionale personalizzato può essere fornito nell'estensione del sito TiPCallback che è possibile specificare l'URL. Vedere Estensione del sito TiPCallback per lo scaffolding e i contratti.
https://www.siteextensions.net/packages/TiPCallback/		 string
changeIntervalInMinutes Specifica l'intervallo in minuti per rivalutare ReroutePercentage. INT
changeStep Nello scenario di aumento automatico questo è il passaggio da cui aggiungere/rimuovere ReroutePercentage fino a raggiungere \nMinReroutePercentage o
MaxReroutePercentage. Le metriche del sito vengono controllate ogni N minuti specificati in ChangeIntervalInMinutes.\nAlgoritmo decisionale personalizzato
può essere fornito nell'estensione del sito TiPCallback che l'URL può essere specificato in ChangeDecisionCallbackUrl.		 INT
maxReroutePercentage Specifica il limite superiore al di sotto del quale rimarrà ReroutePercentage. INT
minReroutePercentage Specifica un limite inferiore al di sopra del quale rimarrà ReroutePercentage. INT
name Nome della regola di routing. Il nome consigliato è puntare allo slot che riceverà il traffico nell'esperimento. string
reroutePercentage Percentuale del traffico che verrà reindirizzato a ActionHostName. INT

HandlerMapping

Nome Descrizione Valore
argomenti Argomenti della riga di comando da passare al processore di script. string
estensione Le richieste con questa estensione verranno gestite usando l'applicazione FastCGI specificata. string
scriptProcessor Percorso assoluto dell'applicazione FastCGI. string

IpSecurityRestriction

Nome Descrizione Valore
azione Consenti o Nega l'accesso per questo intervallo IP. string
description Descrizione della regola di restrizione IP. string
headers Intestazioni delle regole di restrizione IP.
X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples).
La logica corrispondente è ..
- Se la proprietà è null o vuota (impostazione predefinita), sono consentiti tutti gli host(o la mancanza di).
- Un valore viene confrontato usando ordinal-ignore-case (escluso il numero di porta).
- I caratteri jolly del sottodominio sono consentiti, ma non corrispondono al dominio radice. Ad esempio, *.contoso.com corrisponde al sottodominio foo.contoso.com
ma non il dominio radice contoso.com o foo.bar.contoso.com a più livelli
- I nomi host Unicode sono consentiti ma vengono convertiti in Punycode per la corrispondenza.

X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples).
La logica corrispondente è ..
- Se la proprietà è null o vuota (impostazione predefinita), sono consentite eventuali catene inoltrate (o mancanza di).
- Se un indirizzo (escluso il numero di porta) nella catena (delimitato da virgole) corrisponde al CIDR definito dalla proprietà .

X-Azure-FDID e X-FD-HealthProbe.
La logica di corrispondenza è esatta.		 object
IpAddress Indirizzo IP per cui è valida la restrizione di sicurezza.
Può essere in forma di indirizzo ipv4 puro (proprietà SubnetMask obbligatoria) o
Notazione CIDR, ad esempio ipv4/mask (corrispondenza di bit iniziale). Per CIDR,
La proprietà SubnetMask non deve essere specificata.		 string
name Nome della regola di restrizione IP. string
priority Priorità della regola di restrizione IP. INT
Subnetmask Subnet mask per l'intervallo di indirizzi IP per cui la restrizione è valida. string
subnetTrafficTag (interno) Tag del traffico subnet INT
tag Definisce l'utilizzo di questo filtro IP. Si tratta di supportare il filtro IP sui proxy. Impostazione predefinita
'ServiceTag'
'XffProxy'
vnetSubnetResourceId ID risorsa di rete virtuale string
vnetTrafficTag (interno) Tag del traffico della rete virtuale INT

SiteLimits

Nome Descrizione Valore
maxDiskSizeInMb Utilizzo massimo delle dimensioni del disco consentite in MB. INT
maxMemoryInMb Utilizzo massimo della memoria consentito in MB. INT
maxPercentageCpu Percentuale massima di utilizzo della CPU consentita. INT

PushSettings

Nome Descrizione Valore
kind Tipo di risorsa. string
properties Proprietà specifiche della risorsa PushSettings PushSettingsProperties

PushSettingsProperties

Nome Descrizione Valore
dynamicTagsJson Ottiene o imposta una stringa JSON contenente un elenco di tag dinamici che verranno valutati dalle attestazioni utente nell'endpoint di registrazione push. string
isPushEnabled Ottiene o imposta un flag che indica se l'endpoint push è abilitato. bool (obbligatorio)
tagsRequiringAuth Ottiene o imposta una stringa JSON contenente un elenco di tag che richiedono l'autenticazione utente da usare nell'endpoint di registrazione push.
I tag possono essere costituiti da caratteri alfanumerici e i seguenti:
'_', '@', '#', '.', ':', '-'.
La convalida deve essere eseguita in PushRequestHandler.		 string
tagWhitelistJson Ottiene o imposta una stringa JSON contenente un elenco di tag consentiti per l'uso dall'endpoint di registrazione push. string

VirtualApplication

Nome Descrizione Valore
Physicalpath Percorso fisico. string
preloadEnabled true se il preload è abilitato; in caso contrario, false. bool
virtualDirectories Directory virtuali per l'applicazione virtuale. VirtualDirectory[]
virtualPath Percorso virtuale. string

VirtualDirectory

Nome Descrizione Valore
Physicalpath Percorso fisico. string
virtualPath Percorso dell'applicazione virtuale. string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Eseguire il provisioning della funzione piano di consumo con uno slot di distribuzione

Distribuisci in Azure		 Questo modello esegue il provisioning di un'app per le funzioni in un piano di consumo, ovvero un piano di hosting dinamico. L'app viene eseguita su richiesta e viene fatturata per ogni esecuzione, senza alcun impegno di risorsa permanente. Esistono altri modelli disponibili per il provisioning in un piano di hosting dedicato.
App per le funzioni di Azure con uno slot di distribuzione

Distribuisci in Azure		 Questo modello esegue il provisioning di un'app per le funzioni in un piano Premium con slot di produzione e uno slot di distribuzione aggiuntivo.
App Web con slot di distribuzione personalizzati

Distribuisci in Azure		 Questo modello offre un modo semplice per distribuire un'app Web con slot di distribuzione personalizzati in Azure App Web.
App Web multi-area a disponibilità elevata

Distribuisci in Azure		 Questo modello consente di creare una soluzione end-to-end sicura, a disponibilità elevata e a più aree con due app Web in aree diverse dietro Frontdoor di Azure
Secure N-tier Web App

Distribuisci in Azure		 Questo modello consente di creare una soluzione end-to-end sicura con due app Web con slot di gestione temporanea, front-end e back-end, front-end utilizzerà in modo sicuro il back tramite l'inserimento della rete virtuale e l'endpoint privato

Definizione della risorsa modello di Resource Manager

Il tipo di risorsa siti/slot può essere distribuito con operazioni destinate:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Web/sites/slot, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Web/sites/slots",
  "apiVersion": "2022-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "extendedLocation": {
    "name": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "clientAffinityEnabled": "bool",
    "clientCertEnabled": "bool",
    "clientCertExclusionPaths": "string",
    "clientCertMode": "string",
    "cloningInfo": {
      "appSettingsOverrides": {},
      "cloneCustomHostNames": "bool",
      "cloneSourceControl": "bool",
      "configureLoadBalancing": "bool",
      "correlationId": "string",
      "hostingEnvironment": "string",
      "overwrite": "bool",
      "sourceWebAppId": "string",
      "sourceWebAppLocation": "string",
      "trafficManagerProfileId": "string",
      "trafficManagerProfileName": "string"
    },
    "containerSize": "int",
    "customDomainVerificationId": "string",
    "dailyMemoryTimeQuota": "int",
    "enabled": "bool",
    "hostingEnvironmentProfile": {
      "id": "string"
    },
    "hostNamesDisabled": "bool",
    "hostNameSslStates": [
      {
        "hostType": "string",
        "name": "string",
        "sslState": "string",
        "thumbprint": "string",
        "toUpdate": "bool",
        "virtualIP": "string"
      }
    ],
    "httpsOnly": "bool",
    "hyperV": "bool",
    "isXenon": "bool",
    "keyVaultReferenceIdentity": "string",
    "managedEnvironmentId": "string",
    "publicNetworkAccess": "string",
    "redundancyMode": "string",
    "reserved": "bool",
    "scmSiteAlsoStopped": "bool",
    "serverFarmId": "string",
    "siteConfig": {
      "acrUseManagedIdentityCreds": "bool",
      "acrUserManagedIdentityID": "string",
      "alwaysOn": "bool",
      "apiDefinition": {
        "url": "string"
      },
      "apiManagementConfig": {
        "id": "string"
      },
      "appCommandLine": "string",
      "appSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "autoHealEnabled": "bool",
      "autoHealRules": {
        "actions": {
          "actionType": "string",
          "customAction": {
            "exe": "string",
            "parameters": "string"
          },
          "minProcessExecutionTime": "string"
        },
        "triggers": {
          "privateBytesInKB": "int",
          "requests": {
            "count": "int",
            "timeInterval": "string"
          },
          "slowRequests": {
            "count": "int",
            "path": "string",
            "timeInterval": "string",
            "timeTaken": "string"
          },
          "slowRequestsWithPath": [
            {
              "count": "int",
              "path": "string",
              "timeInterval": "string",
              "timeTaken": "string"
            }
          ],
          "statusCodes": [
            {
              "count": "int",
              "path": "string",
              "status": "int",
              "subStatus": "int",
              "timeInterval": "string",
              "win32Status": "int"
            }
          ],
          "statusCodesRange": [
            {
              "count": "int",
              "path": "string",
              "statusCodes": "string",
              "timeInterval": "string"
            }
          ]
        }
      },
      "autoSwapSlotName": "string",
      "azureStorageAccounts": {},
      "connectionStrings": [
        {
          "connectionString": "string",
          "name": "string",
          "type": "string"
        }
      ],
      "cors": {
        "allowedOrigins": [ "string" ],
        "supportCredentials": "bool"
      },
      "defaultDocuments": [ "string" ],
      "detailedErrorLoggingEnabled": "bool",
      "documentRoot": "string",
      "elasticWebAppScaleLimit": "int",
      "experiments": {
        "rampUpRules": [
          {
            "actionHostName": "string",
            "changeDecisionCallbackUrl": "string",
            "changeIntervalInMinutes": "int",
            "changeStep": "int",
            "maxReroutePercentage": "int",
            "minReroutePercentage": "int",
            "name": "string",
            "reroutePercentage": "int"
          }
        ]
      },
      "ftpsState": "string",
      "functionAppScaleLimit": "int",
      "functionsRuntimeScaleMonitoringEnabled": "bool",
      "handlerMappings": [
        {
          "arguments": "string",
          "extension": "string",
          "scriptProcessor": "string"
        }
      ],
      "healthCheckPath": "string",
      "http20Enabled": "bool",
      "httpLoggingEnabled": "bool",
      "ipSecurityRestrictions": [
        {
          "action": "string",
          "description": "string",
          "headers": {},
          "ipAddress": "string",
          "name": "string",
          "priority": "int",
          "subnetMask": "string",
          "subnetTrafficTag": "int",
          "tag": "string",
          "vnetSubnetResourceId": "string",
          "vnetTrafficTag": "int"
        }
      ],
      "ipSecurityRestrictionsDefaultAction": "string",
      "javaContainer": "string",
      "javaContainerVersion": "string",
      "javaVersion": "string",
      "keyVaultReferenceIdentity": "string",
      "limits": {
        "maxDiskSizeInMb": "int",
        "maxMemoryInMb": "int",
        "maxPercentageCpu": "int"
      },
      "linuxFxVersion": "string",
      "loadBalancing": "string",
      "localMySqlEnabled": "bool",
      "logsDirectorySizeLimit": "int",
      "managedPipelineMode": "string",
      "managedServiceIdentityId": "int",
      "metadata": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "minimumElasticInstanceCount": "int",
      "minTlsVersion": "string",
      "netFrameworkVersion": "string",
      "nodeVersion": "string",
      "numberOfWorkers": "int",
      "phpVersion": "string",
      "powerShellVersion": "string",
      "preWarmedInstanceCount": "int",
      "publicNetworkAccess": "string",
      "publishingUsername": "string",
      "push": {
        "kind": "string",
        "properties": {
          "dynamicTagsJson": "string",
          "isPushEnabled": "bool",
          "tagsRequiringAuth": "string",
          "tagWhitelistJson": "string"
        }
      },
      "pythonVersion": "string",
      "remoteDebuggingEnabled": "bool",
      "remoteDebuggingVersion": "string",
      "requestTracingEnabled": "bool",
      "requestTracingExpirationTime": "string",
      "scmIpSecurityRestrictions": [
        {
          "action": "string",
          "description": "string",
          "headers": {},
          "ipAddress": "string",
          "name": "string",
          "priority": "int",
          "subnetMask": "string",
          "subnetTrafficTag": "int",
          "tag": "string",
          "vnetSubnetResourceId": "string",
          "vnetTrafficTag": "int"
        }
      ],
      "scmIpSecurityRestrictionsDefaultAction": "string",
      "scmIpSecurityRestrictionsUseMain": "bool",
      "scmMinTlsVersion": "string",
      "scmType": "string",
      "tracingOptions": "string",
      "use32BitWorkerProcess": "bool",
      "virtualApplications": [
        {
          "physicalPath": "string",
          "preloadEnabled": "bool",
          "virtualDirectories": [
            {
              "physicalPath": "string",
              "virtualPath": "string"
            }
          ],
          "virtualPath": "string"
        }
      ],
      "vnetName": "string",
      "vnetPrivatePortsCount": "int",
      "vnetRouteAllEnabled": "bool",
      "websiteTimeZone": "string",
      "webSocketsEnabled": "bool",
      "windowsFxVersion": "string",
      "xManagedServiceIdentityId": "int"
    },
    "storageAccountRequired": "bool",
    "virtualNetworkSubnetId": "string",
    "vnetContentShareEnabled": "bool",
    "vnetImagePullEnabled": "bool",
    "vnetRouteAllEnabled": "bool"
  }
}

Valori delle proprietà

sites/slots

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.Web/sites/slot'
apiVersion Versione dell'API risorsa '2022-09-01'
name Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio nei modelli di RESOURCE JSON.		 stringa (obbligatoria)

Limite di caratteri: 2-59

Caratteri validi:
Caratteri alfanumerici, trattini e Unicode che possono essere mappati a Punycode
posizione Posizione risorsa. stringa (obbligatoria)
tags Tag di risorse. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
kind Tipo di risorsa. string
extendedLocation Posizione estesa. ExtendedLocation
identity Identità del servizio gestita. ManagedServiceIdentity
properties Proprietà specifiche della risorsa del sito Proprietà del sito

ExtendedLocation

Nome Descrizione valore
name Nome della posizione estesa. string

ManagedServiceIdentity

Nome Descrizione Valore
tipo Tipo di identità del servizio gestito. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco delle identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} object

Proprietà del sito

Nome Descrizione Valore
clientAffinityEnabled true per abilitare l'affinità client; false per interrompere l'invio di cookie di affinità di sessione, che instradano le richieste client nella stessa sessione alla stessa istanza. Il valore predefinito è true. bool
clientCertEnabled true per abilitare l'autenticazione del certificato client (autenticazione reciproca TLS); in caso contrario, false. Il valore predefinito è false. bool
clientCertExclusionPaths Percorsi di esclusione delimitati da virgole per l'autenticazione del certificato client string
clientCertMode Questa composizione viene composta con l'impostazione ClientCertEnabled.
- ClientCertEnabled: false significa che ClientCert viene ignorato.
- ClientCertEnabled: true e ClientCertMode: obbligatorio significa che ClientCert è obbligatorio.
- ClientCertEnabled: true e ClientCertMode: facoltativo significa che ClientCert è facoltativo o accettato.		 'Facoltativo'
'OptionalInteractiveUser'
'Obbligatorio'
cloningInfo Se specificato durante la creazione dell'app, l'app viene clonata da un'app di origine. CloningInfo
containerSize Dimensioni del contenitore di funzioni. INT
customDomainVerificationId Identificatore univoco che verifica i domini personalizzati assegnati all'app. Il cliente aggiungerà questo ID a un record txt per la verifica. string
dailyMemoryTimeQuota Quota giornaliera massima consentita per la memoria (applicabile solo nelle app dinamiche). INT
Enabled true se l'app è abilitata; in caso contrario, false. L'impostazione di questo valore su false disabilita l'app (accetta l'app offline). bool
hostingEnvironmentProfile ambiente del servizio app da usare per l'app. HostingEnvironmentProfile
hostNamesDisabled true per disabilitare i nomi host pubblici dell'app; in caso contrario, false.
Se true, l'app è accessibile solo tramite il processo di gestione API.		 bool
hostNameSslStates Gli stati SSL nome host vengono usati per gestire le associazioni SSL per i nomi host dell'app. HostNameSslState[]
httpsOnly HttpsOnly: configura un sito Web per accettare solo richieste https. Problemi di reindirizzamento per
richieste http		 bool
hyperV Sandbox Hyper-V. bool
isXenon Obsoleto: sandbox Hyper-V. bool
keyVaultReferenceIdentity Identità da usare per l'autenticazione di riferimento Key Vault. string
managedEnvironmentId Azure Resource Manager ID dell'ambiente gestito selezionato del cliente in cui ospitare questa app. Deve essere del modulo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} string
publicNetworkAccess Proprietà per consentire o bloccare tutto il traffico pubblico. Valori consentiti: 'Enabled', 'Disabled' o una stringa vuota. string
ridondanzaMode Modalità di ridondanza del sito 'ActiveActive'
'Failover'
'GeoRedundant'
'Manuale'
'Nessuno'
reserved true se riservato; in caso contrario, false. bool
scmSiteAlsoStopped true per arrestare il sito SCM (KUDU) quando l'app viene arrestata; in caso contrario, false. Il valore predefinito è false. bool
serverFarmId ID risorsa del piano di servizio app associato, formattato come :"/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". string
siteConfig Configurazione dell'app. SiteConfig
storageAccountRequired Verifica se è necessario l'account di archiviazione fornito dal cliente bool
virtualNetworkSubnetId Azure Resource Manager ID della rete virtuale e della subnet da aggiungere all'integrazione della rete virtuale a livello di area.
Deve essere del modulo /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}		 string
vnetContentShareEnabled Per abilitare l'accesso al contenuto tramite rete virtuale bool
vnetImagePullEnabled Per abilitare il pull dell'immagine su Rete virtuale bool
vnetRouteAllEnabled Rete virtuale Route All abilitato. Ciò causa l'applicazione di tutti i flussi in uscita Rete virtuale gruppi di sicurezza e route definite dall'utente. bool

CloningInfo

Nome Descrizione Valore
appSettingsOverrides L'impostazione dell'applicazione esegue l'override per l'app clonata. Se specificato, queste impostazioni eseguono l'override delle impostazioni clonate
dall'app di origine. In caso contrario, le impostazioni dell'applicazione dall'app di origine vengono mantenute.		 object
cloneCustomHostNames true per clonare nomi host personalizzati dall'app di origine; in caso contrario, false. bool
cloneSourceControl true per clonare il controllo del codice sorgente dall'app di origine; in caso contrario, false. bool
configureLoadBalancing true per configurare il bilanciamento del carico per l'app di origine e destinazione. bool
correlationId ID di correlazione dell'operazione di clonazione. Questo ID associa più operazioni di clonazione
insieme per usare lo stesso snapshot.		 string
hostingEnvironment ambiente del servizio app. string
overwrite true per sovrascrivere l'app di destinazione; in caso contrario, false. bool
sourceWebAppId ID risorsa ARM dell'app di origine. L'ID risorsa dell'app è del modulo
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} per gli slot di produzione e
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} per altri slot.		 stringa (obbligatorio)
sourceWebAppLocation Posizione dell'app di origine, ad esempio Stati Uniti occidentali o Europa settentrionale string
trafficManagerProfileId ID risorsa ARM del profilo di Gestione traffico da usare, se esistente. L'ID risorsa di Gestione traffico è del modulo
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.		 string
trafficManagerProfileName Nome del profilo di Gestione traffico da creare. Questa operazione è necessaria solo se il profilo di Gestione traffico non esiste già. string

HostingEnvironmentProfile

Nome Descrizione Valore
id ID risorsa del ambiente del servizio app. string

HostNameSslState

Nome Descrizione Valore
hostType Indica se il nome host è un nome host standard o repository. 'Repository'
'Standard'
name Nome host. string
sslState Tipo SSL. 'Disabilitato'
'IpBasedEnabled'
'SniEnabled'
thumbprint Identificazione personale del certificato SSL. string
toUpdate Impostare su true per aggiornare il nome host esistente. bool
virtualIP Indirizzo IP virtuale assegnato al nome host se è abilitato SSL basato su IP. string

SiteConfig

Nome Descrizione Valore
acrUseManagedIdentityCreds Flag per l'uso di cred di identità gestite per il pull di Registro Azure Container bool
acrUserManagedIdentityID Se si usa l'identità gestita dall'utente, id client dell'identità gestita dall'utente string
Alwayson truese Always On è abilitato; in caso contrario, false. bool
apiDefinition Informazioni sulla definizione dell'API formale per l'app. ApiDefinitionInfo
apiManagementConfig Impostazioni di Gestione API di Azure collegate all'app. ApiManagementConfig
appCommandLine Riga di comando dell'app da avviare. string
appSettings Impostazioni delle applicazioni. NameValuePair[]
autoHealEnabled true se la correzione automatica è abilitata; in caso contrario, false. bool
autoHealRules Regole di correzione automatica. AutoHealRules
autoSwapSlotName Nome dello slot di scambio automatico. string
azureStorageAccounts Elenco di account di archiviazione di Azure. object
connectionStrings Stringhe di connessione. ConnStringInfo[]
CORS Impostazioni CORS (Cross-Origin Resource Sharing). CorsSettings
defaultDocuments Documenti predefiniti. string[]
detailedErrorLoggingEnabled true se la registrazione dettagliata degli errori è abilitata; in caso contrario, false. bool
documentRoot Radice del documento. string
elasticWebAppScaleLimit Numero massimo di lavoratori a cui un sito può aumentare il numero massimo.
Questa impostazione si applica solo alle app nei piani in cui ElasticScaleEnabled è true		 INT
Esperimenti Questo è il problema per i tipi polimorfici. Sperimentazioni
ftpsState Stato del servizio FTP/FTPS 'AllAllowed'
'Disabilitato'
'FtpsOnly'
functionAppScaleLimit Numero massimo di lavoratori a cui un sito può aumentare il numero massimo.
Questa impostazione si applica solo ai piani Consumo e Premium elastici		 INT
functionsRuntimeScaleMonitoringEnabled Ottiene o imposta un valore che indica se il monitoraggio della scalabilità di runtime delle funzioni è abilitato. Se abilitata,
ScaleController non monitorerà direttamente le origini eventi, ma chiamerà invece all'oggetto
runtime per ottenere lo stato di scalabilità.		 bool
gestoreMappings Mapping dei gestori. HandlerMapping[]
healthCheckPath Percorso di controllo dell'integrità string
http20Enabled Http20Enabled: configura un sito Web per consentire ai client di connettersi tramite http2.0 bool
httpLoggingEnabled true se la registrazione HTTP è abilitata; in caso contrario, false. bool
ipSecurityRestrictions Restrizioni di sicurezza IP per main. IpSecurityRestriction[]
ipSecurityRestrictionsDefaultAction Azione predefinita per la restrizione di accesso principale se non vengono corrispondenti regole. 'Allow'
'Deny'
javaContainer Contenitore Java. string
javaContainerVersion Versione del contenitore Java. string
javaVersion Versione Java. string
keyVaultReferenceIdentity Identità da usare per l'autenticazione di riferimento Key Vault. string
limiti Limiti del sito. SiteLimits
linuxFxVersion Framework e versione di Linux App Framework string
loadBalancing Bilanciamento del carico del sito. 'LeastRequests'
'LeastResponseTime'
'PerSiteRoundRobin'
'RequestHash'
'WeightedRoundRobin'
'WeightedTotalTraffic'
localMySqlEnabled true per abilitare MySQL locale; in caso contrario, false. bool
logsDirectorySizeLimit Limite di dimensioni della directory dei log HTTP. INT
managedPipelineMode Modalità pipeline gestita. 'Classico'
'Integrato'
managedServiceIdentityId ID identità del servizio gestito INT
metadata Metadati dell'applicazione. Questa proprietà non può essere recuperata, poiché può contenere segreti. NameValuePair[]
minimumElasticInstanceCount Numero di numero minimo di istanze per un sito
Questa impostazione si applica solo ai piani elastici		 INT
minTlsVersion MinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL '1.0'
'1.1'
'1.2'
netFrameworkVersion Versione di .NET Framework. string
nodeVersion Versione di Node.js. string
numberOfWorkers Numero di ruoli di lavoro. INT
phpVersion Versione di PHP. string
powerShellVersion Versione di PowerShell. string
preWarmedInstanceCount Numero di istanze preAvvise.
Questa impostazione si applica solo ai piani a consumo e elastici		 INT
publicNetworkAccess Proprietà per consentire o bloccare tutto il traffico pubblico. string
publishingUsername Nome utente di pubblicazione. string
push Eseguire il push delle impostazioni dell'endpoint. PushSettings
pythonVersion Versione di Python. string
remoteDebuggingEnabled true se il debug remoto è abilitato; in caso contrario, false. bool
remoteDebuggingVersion Versione di debug remoto. string
requestTracingEnabled true se la traccia delle richieste è abilitata; in caso contrario, false. bool
requestTracingExpirationTime Tempo di scadenza della traccia delle richieste. string
scmIpSecurityRestrictions Restrizioni di sicurezza IP per scm. IpSecurityRestriction[]
scmIpSecurityRestrictionsDefaultAction Azione predefinita per la restrizione di accesso di scm se non vengono soddisfatte regole. 'Consenti'
'Deny'
scmIpSecurityRestrictionsUseMain Restrizioni di sicurezza IP per scm da usare main. bool
scmMinTlsVersion ScmMinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL per il sito SCM '1.0'
'1.1'
'1.2'
scmType Tipo SCM. 'BitbucketGit'
'BitbucketHg'
'CodePlexGit'
'CodePlexHg'
'Dropbox'
'ExternalGit'
'ExternalHg'
'GitHub'
'LocalGit'
'Nessuno'
'OneDrive'
'Tfs'
'VSO'
'VSTSRM'
tracingOptions Opzioni di traccia. string
use32BitWorkerProcess true per utilizzare il processo di lavoro a 32 bit; in caso contrario, false. bool
virtualApplications Applicazioni virtuali. VirtualApplication[]
vnetName Rete virtuale nome. string
vnetPrivatePortsCount Numero di porte private assegnate a questa app. Queste verranno assegnate in modo dinamico in fase di esecuzione. INT
vnetRouteAllEnabled Rete virtuale Instrada tutto abilitato. Ciò fa sì che tutto il traffico in uscita abbia Rete virtuale gruppi di sicurezza e route definite dall'utente applicati. bool
websiteTimeZone Imposta il fuso orario utilizzato da un sito per la generazione di timestamp. Compatibile con Linux e Windows servizio app. L'impostazione dell'impostazione dell'app WEBSITE_TIME_ZONE ha la precedenza su questa configurazione. Per Linux, prevede valori https://www.iana.org/time-zones di database tz (per un riferimento rapido vedere https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Per Windows, prevede uno dei fusi orari elencati in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones string
webSocketsEnabled true se WebSocket è abilitato; in caso contrario, false. bool
windowsFxVersion Xenon App Framework e versione string
xManagedServiceIdentityId ID identità del servizio gestito esplicito INT

ApiDefinitionInfo

Nome Descrizione Valore
url URL della definizione dell'API. string

ApiManagementConfig

Nome Descrizione Valore
id APIM-Api Identificatore. string

NameValuePair

Nome Descrizione valore
name Nome coppia. string
Valore Valore di coppia. string

AutoHealRules

Nome Descrizione Valore
Azioni Azioni da eseguire quando viene attivata una regola. AutoHealActions
trigger Condizioni che descrivono quando eseguire le azioni di ripristino automatico. AutoHealTriggers

AutoHealActions

Nome Descrizione Valore
actionType Azione predefinita da eseguire. 'CustomAction'
'LogEvent'
'Cestino'
Customaction Azione personalizzata da eseguire. AutoHealCustomAction
minProcessExecutionTime Tempo minimo per l'esecuzione del processo
prima di eseguire l'azione
 string

AutoHealCustomAction

Nome Descrizione Valore
exe Eseguibile da eseguire. string
parametri Parametri per l'eseguibile. string

AutoHealTriggers

Nome Descrizione Valore
privateBytesInKB Regola basata su byte privati. INT
requests Regola basata sulle richieste totali. RichiesteBasedTrigger
slowRequests Regola basata sul tempo di esecuzione della richiesta. SlowRequestsBasedTrigger
slowRequestsWithPath Regola basata su più regole richieste lente con percorso SlowRequestsBasedTrigger[]
statusCodes Regola basata sui codici di stato. StatusCodesBasedTrigger[]
statusCodesRange Regola basata sugli intervalli di codici di stato. StatusCodesRangeBasedTrigger[]

RichiesteBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
timeInterval Intervallo di tempo. string

SlowRequestsBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
path Percorso richiesta. string
timeInterval Intervallo di tempo. string
timeTaken Tempo impiegato. string

StatusCodesBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
path Percorso della richiesta string
status Codice stato HTTP. INT
subStatus Stato della sotto richiesta. INT
timeInterval Intervallo di tempo. string
win32Status Codice di errore Win32. INT

StatusCodesRangeBasedTrigger

Nome Descrizione Valore
count Conteggio richieste. INT
path string
statusCodes Codice stato HTTP. string
timeInterval Intervallo di tempo. string

ConnStringInfo

Nome Descrizione Valore
connectionString Valore stringa di connessione. string
name Nome della stringa di connessione. string
type Tipo di database. 'ApiHub'
'Personalizzato'
'DocDb'
'EventHub'
'MySql'
'NotificationHub'
'PostgreSQL'
'RedisCache'
'SQLAzure'
'SQLServer'
'ServiceBus'

CorsSettings

Nome Descrizione Valore
allowedOrigins Ottiene o imposta l'elenco di origini che devono essere consentite per rendere l'origine incrociata
chiamate (ad esempio: http://example.com:12345). Usare "*" per consentirli tutti.		 string[]
supportCredentials Ottiene o imposta se le richieste CORS con credenziali sono consentite. Vedere
https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials
per altri dettagli.
 bool

Sperimentazioni

Nome Descrizione Valore
rampUpRules Elenco delle regole di ramp-up. RampUpRule[]

RampUpRule

Nome Descrizione Valore
actionHostName Nome host di uno slot a cui verrà reindirizzato il traffico se deciso. Ad esempio, myapp-stage.azurewebsites.net. string
changeDecisionCallbackUrl L'algoritmo decisionale personalizzato può essere fornito nell'estensione del sito TiPCallback che è possibile specificare l'URL. Vedere l'estensione del sito TiPCallback per lo scaffold e i contratti.
https://www.siteextensions.net/packages/TiPCallback/		 string
changeIntervalInMinutes Specifica l'intervallo in minuti per rivalutare ReroutePercentage. INT
changeStep Nello scenario di aumento automatico si tratta del passaggio da cui aggiungere/rimuovere ReroutePercentage finché non raggiunge \nMinReroutePercentage o
MaxReroutePercentage. Le metriche del sito vengono controllate ogni N minuti specificati in ChangeIntervalInMinutes.\nalgoritmo decisionale personalizzato
può essere fornito nell'estensione del sito TiPCallback che può essere specificato in ChangeDecisionCallbackUrl.		 INT
maxReroutePercentage Specifica il limite superiore al di sotto del quale rimarrà ReroutePercentage. INT
minReroutePercentage Specifica un limite inferiore sopra il quale reroutePercentage rimarrà. INT
name Nome della regola di routing. Il nome consigliato consiste nel puntare allo slot che riceverà il traffico nell'esperimento. string
reroutePercentage Percentuale del traffico che verrà reindirizzato a ActionHostName. INT

GestoreMapping

Nome Descrizione Valore
argomenti Argomenti della riga di comando da passare al processore di script. string
estensione Le richieste con questa estensione verranno gestite usando l'applicazione FastCGI specificata. string
scriptProcessor Percorso assoluto dell'applicazione FastCGI. string

IpSecurityRestriction

Nome Descrizione Valore
azione Consenti o Nega l'accesso per questo intervallo IP. string
description Descrizione della regola di restrizione IP. string
headers Intestazioni delle regole di restrizione IP.
X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples).
La logica corrispondente è ..
- Se la proprietà è null o vuota (impostazione predefinita), sono consentiti tutti gli host(o la mancanza di) .
- Viene confrontato un valore usando ordinal-ignore-case (escluso il numero di porta).
- I caratteri jolly sottodominio sono consentiti, ma non corrispondono al dominio radice. Ad esempio, *.contoso.com corrisponde al sottodominio foo.contoso.com
ma non il dominio radice contoso.com o foo.bar.contoso.com a più livelli
- I nomi host Unicode sono consentiti ma vengono convertiti in Punycode per la corrispondenza.

X-Forwarded-for (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples).
La logica corrispondente è ..
- Se la proprietà è null o vuota (impostazione predefinita), sono consentite eventuali catene inoltrate (o mancanza di).
- Se qualsiasi indirizzo (escluso il numero di porta) nella catena (delimitato da virgole) corrisponde al CIDR definito dalla proprietà .

X-Azure-FDID e X-FD-HealthProbe.
La logica di corrispondenza è esatta.		 object
IpAddress Indirizzo IP per cui la restrizione di sicurezza è valida.
Può essere in forma di indirizzo ipv4 puro (proprietà SubnetMask richiesta) o
Notazione CIDR, ad esempio ipv4/mask (corrispondenza di bit iniziale). Per CIDR,
La proprietà SubnetMask non deve essere specificata.		 string
name Nome della regola di restrizione IP. string
priority Priorità della regola di restrizione IP. INT
Subnetmask Subnet mask per l'intervallo di indirizzi IP per cui la restrizione è valida. string
subnetTrafficTag (interno) Tag del traffico della subnet INT
tag Definisce l'utilizzo di questo filtro IP. Si tratta di supportare il filtro IP sui proxy. Impostazione predefinita
'ServiceTag'
'XffProxy'
vnetSubnetResourceId ID risorsa di rete virtuale string
vnetTrafficTag (interno) Tag del traffico della rete virtuale INT

SiteLimits

Nome Descrizione Valore
maxDiskSizeInMb Utilizzo massimo consentito delle dimensioni del disco in MB. INT
maxMemoryInMb Utilizzo massimo consentito della memoria in MB. INT
maxPercentageCpu Percentuale massima di utilizzo della CPU consentita. INT

PushSettings

Nome Descrizione Valore
kind Tipo di risorsa. string
properties Proprietà specifiche delle risorse PushSettings PushSettingsProperties

PushSettingsProperties

Nome Descrizione Valore
dynamicTagsJson Ottiene o imposta una stringa JSON contenente un elenco di tag dinamici che verranno valutati dalle attestazioni utente nell'endpoint di registrazione push. string
isPushEnabled Ottiene o imposta un flag che indica se l'endpoint push è abilitato. bool (obbligatorio)
tagsRequiringAuth Ottiene o imposta una stringa JSON contenente un elenco di tag che richiedono l'autenticazione utente da usare nell'endpoint di registrazione push.
I tag possono essere costituiti da caratteri alfanumerici e i seguenti:
'_', '@', '#', '.', ':', '-'.
La convalida deve essere eseguita in PushRequestHandler.		 string
tagWhitelistJson Ottiene o imposta una stringa JSON contenente un elenco di tag consentiti per l'uso dall'endpoint di registrazione push. string

VirtualApplication

Nome Descrizione Valore
Physicalpath Percorso fisico. string
preloadEnabled true se il precaricamento è abilitato; in caso contrario, false. bool
virtualDirectories Directory virtuali per l'applicazione virtuale. VirtualDirectory[]
virtualPath Percorso virtuale. string

VirtualDirectory

Nome Descrizione Valore
Physicalpath Percorso fisico. string
virtualPath Percorso dell'applicazione virtuale. string

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Modello Descrizione
Eseguire il provisioning della funzione del piano a consumo con uno slot di distribuzione

Distribuisci in Azure		 Questo modello effettua il provisioning di un'app per le funzioni in un piano a consumo, ovvero un piano di hosting dinamico. L'app viene eseguita su richiesta e viene fatturata per ogni esecuzione, senza impegno permanente per le risorse. Sono disponibili altri modelli per il provisioning in un piano di hosting dedicato.
App per le funzioni di Azure con uno slot di distribuzione

Distribuisci in Azure		 Questo modello effettua il provisioning di un'app per le funzioni in un piano Premium con slot di produzione e uno slot di distribuzione aggiuntivo.
App Web con slot di distribuzione personalizzati

Distribuisci in Azure		 Questo modello offre un modo semplice per distribuire un'app Web con slot di distribuzione personalizzati in Azure App Web.
App Web multi-area a disponibilità elevata

Distribuisci in Azure		 Questo modello consente di creare una soluzione end-to-end sicura e a disponibilità elevata con due app Web in aree diverse dietro Frontdoor di Azure
Proteggere un'app Web a più livelli

Distribuisci in Azure		 Questo modello consente di creare una soluzione end-to-end sicura con due app Web con slot di staging, front-end e back-end, il front-end utilizzerà in modo sicuro il back tramite l'inserimento della rete virtuale e l'endpoint privato

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa siti/slot può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Web/sites/slots, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/sites/slots@2022-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      clientAffinityEnabled = bool
      clientCertEnabled = bool
      clientCertExclusionPaths = "string"
      clientCertMode = "string"
      cloningInfo = {
        appSettingsOverrides = {}
        cloneCustomHostNames = bool
        cloneSourceControl = bool
        configureLoadBalancing = bool
        correlationId = "string"
        hostingEnvironment = "string"
        overwrite = bool
        sourceWebAppId = "string"
        sourceWebAppLocation = "string"
        trafficManagerProfileId = "string"
        trafficManagerProfileName = "string"
      }
      containerSize = int
      customDomainVerificationId = "string"
      dailyMemoryTimeQuota = int
      enabled = bool
      hostingEnvironmentProfile = {
        id = "string"
      }
      hostNamesDisabled = bool
      hostNameSslStates = [
        {
          hostType = "string"
          name = "string"
          sslState = "string"
          thumbprint = "string"
          toUpdate = bool
          virtualIP = "string"
        }
      ]
      httpsOnly = bool
      hyperV = bool
      isXenon = bool
      keyVaultReferenceIdentity = "string"
      managedEnvironmentId = "string"
      publicNetworkAccess = "string"
      redundancyMode = "string"
      reserved = bool
      scmSiteAlsoStopped = bool
      serverFarmId = "string"
      siteConfig = {
        acrUseManagedIdentityCreds = bool
        acrUserManagedIdentityID = "string"
        alwaysOn = bool
        apiDefinition = {
          url = "string"
        }
        apiManagementConfig = {
          id = "string"
        }
        appCommandLine = "string"
        appSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        autoHealEnabled = bool
        autoHealRules = {
          actions = {
            actionType = "string"
            customAction = {
              exe = "string"
              parameters = "string"
            }
            minProcessExecutionTime = "string"
          }
          triggers = {
            privateBytesInKB = int
            requests = {
              count = int
              timeInterval = "string"
            }
            slowRequests = {
              count = int
              path = "string"
              timeInterval = "string"
              timeTaken = "string"
            }
            slowRequestsWithPath = [
              {
                count = int
                path = "string"
                timeInterval = "string"
                timeTaken = "string"
              }
            ]
            statusCodes = [
              {
                count = int
                path = "string"
                status = int
                subStatus = int
                timeInterval = "string"
                win32Status = int
              }
            ]
            statusCodesRange = [
              {
                count = int
                path = "string"
                statusCodes = "string"
                timeInterval = "string"
              }
            ]
          }
        }
        autoSwapSlotName = "string"
        azureStorageAccounts = {}
        connectionStrings = [
          {
            connectionString = "string"
            name = "string"
            type = "string"
          }
        ]
        cors = {
          allowedOrigins = [
            "string"
          ]
          supportCredentials = bool
        }
        defaultDocuments = [
          "string"
        ]
        detailedErrorLoggingEnabled = bool
        documentRoot = "string"
        elasticWebAppScaleLimit = int
        experiments = {
          rampUpRules = [
            {
              actionHostName = "string"
              changeDecisionCallbackUrl = "string"
              changeIntervalInMinutes = int
              changeStep = int
              maxReroutePercentage = int
              minReroutePercentage = int
              name = "string"
              reroutePercentage = int
            }
          ]
        }
        ftpsState = "string"
        functionAppScaleLimit = int
        functionsRuntimeScaleMonitoringEnabled = bool
        handlerMappings = [
          {
            arguments = "string"
            extension = "string"
            scriptProcessor = "string"
          }
        ]
        healthCheckPath = "string"
        http20Enabled = bool
        httpLoggingEnabled = bool
        ipSecurityRestrictions = [
          {
            action = "string"
            description = "string"
            headers = {}
            ipAddress = "string"
            name = "string"
            priority = int
            subnetMask = "string"
            subnetTrafficTag = int
            tag = "string"
            vnetSubnetResourceId = "string"
            vnetTrafficTag = int
          }
        ]
        ipSecurityRestrictionsDefaultAction = "string"
        javaContainer = "string"
        javaContainerVersion = "string"
        javaVersion = "string"
        keyVaultReferenceIdentity = "string"
        limits = {
          maxDiskSizeInMb = int
          maxMemoryInMb = int
          maxPercentageCpu = int
        }
        linuxFxVersion = "string"
        loadBalancing = "string"
        localMySqlEnabled = bool
        logsDirectorySizeLimit = int
        managedPipelineMode = "string"
        managedServiceIdentityId = int
        metadata = [
          {
            name = "string"
            value = "string"
          }
        ]
        minimumElasticInstanceCount = int
        minTlsVersion = "string"
        netFrameworkVersion = "string"
        nodeVersion = "string"
        numberOfWorkers = int
        phpVersion = "string"
        powerShellVersion = "string"
        preWarmedInstanceCount = int
        publicNetworkAccess = "string"
        publishingUsername = "string"
        push = {
          kind = "string"
          properties = {
            dynamicTagsJson = "string"
            isPushEnabled = bool
            tagsRequiringAuth = "string"
            tagWhitelistJson = "string"
          }
        }
        pythonVersion = "string"
        remoteDebuggingEnabled = bool
        remoteDebuggingVersion = "string"
        requestTracingEnabled = bool
        requestTracingExpirationTime = "string"
        scmIpSecurityRestrictions = [
          {
            action = "string"
            description = "string"
            headers = {}
            ipAddress = "string"
            name = "string"
            priority = int
            subnetMask = "string"
            subnetTrafficTag = int
            tag = "string"
            vnetSubnetResourceId = "string"
            vnetTrafficTag = int
          }
        ]
        scmIpSecurityRestrictionsDefaultAction = "string"
        scmIpSecurityRestrictionsUseMain = bool
        scmMinTlsVersion = "string"
        scmType = "string"
        tracingOptions = "string"
        use32BitWorkerProcess = bool
        virtualApplications = [
          {
            physicalPath = "string"
            preloadEnabled = bool
            virtualDirectories = [
              {
                physicalPath = "string"
                virtualPath = "string"
              }
            ]
            virtualPath = "string"
          }
        ]
        vnetName = "string"
        vnetPrivatePortsCount = int
        vnetRouteAllEnabled = bool
        websiteTimeZone = "string"
        webSocketsEnabled = bool
        windowsFxVersion = "string"
        xManagedServiceIdentityId = int
      }
      storageAccountRequired = bool
      virtualNetworkSubnetId = "string"
      vnetContentShareEnabled = bool
      vnetImagePullEnabled = bool
      vnetRouteAllEnabled = bool
    }
    kind = "string"
    extendedLocation = {
      name = "string"
    }
  })
}

Valori delle proprietà

sites/slots

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.Web/sites/slots@2022-09-01"
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 2-59

Caratteri validi:
Caratteri alfanumerici, trattini e Unicode di cui è possibile eseguire il mapping a Punycode
posizione Posizione risorsa. stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: siti
tags Tag delle risorse. Dizionario di nomi e valori di tag.
kind Tipo di risorsa. string
extendedLocation Posizione estesa. ExtendedLocation
identity Identità del servizio gestito. ManagedServiceIdentity
properties Proprietà specifiche delle risorse del sito Proprietà sito

ExtendedLocation

Nome Descrizione valore
name Nome della posizione estesa. string

ManagedServiceIdentity

Nome Descrizione Valore
tipo Tipo di identità del servizio gestito. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} Matrice di ID identità utente.

Proprietà sito

Nome Descrizione Valore
clientAffinityEnabled true per abilitare l'affinità client; false per interrompere l'invio dei cookie di affinità di sessione, che instradano le richieste client nella stessa sessione alla stessa istanza. Il valore predefinito è true. bool
clientCertEnabled true per abilitare l'autenticazione del certificato client (autenticazione reciproca TLS); in caso contrario, false. Il valore predefinito è false. bool
clientCertExclusionPaths percorsi di esclusione delimitati da virgole per l'autenticazione del certificato client string
clientCertMode Viene creato con l'impostazione ClientCertEnabled.
- ClientCertEnabled: false indica che ClientCert viene ignorato.
- ClientCertEnabled: true e ClientCertMode: obbligatorio significa che ClientCert è obbligatorio.
- ClientCertEnabled: true e ClientCertMode: facoltativo significa che ClientCert è facoltativo o accettato.		 "Facoltativo"
"OptionalInteractiveUser"
"Obbligatorio"
cloningInfo Se specificato durante la creazione dell'app, l'app viene clonata da un'app di origine. CloningInfo
containerSize Dimensioni del contenitore di funzioni. INT
customDomainVerificationId Identificatore univoco che verifica i domini personalizzati assegnati all'app. Il cliente aggiungerà questo ID a un record txt per la verifica. string
dailyMemoryTimeQuota Quota massima consentita per il tempo di memoria giornaliero (applicabile solo alle app dinamiche). INT
Enabled true se l'app è abilitata; in caso contrario, false. L'impostazione di questo valore su false disabilita l'app (porta l'app offline). bool
hostingEnvironmentProfile ambiente del servizio app da usare per l'app. HostingEnvironmentProfile
hostNamesDisabled true per disabilitare i nomi host pubblici dell'app; in caso contrario, false.
Se true, l'app è accessibile solo tramite il processo di gestione API.		 bool
hostNameSslStates Gli stati SSL del nome host vengono usati per gestire le associazioni SSL per i nomi host dell'app. HostNameSslState[]
httpsOnly HttpsOnly: configura un sito Web per accettare solo richieste https. Problemi di reindirizzamento per
richieste http		 bool
hyperV Sandbox Hyper-V. bool
isXenon Obsoleto: sandbox Hyper-V. bool
keyVaultReferenceIdentity Identità da usare per l'autenticazione di riferimento Key Vault. string
managedEnvironmentId Azure Resource Manager ID dell'ambiente gestito selezionato del cliente in cui ospitare questa app. Deve essere del modulo /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} string
publicNetworkAccess Proprietà per consentire o bloccare tutto il traffico pubblico. Valori consentiti: 'Enabled', 'Disabled' o una stringa vuota. string
ridondanzaMode Modalità di ridondanza del sito "ActiveActive"
"Failover"
"GeoRedundant"
"Manuale"
"None"
reserved true se riservato; in caso contrario, false. bool
scmSiteAlsoStopped true per arrestare il sito SCM (KUDU) quando l'app viene arrestata; in caso contrario, false. Il valore predefinito è false. bool
serverFarmId ID risorsa del piano di servizio app associato, formattato come :"/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". string
siteConfig Configurazione dell'app. SiteConfig
storageAccountRequired Verifica se è necessario l'account di archiviazione fornito dal cliente bool
virtualNetworkSubnetId Azure Resource Manager ID della rete virtuale e della subnet da aggiungere all'integrazione della rete virtuale a livello di area.
Deve essere del modulo /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}		 string
vnetContentShareEnabled Per abilitare l'accesso al contenuto tramite rete virtuale bool
vnetImagePullEnabled Per abilitare il pull dell'immagine su Rete virtuale bool
vnetRouteAllEnabled Rete virtuale Route All abilitato. Ciò causa l'applicazione di tutti i flussi in uscita Rete virtuale gruppi di sicurezza e route definite dall'utente. bool

CloningInfo

Nome Descrizione Valore
appSettingsOverrides L'impostazione dell'applicazione esegue l'override per l'app clonata. Se specificato, queste impostazioni eseguono l'override delle impostazioni clonate
dall'app di origine. In caso contrario, le impostazioni dell'applicazione dall'app di origine vengono mantenute.		 object
cloneCustomHostNames true per clonare nomi host personalizzati dall'app di origine; in caso contrario, false. bool
cloneSourceControl true per clonare il controllo del codice sorgente dall'app di origine; in caso contrario, false. bool
configureLoadBalancing true per configurare il bilanciamento del carico per l'app di origine e destinazione. bool
correlationId ID di correlazione dell'operazione di clonazione. Questo ID associa più operazioni di clonazione
insieme per usare lo stesso snapshot.		 string
hostingEnvironment ambiente del servizio app. string
overwrite true per sovrascrivere l'app di destinazione; in caso contrario, false. bool
sourceWebAppId ID risorsa ARM dell'app di origine. ID risorsa app è del modulo
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} per slot di produzione e
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slot/{slotName} per altri slot.		 stringa (obbligatoria)
sourceWebAppLocation Posizione dell'app di origine ex: Stati Uniti occidentali o Europa settentrionale string
trafficManagerProfileId ID risorsa ARM del profilo di Gestione traffico da usare, se presente. ID risorsa di Gestione traffico è del modulo
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.		 string
trafficManagerProfileName Nome del profilo di Gestione traffico da creare. Questa operazione è necessaria solo se il profilo di Gestione traffico non esiste già. string

HostingEnvironmentProfile

Nome Descrizione Valore
id ID risorsa del ambiente del servizio app. string

HostNameSslState

Nome Descrizione Valore
hostType Indica se il nome host è un nome host standard o repository. "Repository"
"Standard"
name Nome host. string
sslState Tipo SSL. "Disabilitato"
"IpBasedEnabled"
"SniEnabled"
thumbprint Identificazione personale del certificato SSL. string
toUpdate Impostare su per true aggiornare il nome host esistente. bool
virtualIP Indirizzo IP virtuale assegnato al nome host se è abilitato SSL basato su IP. string

SiteConfig

Nome Descrizione Valore
acrUseManagedIdentityCreds Contrassegno per l'uso dei cred di identità gestita per il pull del Registro Azure Container bool
acrUserManagedIdentityID Se si usa l'identità gestita dall'utente, clientId dell'identità gestita dall'utente string
Alwayson truese Always On è abilitato; in caso contrario, false. bool
apiDefinition Informazioni sulla definizione dell'API formale per l'app. ApiDefinitionInfo
apiManagementConfig Impostazioni di gestione API di Azure collegate all'app. ApiManagementConfig
appCommandLine Riga di comando dell'app da avviare. string
appSettings Impostazioni delle applicazioni. NameValuePair[]
autoHealEnabled true se Auto Heal è abilitato; in caso contrario, false. bool
autoHealRules Regole di ripristino automatico. AutoHealRules
autoSwapSlotName Nome dello slot di scambio automatico. string
azureStorageAccounts Elenco degli account di archiviazione di Azure. object
connectionStrings Stringhe di connessione. ConnStringInfo[]
CORS Impostazioni CORS (Cross-Origin Resource Sharing). CorsSettings
defaultDocuments Documenti predefiniti. string[]
detailedErrorLoggingEnabled true se la registrazione dettagliata degli errori è abilitata; in caso contrario, false. bool
documentRoot Radice del documento. string
elasticWebAppScaleLimit Numero massimo di lavoratori a cui un sito può aumentare il numero massimo.
Questa impostazione si applica solo alle app nei piani in cui ElasticScaleEnabled è true		 INT
Esperimenti Questo è il problema per i tipi polimorfici. Sperimentazioni
ftpsState Stato del servizio FTP/FTPS "AllAllowed"
"Disabilitato"
"FtpsOnly"
functionAppScaleLimit Numero massimo di ruoli di lavoro a cui un sito può aumentare il numero di istanze.
Questa impostazione si applica solo ai piani Consumo ed Elastic Premium		 INT
functionsRuntimeScaleMonitoringEnabled Ottiene o imposta un valore che indica se il monitoraggio della scalabilità di runtime delle funzioni è abilitato. Se abilitata,
ScaleController non monitorerà direttamente le origini eventi, ma chiamerà invece a
runtime per ottenere lo stato di scalabilità.		 bool
handlerMappings Mapping dei gestori. HandlerMapping[]
healthCheckPath Percorso controllo integrità string
http20Enabled Http20Enabled: configura un sito Web per consentire ai client di connettersi tramite http2.0 bool
httpLoggingEnabled true se la registrazione HTTP è abilitata; in caso contrario, false. bool
ipSecurityRestrictions Restrizioni di sicurezza IP per main. IpSecurityRestriction[]
ipSecurityRestrictionsDefaultAction Azione predefinita per la restrizione di accesso principale se non vengono soddisfatte regole. "Consenti"
"Nega"
javaContainer Contenitore Java. string
javaContainerVersion Versione del contenitore Java. string
javaVersion Versione Java. string
keyVaultReferenceIdentity Identità da usare per l'autenticazione di riferimento Key Vault. string
limiti Limiti del sito. SiteLimits
linuxFxVersion Framework e versione di Linux App Framework string
loadBalancing Bilanciamento del carico del sito. "LeastRequests"
"LeastResponseTime"
"PerSiteRoundRobin"
"RequestHash"
"WeightedRoundRobin"
"WeightedTotalTraffic"
localMySqlEnabled true per abilitare MySQL locale; in caso contrario, false. bool
logsDirectorySizeLimit Limite delle dimensioni della directory dei log HTTP. INT
managedPipelineMode Modalità pipeline gestita. "Classico"
"Integrato"
managedServiceIdentityId ID identità del servizio gestito INT
metadata Metadati dell'applicazione. Questa proprietà non può essere recuperata perché può contenere segreti. NameValuePair[]
minimumElasticInstanceCount Numero di numero minimo di istanze per un sito
Questa impostazione si applica solo ai piani elastici		 INT
minTlsVersion MinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL "1.0"
"1.1"
"1.2"
netFrameworkVersion Versione di .NET Framework. string
nodeVersion Versione di Node.js. string
numberOfWorkers Numero di ruoli di lavoro. INT
phpVersion Versione di PHP. string
powerShellVersion Versione di PowerShell. string
preWarmedInstanceCount Numero di istanze preAvvise.
Questa impostazione si applica solo ai piani elastici e di consumo		 INT
publicNetworkAccess Proprietà per consentire o bloccare tutto il traffico pubblico. string
publishingUsername Pubblicazione del nome utente. string
push Impostazioni dell'endpoint push. PushSettings
PythonVersion Versione di Python. string
remoteDebuggingEnabled true se il debug remoto è abilitato; in caso contrario, false. bool
remoteDebuggingVersion Versione di debug remoto. string
requestTracingEnabled true se la traccia delle richieste è abilitata; in caso contrario, false. bool
requestTracingExpirationTime Data di scadenza della traccia delle richieste. string
scmIpSecurityRestrictions Restrizioni di sicurezza IP per scm. IpSecurityRestriction[]
scmIpSecurityRestrictionsDefaultAction Azione predefinita per la restrizione di accesso scm se non vengono corrispondenti regole. "Consenti"
"Nega"
scmIpSecurityRestrictionsUseMain Restrizioni di sicurezza IP per scm da usare main. bool
scmMinTlsVersion ScmMinTlsVersion: configura la versione minima di TLS necessaria per le richieste SSL per il sito SCM "1.0"
"1.1"
"1.2"
scmType Tipo SCM. "BitbucketGit"
"BitbucketHg"
"CodePlexGit"
"CodePlexHg"
"Dropbox"
"ExternalGit"
"ExternalHg"
"GitHub"
"LocalGit"
"None"
"OneDrive"
"Tfs"
"VSO"
"VSTSRM"
tracingOptions Opzioni di traccia. string
use32BitWorkerProcess true per usare il processo di lavoro a 32 bit; in caso contrario, false. bool
virtualApplications Applicazioni virtuali. VirtualApplication[]
vnetName Rete virtuale nome. string
vnetPrivatePortsCount Numero di porte private assegnate a questa app. Questi verranno assegnati dinamicamente in fase di esecuzione. INT
vnetRouteAllEnabled Rete virtuale Route All abilitato. Ciò causa l'applicazione di tutti i flussi in uscita Rete virtuale gruppi di sicurezza e route definite dall'utente. bool
websiteTimeZone Imposta il fuso orario usato da un sito per la generazione di timestamp. Compatibile con Linux e Windows servizio app. L'impostazione dell'app WEBSITE_TIME_ZONE ha la precedenza su questa configurazione. Per Linux, si prevede che i valori https://www.iana.org/time-zones del database tz (per un riferimento rapido vedere https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Per Windows, si prevede che uno dei fusi orari elencati in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones string
webSocketsEnabled true se WebSocket è abilitato; in caso contrario, false. bool
windowsFxVersion Xenon App Framework e versione string
xManagedServiceIdentityId ID identità del servizio gestito esplicito INT

ApiDefinitionInfo

Nome Descrizione Valore
url URL della definizione dell'API. string

ApiManagementConfig

Nome Descrizione Valore
id APIM-Api Identificatore. string

NameValuePair

Nome Descrizione valore
name Nome coppia. string
Valore Valore di coppia. string

AutoHealRules

Nome Descrizione Valore
Azioni Azioni da eseguire quando viene attivata una regola. AutoHealActions
trigger Condizioni che descrivono quando eseguire le azioni di correzione automatica. AutoHealTriggers

AutoHealActions

Nome Descrizione Valore
actionType Azione predefinita da eseguire. "CustomAction"
"LogEvent"
"Riciclo"
Customaction Azione personalizzata da eseguire. AutoHealCustomAction
minProcessExecutionTime Tempo minimo di esecuzione del processo
prima di eseguire l'azione
 string

AutoHealCustomAction

Nome Descrizione Valore
exe Eseguibile da eseguire. string
parametri Parametri per l'eseguibile. string

AutoHealTriggers

Nome Descrizione Valore
privateBytesInKB Regola basata su byte privati. INT
requests Regola basata sulle richieste totali. RequestsBasedTrigger
slowRequests Regola basata sul tempo di esecuzione della richiesta. SlowRequestsBasedTrigger
slowRequestsWithPath Regola basata su più regole richieste lente con percorso SlowRequestsBasedTrigger[]
statusCodes Regola basata sui codici di stato. StatusCodesBasedTrigger[]
statusCodesRange Regola basata sugli intervalli di codici di stato. StatusCodesRangeBasedTrigger[]

RequestsBasedTrigger

Nome Descrizione Valore
count Numero di richieste. INT
timeInterval Intervallo di tempo. string

SlowRequestsBasedTrigger

Nome Descrizione Valore
count Numero di richieste. INT
path Percorso richiesta. string
timeInterval Intervallo di tempo. string
timeTaken Tempo impiegato. string

StatusCodesBasedTrigger

Nome Descrizione Valore
count Numero di richieste. INT
path Percorso della richiesta string
status Codice stato HTTP. INT
subStatus Stato secondario della richiesta. INT
timeInterval Intervallo di tempo. string
win32Status Codice di errore Win32. INT

StatusCodesRangeBasedTrigger

Nome Descrizione Valore
count Numero di richieste. INT
path string
statusCodes Codice stato HTTP. string
timeInterval Intervallo di tempo. string

ConnStringInfo

Nome Descrizione Valore
connectionString Valore della stringa di connessione. string
name Nome della stringa di connessione. string
type Tipo di database. "ApiHub"
"Custom"
"DocDb"
"EventHub"
"MySql"
"NotificationHub"
"PostgreSQL"
"RedisCache"
"SQLAzure"
"SQLServer"
"ServiceBus"

CorsSettings

Nome Descrizione Valore
allowedOrigins Ottiene o imposta l'elenco di origini che devono essere autorizzate a creare l'origine incrociata
chiama (ad esempio: http://example.com:12345). Usare "*" per consentirli tutti.		 string[]
supportCredentials Ottiene o imposta un valore che indica se le richieste CORS con credenziali sono consentite. Vedere
https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials
per altri dettagli.
 bool

Sperimentazioni

Nome Descrizione Valore
rampUpRules Elenco delle regole di ramp-up. RampUpRule[]

RampUpRule

Nome Descrizione Valore
actionHostName Nome host di uno slot a cui verrà reindirizzato il traffico se si decide. Ad esempio, myapp-stage.azurewebsites.net. string
changeDecisionCallbackUrl L'algoritmo decisionale personalizzato può essere fornito nell'estensione del sito TiPCallback che è possibile specificare l'URL. Vedere Estensione del sito TiPCallback per lo scaffolding e i contratti.
https://www.siteextensions.net/packages/TiPCallback/		 string
changeIntervalInMinutes Specifica l'intervallo in minuti per rivalutare ReroutePercentage. INT
changeStep Nello scenario di aumento automatico questo è il passaggio da cui aggiungere/rimuovere ReroutePercentage fino a raggiungere \nMinReroutePercentage o
MaxReroutePercentage. Le metriche del sito vengono controllate ogni N minuti specificati in ChangeIntervalInMinutes.\nAlgoritmo decisionale personalizzato
può essere fornito nell'estensione del sito TiPCallback che l'URL può essere specificato in ChangeDecisionCallbackUrl.		 INT
maxReroutePercentage Specifica il limite superiore al di sotto del quale rimarrà ReroutePercentage. INT
minReroutePercentage Specifica un limite inferiore al di sopra del quale rimarrà ReroutePercentage. INT
name Nome della regola di routing. Il nome consigliato è puntare allo slot che riceverà il traffico nell'esperimento. string
reroutePercentage Percentuale del traffico che verrà reindirizzato a ActionHostName. INT

HandlerMapping

Nome Descrizione Valore
argomenti Argomenti della riga di comando da passare al processore di script. string
estensione Le richieste con questa estensione verranno gestite usando l'applicazione FastCGI specificata. string
scriptProcessor Percorso assoluto dell'applicazione FastCGI. string

IpSecurityRestriction

Nome Descrizione Valore
azione Consenti o Nega l'accesso per questo intervallo IP. string
description Descrizione della regola di restrizione IP. string
headers Intestazioni delle regole di restrizione IP.
X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples).
La logica corrispondente è ..
- Se la proprietà è null o vuota (impostazione predefinita), sono consentiti tutti gli host(o la mancanza di).
- Un valore viene confrontato usando ordinal-ignore-case (escluso il numero di porta).
- I caratteri jolly del sottodominio sono consentiti, ma non corrispondono al dominio radice. Ad esempio, *.contoso.com corrisponde al sottodominio foo.contoso.com
ma non il dominio radice contoso.com o foo.bar.contoso.com a più livelli
- I nomi host Unicode sono consentiti ma vengono convertiti in Punycode per la corrispondenza.

X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples).
La logica corrispondente è ..
- Se la proprietà è null o vuota (impostazione predefinita), sono consentite eventuali catene inoltrate (o mancanza di).
- Se un indirizzo (escluso il numero di porta) nella catena (delimitato da virgole) corrisponde al CIDR definito dalla proprietà .

X-Azure-FDID e X-FD-HealthProbe.
La logica di corrispondenza è esatta.		 object
IpAddress Indirizzo IP per cui è valida la restrizione di sicurezza.
Può essere in forma di indirizzo ipv4 puro (proprietà SubnetMask obbligatoria) o
Notazione CIDR, ad esempio ipv4/mask (corrispondenza di bit iniziale). Per CIDR,
La proprietà SubnetMask non deve essere specificata.		 string
name Nome della regola di restrizione IP. string
priority Priorità della regola di restrizione IP. INT
Subnetmask Subnet mask per l'intervallo di indirizzi IP per cui la restrizione è valida. string
subnetTrafficTag (interno) Tag del traffico subnet INT
tag Definisce l'oggetto per cui verrà usato questo filtro IP. Si tratta di supportare il filtro IP sui proxy. "Default"
"ServiceTag"
"XffProxy"
vnetSubnetResourceId ID risorsa di rete virtuale string
vnetTrafficTag (interno) Tag del traffico di rete virtuale INT

SiteLimits

Nome Descrizione Valore
maxDiskSizeInMb Utilizzo massimo consentito delle dimensioni del disco in MB. INT
maxMemoryInMb Utilizzo massimo consentito della memoria in MB. INT
maxPercentageCpu Percentuale massima di utilizzo della CPU consentita. INT

PushSettings

Nome Descrizione Valore
kind Tipo di risorsa. string
properties Proprietà specifiche della risorsa PushSettings PushSettingsProperties

PushSettingsProperties

Nome Descrizione Valore
dynamicTagsJson Ottiene o imposta una stringa JSON contenente un elenco di tag dinamici che verranno valutati dalle attestazioni utente nell'endpoint di registrazione push. string
isPushEnabled Ottiene o imposta un flag che indica se l'endpoint push è abilitato. bool (obbligatorio)
tagsRequiringAuth Ottiene o imposta una stringa JSON contenente un elenco di tag che richiedono l'autenticazione utente da usare nell'endpoint di registrazione push.
I tag possono essere costituiti da caratteri alfanumerici e i seguenti:
'_', '@', '#', '.', ':', '-'.
La convalida deve essere eseguita in PushRequestHandler.		 string
tagWhitelistJson Ottiene o imposta una stringa JSON contenente un elenco di tag consentiti per l'uso dall'endpoint di registrazione push. string

VirtualApplication

Nome Descrizione Valore
Physicalpath Percorso fisico. string
preloadEnabled true se il preload è abilitato; in caso contrario, false. bool
virtualDirectories Directory virtuali per l'applicazione virtuale. VirtualDirectory[]
virtualPath Percorso virtuale. string

VirtualDirectory

Nome Descrizione Valore
Physicalpath Percorso fisico. string
virtualPath Percorso dell'applicazione virtuale. string