Microsoft.Web sites/config 2019-08-01

Articolo
02/23/2025

Definizione di risorsa Bicep

Il tipo di risorsa sites/config può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

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

Formato risorsa

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

resource symbolicname 'Microsoft.Web/sites/config@2019-08-01' = {
  name: 'string'
  // For remaining properties, see microsoft.web/sites/config objects
}

oggetti microsoft.web/sites/config

Impostare la proprietà nome per specificare il tipo di oggetto.

Per appsettings, usare:

{
  kind: 'string'
  name: 'appsettings'
  properties: {
    {customized property}: 'string'
  }
}

Per authsettings, usare:

{
  kind: 'string'
  name: 'authsettings'
  properties: {
    additionalLoginParams: [
      'string'
    ]
    allowedAudiences: [
      'string'
    ]
    allowedExternalRedirectUrls: [
      'string'
    ]
    clientId: 'string'
    clientSecret: 'string'
    clientSecretCertificateThumbprint: 'string'
    defaultProvider: 'string'
    enabled: bool
    facebookAppId: 'string'
    facebookAppSecret: 'string'
    facebookOAuthScopes: [
      'string'
    ]
    googleClientId: 'string'
    googleClientSecret: 'string'
    googleOAuthScopes: [
      'string'
    ]
    issuer: 'string'
    microsoftAccountClientId: 'string'
    microsoftAccountClientSecret: 'string'
    microsoftAccountOAuthScopes: [
      'string'
    ]
    runtimeVersion: 'string'
    tokenRefreshExtensionHours: int
    tokenStoreEnabled: bool
    twitterConsumerKey: 'string'
    twitterConsumerSecret: 'string'
    unauthenticatedClientAction: 'string'
    validateIssuer: bool
  }
}

Per azurestorageaccounts, usare:

{
  kind: 'string'
  name: 'azurestorageaccounts'
  properties: {
    {customized property}: {
      accessKey: 'string'
      accountName: 'string'
      mountPath: 'string'
      shareName: 'string'
      type: 'string'
    }
  }
}

Per backup, usare:

{
  kind: 'string'
  name: 'backup'
  properties: {
    backupName: 'string'
    backupSchedule: {
      frequencyInterval: int
      frequencyUnit: 'string'
      keepAtLeastOneBackup: bool
      retentionPeriodInDays: int
      startTime: 'string'
    }
    databases: [
      {
        connectionString: 'string'
        connectionStringName: 'string'
        databaseType: 'string'
        name: 'string'
      }
    ]
    enabled: bool
    storageAccountUrl: 'string'
  }
}

Per connectionstrings, usare:

{
  kind: 'string'
  name: 'connectionstrings'
  properties: {
    {customized property}: {
      type: 'string'
      value: 'string'
    }
  }
}

Per i log , usare:

{
  kind: 'string'
  name: 'logs'
  properties: {
    applicationLogs: {
      azureBlobStorage: {
        level: 'string'
        retentionInDays: int
        sasUrl: 'string'
      }
      azureTableStorage: {
        level: 'string'
        sasUrl: 'string'
      }
      fileSystem: {
        level: 'string'
      }
    }
    detailedErrorMessages: {
      enabled: bool
    }
    failedRequestsTracing: {
      enabled: bool
    }
    httpLogs: {
      azureBlobStorage: {
        enabled: bool
        retentionInDays: int
        sasUrl: 'string'
      }
      fileSystem: {
        enabled: bool
        retentionInDays: int
        retentionInMb: int
      }
    }
  }
}

Per metadati, usare:

{
  kind: 'string'
  name: 'metadata'
  properties: {
    {customized property}: 'string'
  }
}

Per pushsettings, usare:

{
  kind: 'string'
  name: 'pushsettings'
  properties: {
    dynamicTagsJson: 'string'
    isPushEnabled: bool
    tagsRequiringAuth: 'string'
    tagWhitelistJson: 'string'
  }
}

Per slotConfigNames, usare:

{
  kind: 'string'
  name: 'slotConfigNames'
  properties: {
    appSettingNames: [
      'string'
    ]
    azureStorageConfigNames: [
      'string'
    ]
    connectionStringNames: [
      'string'
    ]
  }
}

Per Web, usare:

{
  kind: 'string'
  name: 'web'
  properties: {
    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
          timeInterval: 'string'
          timeTaken: 'string'
        }
        statusCodes: [
          {
            count: int
            status: int
            subStatus: int
            timeInterval: 'string'
            win32Status: int
          }
        ]
      }
    }
    autoSwapSlotName: 'string'
    connectionStrings: [
      {
        connectionString: 'string'
        name: 'string'
        type: 'string'
      }
    ]
    cors: {
      allowedOrigins: [
        'string'
      ]
      supportCredentials: bool
    }
    defaultDocuments: [
      'string'
    ]
    detailedErrorLoggingEnabled: bool
    documentRoot: 'string'
    experiments: {
      rampUpRules: [
        {
          actionHostName: 'string'
          changeDecisionCallbackUrl: 'string'
          changeIntervalInMinutes: int
          changeStep: int
          maxReroutePercentage: int
          minReroutePercentage: int
          name: 'string'
          reroutePercentage: int
        }
      ]
    }
    ftpsState: 'string'
    handlerMappings: [
      {
        arguments: 'string'
        extension: 'string'
        scriptProcessor: 'string'
      }
    ]
    healthCheckPath: 'string'
    http20Enabled: bool
    httpLoggingEnabled: bool
    ipSecurityRestrictions: [
      {
        action: 'string'
        description: 'string'
        ipAddress: 'string'
        name: 'string'
        priority: int
        subnetMask: 'string'
        subnetTrafficTag: int
        tag: 'string'
        vnetSubnetResourceId: 'string'
        vnetTrafficTag: int
      }
    ]
    javaContainer: 'string'
    javaContainerVersion: 'string'
    javaVersion: 'string'
    limits: {
      maxDiskSizeInMb: int
      maxMemoryInMb: int
      maxPercentageCpu: int
    }
    linuxFxVersion: 'string'
    loadBalancing: 'string'
    localMySqlEnabled: bool
    logsDirectorySizeLimit: int
    managedPipelineMode: 'string'
    managedServiceIdentityId: int
    minTlsVersion: 'string'
    netFrameworkVersion: 'string'
    nodeVersion: 'string'
    numberOfWorkers: int
    phpVersion: 'string'
    powerShellVersion: 'string'
    preWarmedInstanceCount: int
    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'
        ipAddress: 'string'
        name: 'string'
        priority: int
        subnetMask: 'string'
        subnetTrafficTag: int
        tag: 'string'
        vnetSubnetResourceId: 'string'
        vnetTrafficTag: int
      }
    ]
    scmIpSecurityRestrictionsUseMain: bool
    scmType: 'string'
    tracingOptions: 'string'
    use32BitWorkerProcess: bool
    virtualApplications: [
      {
        physicalPath: 'string'
        preloadEnabled: bool
        virtualDirectories: [
          {
            physicalPath: 'string'
            virtualPath: 'string'
          }
        ]
        virtualPath: 'string'
      }
    ]
    vnetName: 'string'
    webSocketsEnabled: bool
    windowsFxVersion: 'string'
    xManagedServiceIdentityId: int
  }
}

Valori delle proprietà

ApiDefinitionInfo

Nome	Descrizione	Valore
URL	URL della definizione dell'API.	corda

ApiManagementConfig

Nome	Descrizione	Valore
Id	identificatore APIM-Api.	corda

ApplicationLogsConfig

Nome	Descrizione	Valore
azureBlobStorage	Log dell'applicazione nella configurazione dell'archiviazione BLOB.	AzureBlobStorageApplicationLogsConfig
azureTableStorage	Log dell'applicazione nella configurazione dell'archiviazione tabelle di Azure.	azureTableStorageApplicationLogsConfig
fileSystem	Log dell'applicazione nella configurazione del file system.	FileSystemApplicationLogsConfig

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 intraprendere l'azione	corda

AutoHealCustomAction

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

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

AutoHealTriggers

Nome	Descrizione	Valore
privateBytesInKB	Regola basata su byte privati.	Int
Richieste	Regola basata sulle richieste totali.	RequestsBasedTrigger
slowRequests	Regola basata sul tempo di esecuzione della richiesta.	SlowRequestsBasedTrigger
statusCodes	Regola basata sui codici di stato.	StatusCodesBasedTrigger[]

AzureBlobStorageApplicationLogsConfig

Nome	Descrizione	Valore
livello	Livello di log.	'Error' 'Information' 'Off' 'Verbose' 'Avviso'
retentionInDays	Conservazione in giorni. Rimuovere i BLOB precedenti a X giorni. 0 o inferiore indica che non è prevista alcuna conservazione.	Int
sasUrl	URL di firma di accesso condiviso a un contenitore BLOB di Azure con autorizzazioni di lettura/scrittura/elenco/eliminazione.	corda

AzureBlobStorageHttpLogsConfig

Nome	Descrizione	Valore
Abilitato	True se la configurazione è abilitata, false se è disabilitata e null se la configurazione non è impostata.	Bool
retentionInDays	Conservazione in giorni. Rimuovere i BLOB precedenti a X giorni. 0 o inferiore indica che non è prevista alcuna conservazione.	Int
sasUrl	URL di firma di accesso condiviso a un contenitore BLOB di Azure con autorizzazioni di lettura/scrittura/elenco/eliminazione.	corda

AzureStorageInfoValue

Nome	Descrizione	Valore
accessKey	Chiave di accesso per l'account di archiviazione.	corda
accountName	Nome dell'account di archiviazione.	corda
mountPath	Percorso per montare l'archiviazione all'interno dell'ambiente di runtime del sito.	corda
shareName	Nome della condivisione file (nome del contenitore, per l'archiviazione BLOB).	corda
digitare	Tipo di archiviazione.	'AzureBlob' 'AzureFiles'

AzureStoragePropertyDictionaryResourceProperties

Nome	Descrizione	Valore

AzureTableStorageApplicationLogsConfig

Nome	Descrizione	Valore
livello	Livello di log.	'Error' 'Information' 'Off' 'Verbose' 'Avviso'
sasUrl	URL di firma di accesso condiviso a una tabella di Azure con autorizzazioni di aggiunta/query/eliminazione.	stringa (obbligatorio)

BackupRequestProperties

Nome	Descrizione	Valore
backupName	Nome del backup.	corda
backupSchedule	Pianificare il backup se viene eseguito periodicamente.	BackupSchedule
banche dati	Database inclusi nel backup.	DatabaseBackupSetting[]
Abilitato	True se la pianificazione del backup è abilitata (deve essere inclusa in questo caso), false se la pianificazione del backup deve essere disabilitata.	Bool
storageAccountUrl	URL di firma di accesso condiviso al contenitore.	stringa (obbligatorio)

BackupSchedule

Nome	Descrizione	Valore
frequencyInterval	Frequenza con cui deve essere eseguito il backup (ad esempio, per il backup settimanale, deve essere impostato su 7 e FrequencyUnit deve essere impostato su Giorno)	int (obbligatorio)
frequencyUnit	Unità di tempo per la frequenza con cui deve essere eseguito il backup (ad esempio, per il backup settimanale, deve essere impostato su Day e FrequencyInterval deve essere impostato su 7)	'Day' 'Hour' (obbligatorio)
keepAtLeastOneBackup	True se i criteri di conservazione devono sempre mantenere almeno un backup nell'account di archiviazione, indipendentemente dalla data in cui è; false in caso contrario.	bool (obbligatorio)
retentionPeriodInDays	Dopo quanti giorni devono essere eliminati i backup.	int (obbligatorio)
startTime	Quando la pianificazione deve iniziare a funzionare.	corda

ConnectionStringDictionaryProperties

Nome	Descrizione	Valore

ConnStringInfo

Nome	Descrizione	Valore
connectionString	Valore della stringa di connessione.	corda
nome	Nome della stringa di connessione.	corda
digitare	Tipo di database.	'ApiHub' 'Custom' 'DocDb' 'EventHub' 'MySql' 'NotificationHub' 'PostgreSQL' 'RedisCache' 'ServiceBus' 'SQLAzure' 'SQLServer'

ConnStringValueTypePair

Nome	Descrizione	Valore
digitare	Tipo di database.	'ApiHub' 'Custom' 'DocDb' 'EventHub' 'MySql' 'NotificationHub' 'PostgreSQL' 'RedisCache' 'ServiceBus' 'SQLAzure' 'SQLServer' (obbligatorio)
valore	Valore della coppia.	stringa (obbligatorio)

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 consentire tutto.	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

DatabaseBackupSetting

Nome	Descrizione	Valore
connectionString	Contiene una stringa di connessione a un database di cui viene eseguito il backup o il ripristino. Se il ripristino dovrebbe verificarsi in un nuovo database, il nome del database all'interno è quello nuovo.	corda
connectionStringName	Contiene un nome di stringa di connessione collegato a SiteConfig.ConnectionStrings. Viene usato durante il ripristino con le opzioni sovrascrivere le stringhe di connessione.	corda
databaseType	Tipo di database (ad esempio SqlAzure/MySql).	'LocalMySql' 'MySql' 'PostgreSql' 'SqlAzure' (obbligatorio)
nome		corda

EnabledConfig

Nome	Descrizione	Valore
Abilitato	True se la configurazione è abilitata, false se è disabilitata e null se la configurazione non è impostata.	Bool

Esperimenti

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

FileSystemApplicationLogsConfig

Nome	Descrizione	Valore
livello	Livello di log.	'Error' 'Information' 'Off' 'Verbose' 'Avviso'

FileSystemHttpLogsConfig

Nome	Descrizione	Valore
Abilitato	True se la configurazione è abilitata, false se è disabilitata e null se la configurazione non è impostata.	Bool
retentionInDays	Conservazione in giorni. Rimuovere i file precedenti a X giorni. 0 o inferiore indica che non è prevista alcuna conservazione.	Int
retentionInMb	Dimensioni massime in megabyte che possono essere usati dai file di log HTTP. Quando vengono raggiunti i file di log precedenti, verrà rimosso per creare spazio per quelli nuovi. Il valore può variare tra 25 e 100.	Int Vincoli: Valore minimo = 25 Valore massimo = 100

HandlerMapping

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

HttpLogsConfig

Nome	Descrizione	Valore
azureBlobStorage	Log HTTP per la configurazione dell'archiviazione BLOB di Azure.	azureBlobStorageHttpLogsConfig
fileSystem	Log HTTP per la configurazione del file system.	FileSystemHttpLogsConfig

IpSecurityRestriction

Nome	Descrizione	Valore
azione	Consentire o negare l'accesso per questo intervallo IP.	corda
descrizione	Descrizione della regola di restrizione IP.	corda
ipAddress	Indirizzo IP per cui la restrizione di sicurezza è valida. Può essere in forma di indirizzo ipv4 puro (proprietà SubnetMask obbligatoria) o Notazione CIDR, ad esempio ipv4/mask (corrispondenza bit iniziale). Per CIDR, Non è necessario specificare la proprietà SubnetMask.	corda
nome	Nome della regola di restrizione IP.	corda
priorità	Priorità della regola di restrizione IP.	Int
subnetMask	Subnet mask per l'intervallo di indirizzi IP per cui la restrizione è valida.	corda
subnetTrafficTag	(interno) Tag del traffico subnet	Int
cartellino	Definisce l'oggetto per cui verrà usato questo filtro IP. Si tratta di supportare il filtro IP sui proxy.	'Default' 'XffProxy'
vnetSubnetResourceId	ID risorsa di rete virtuale	corda
vnetTrafficTag	(interno) Tag del traffico della rete virtuale	Int