Condividi tramite


Frontdoor Microsoft.Network 2020-04-01

Definizione di risorsa Bicep

Il tipo di risorsa frontdoor 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.Network/frontDoors, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Network/frontDoors@2020-04-01' = {
  location: 'string'
  name: 'string'
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              privateLinkAlias: 'string'
              privateLinkApprovalMessage: 'string'
              weight: int
            }
          ]
          healthProbeSettings: {
            id: 'string'
          }
          loadBalancingSettings: {
            id: 'string'
          }
        }
      }
    ]
    backendPoolsSettings: {
      enforceCertificateNameCheck: 'string'
      sendRecvTimeoutSeconds: int
    }
    enabledState: 'string'
    friendlyName: 'string'
    frontendEndpoints: [
      {
        id: 'string'
        name: 'string'
        properties: {
          hostName: 'string'
          sessionAffinityEnabledState: 'string'
          sessionAffinityTtlSeconds: int
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
    healthProbeSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          enabledState: 'string'
          healthProbeMethod: 'string'
          intervalInSeconds: int
          path: 'string'
          protocol: 'string'
        }
      }
    ]
    loadBalancingSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          additionalLatencyMilliseconds: int
          sampleSize: int
          successfulSamplesRequired: int
        }
      }
    ]
    routingRules: [
      {
        id: 'string'
        name: 'string'
        properties: {
          acceptedProtocols: [
            'string'
          ]
          enabledState: 'string'
          frontendEndpoints: [
            {
              id: 'string'
            }
          ]
          patternsToMatch: [
            'string'
          ]
          routeConfiguration: {
            @odata.type: 'string'
            // For remaining properties, see RouteConfiguration objects
          }
          rulesEngine: {
            id: 'string'
          }
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Oggetti RouteConfiguration

Impostare la proprietà @odata.type per specificare il tipo di oggetto.

Per #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, usare:

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
  backendPool: {
    id: 'string'
  }
  cacheConfiguration: {
    cacheDuration: 'string'
    dynamicCompression: 'string'
    queryParameters: 'string'
    queryParameterStripDirective: 'string'
  }
  customForwardingPath: 'string'
  forwardingProtocol: 'string'
}

Per #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, usare:

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
  customFragment: 'string'
  customHost: 'string'
  customPath: 'string'
  customQueryString: 'string'
  redirectProtocol: 'string'
  redirectType: 'string'
}

Valori delle proprietà

Back-end

Nome Descrizione Valore
indirizzo Posizione del back-end (indirizzo IP o FQDN) corda
backendHostHeader Valore da usare come intestazione host inviata al back-end. Se vuoto o non specificato, il valore predefinito è l'host in ingresso. corda
enabledState Indica se abilitare l'uso di questo back-end. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
httpPort Numero di porta TCP HTTP. Deve essere compreso tra 1 e 65535. Int

Vincoli:
Valore minimo = 1
Valore massimo = 65535
httpsPort Numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535. Int

Vincoli:
Valore minimo = 1
Valore massimo = 65535
priorità Priorità da usare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro. Int

Vincoli:
Valore minimo = 1
Valore massimo = 5
privateLinkAlias Alias della risorsa collegamento privato. Il popolamento di questo campo facoltativo indica che il back-end è "Privato" corda
privateLinkApprovalMessage Messaggio personalizzato da includere nella richiesta di approvazione per la connessione al collegamento privato corda
peso Peso di questo endpoint a scopo di bilanciamento del carico. Int

Vincoli:
Valore minimo = 1
Valore massimo = 1000

BackendPool

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà del pool back-end frontdoor BackendPoolProperties

BackendPoolProperties

Nome Descrizione Valore
back-end Set di back-end per questo pool back-end[]
healthProbeSettings Impostazioni del probe di integrità L7 per un pool back-end SubResource
loadBalancingSettings Impostazioni di bilanciamento del carico per un pool back-end SubResource

BackendPoolsSettings

Nome Descrizione Valore
enforceCertificateNameCheck Indica se applicare il controllo del nome del certificato alle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS. 'Disabilitato'
'Enabled'
sendRecvTimeoutSeconds Inviare e ricevere il timeout sulla richiesta di inoltro al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce. Int

Vincoli:
Valore minimo = 16

CacheConfiguration

Nome Descrizione Valore
cacheDuration Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP richiede che il valore non sia più di un anno corda
dynamicCompression Indica se usare la compressione dinamica per il contenuto memorizzato nella cache 'Disabilitato'
'Enabled'
queryParameters parametri di query da includere o escludere (delimitati da virgole). corda
queryParameterStripDirective Trattamento dei termini di query URL quando si forma la chiave della cache. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Nome Descrizione Valore
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obbligatorio)
backendPool Riferimento a BackendPool a cui viene instradata questa regola. SubResource
cacheConfiguration Configurazione di memorizzazione nella cache associata a questa regola. CacheConfiguration
customForwardingPath Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso in ingresso. corda
forwardingProtocol Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontdoorProprietà

Nome Descrizione Valore
back-endPools Pool back-end disponibili per le regole di routing. back-endpool[]
backendPoolsSettings Impostazioni per tutti i pool back-end BackendPoolsSettings
enabledState Stato operativo del servizio di bilanciamento del carico di Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
friendlyName Nome descrittivo per frontdoor corda
frontendEndpoints Endpoint front-end disponibili per le regole di routing. frontendEndpoint[]
healthProbeSettings Impostazioni del probe di integrità associate a questa istanza di Frontdoor. HealthProbeSettingsModel[]
loadBalancingSettings Impostazioni di bilanciamento del carico associate a questa istanza di Frontdoor. LoadBalancingSettingsModel[]
routingRules Regole di routing associate a questa frontdoor. RoutingRule[]

Front-endEndpoint

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà dell'endpoint front-end FrontndEndpointProperties

FrontndEndpointProperties

Nome Descrizione Valore
hostName Nome host del front-endEndpoint. Deve essere un nome di dominio. corda
sessionAffinityEnabledState Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
sessionAffinityTtlSeconds INUTILIZZATO. Questo campo verrà ignorato. Durata (TTL) da usare in secondi per l'affinità di sessione, se applicabile. Int
webApplicationFirewallPolicyLink Definisce i criteri web application firewall per ogni host (se applicabile) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrizione Valore
Id ID risorsa. corda

HealthProbeSettingsModel

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà delle impostazioni del probe di integrità HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome Descrizione Valore
enabledState Indica se abilitare i probe di integrità da eseguire su back-end definiti in back-endPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato. 'Disabilitato'
'Enabled'
healthProbeMethod Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools. 'GET'
'HEAD'
intervalInSeconds Numero di secondi tra i probe di integrità. Int
sentiero Percorso da usare per il probe di integrità. Il valore predefinito è / corda
protocollo Schema di protocollo da usare per questo probe 'Http'
'Https'

LoadBalancingSettingsModel

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà delle impostazioni di bilanciamento del carico LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome Descrizione Valore
additionalLatencyMilliseconds Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più bassa Int
sampleSize Numero di campioni da considerare per le decisioni di bilanciamento del carico Int
successfulSamplesRequired Numero di campioni entro il periodo di campionamento che deve avere esito positivo Int

Microsoft.Network/frontdoors

Nome Descrizione Valore
ubicazione Percorso della risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 5
Lunghezza massima = 5
Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obbligatorio)
proprietà Proprietà del servizio di bilanciamento del carico frontdoor FrontDoorProprietà
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

RedirectConfiguration

Nome Descrizione Valore
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio)
customFragment Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #. corda
customHost Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione. corda
customPath Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione. corda
customQueryString Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in <>chiave =<formato> valore. Prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &. corda
redirectProtocol Protocollo della destinazione in cui viene reindirizzato il traffico 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico. 'Trovato'
'Spostato'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Nome Descrizione Valore

RouteConfiguration

Nome Descrizione Valore
@odata.type Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" per il tipo ForwardingConfiguration. Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" per il tipo RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio)

RoutingRule

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà della regola di routing di Frontdoor RoutingRuleProperties

RoutingRuleProperties

Nome Descrizione Valore
acceptedProtocols Schemi di protocollo che corrispondono a questa regola Matrice di stringhe contenente uno dei seguenti elementi:
'Http'
'Https'
enabledState Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
frontendEndpoints Endpoint front-end associati a questa regola SubResource []
patternsToMatch Modelli di route della regola. string[]
routeConfiguration Riferimento alla configurazione di routing. RouteConfiguration
rulesEngine Riferimento a una configurazione specifica del motore regole da applicare a questa route. SubResource
webApplicationFirewallPolicyLink Definisce i criteri web application firewall per ogni regola di routing (se applicabile) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrizione Valore
Id ID risorsa. corda

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
Aggiungere un dominio personalizzato e un certificato personalizzato con Frontdoor Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor con un certificato gestito dal cliente
Aggiungere un dominio personalizzato e un certificato gestito con Frontdoor Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor
controllare i probe di integrità per i back-end in Frontdoor Questo modello aggiorna frontdoor per modificare le impostazioni del probe di integrità impostando il percorso del probe e anche gli intervalli in cui verranno inviati i probe.
Creare una frontdoor di base Questo modello crea una configurazione frontdoor di base con un singolo back-end.
Creare una frontdoor con reindirizzamento DA HTTP a HTTPS Questo modello crea una configurazione di Frontdoor per il reindirizzamento DA HTTP a HTTPS.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa frontdoor 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.Network/frontDoors, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2020-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "privateLinkAlias": "string",
              "privateLinkApprovalMessage": "string",
              "weight": "int"
            }
          ],
          "healthProbeSettings": {
            "id": "string"
          },
          "loadBalancingSettings": {
            "id": "string"
          }
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "string",
      "sendRecvTimeoutSeconds": "int"
    },
    "enabledState": "string",
    "friendlyName": "string",
    "frontendEndpoints": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "hostName": "string",
          "sessionAffinityEnabledState": "string",
          "sessionAffinityTtlSeconds": "int",
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ],
    "healthProbeSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "enabledState": "string",
          "healthProbeMethod": "string",
          "intervalInSeconds": "int",
          "path": "string",
          "protocol": "string"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "additionalLatencyMilliseconds": "int",
          "sampleSize": "int",
          "successfulSamplesRequired": "int"
        }
      }
    ],
    "routingRules": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "acceptedProtocols": [ "string" ],
          "enabledState": "string",
          "frontendEndpoints": [
            {
              "id": "string"
            }
          ],
          "patternsToMatch": [ "string" ],
          "routeConfiguration": {
            "@odata.type": "string"
            // For remaining properties, see RouteConfiguration objects
          },
          "rulesEngine": {
            "id": "string"
          },
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Oggetti RouteConfiguration

Impostare la proprietà @odata.type per specificare il tipo di oggetto.

Per #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, usare:

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
  "backendPool": {
    "id": "string"
  },
  "cacheConfiguration": {
    "cacheDuration": "string",
    "dynamicCompression": "string",
    "queryParameters": "string",
    "queryParameterStripDirective": "string"
  },
  "customForwardingPath": "string",
  "forwardingProtocol": "string"
}

Per #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, usare:

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
  "customFragment": "string",
  "customHost": "string",
  "customPath": "string",
  "customQueryString": "string",
  "redirectProtocol": "string",
  "redirectType": "string"
}

Valori delle proprietà

Back-end

Nome Descrizione Valore
indirizzo Posizione del back-end (indirizzo IP o FQDN) corda
backendHostHeader Valore da usare come intestazione host inviata al back-end. Se vuoto o non specificato, il valore predefinito è l'host in ingresso. corda
enabledState Indica se abilitare l'uso di questo back-end. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
httpPort Numero di porta TCP HTTP. Deve essere compreso tra 1 e 65535. Int

Vincoli:
Valore minimo = 1
Valore massimo = 65535
httpsPort Numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535. Int

Vincoli:
Valore minimo = 1
Valore massimo = 65535
priorità Priorità da usare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro. Int

Vincoli:
Valore minimo = 1
Valore massimo = 5
privateLinkAlias Alias della risorsa collegamento privato. Il popolamento di questo campo facoltativo indica che il back-end è "Privato" corda
privateLinkApprovalMessage Messaggio personalizzato da includere nella richiesta di approvazione per la connessione al collegamento privato corda
peso Peso di questo endpoint a scopo di bilanciamento del carico. Int

Vincoli:
Valore minimo = 1
Valore massimo = 1000

BackendPool

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà del pool back-end frontdoor BackendPoolProperties

BackendPoolProperties

Nome Descrizione Valore
back-end Set di back-end per questo pool back-end[]
healthProbeSettings Impostazioni del probe di integrità L7 per un pool back-end SubResource
loadBalancingSettings Impostazioni di bilanciamento del carico per un pool back-end SubResource

BackendPoolsSettings

Nome Descrizione Valore
enforceCertificateNameCheck Indica se applicare il controllo del nome del certificato alle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS. 'Disabilitato'
'Enabled'
sendRecvTimeoutSeconds Inviare e ricevere il timeout sulla richiesta di inoltro al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce. Int

Vincoli:
Valore minimo = 16

CacheConfiguration

Nome Descrizione Valore
cacheDuration Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP richiede che il valore non sia più di un anno corda
dynamicCompression Indica se usare la compressione dinamica per il contenuto memorizzato nella cache 'Disabilitato'
'Enabled'
queryParameters parametri di query da includere o escludere (delimitati da virgole). corda
queryParameterStripDirective Trattamento dei termini di query URL quando si forma la chiave della cache. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Nome Descrizione Valore
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obbligatorio)
backendPool Riferimento a BackendPool a cui viene instradata questa regola. SubResource
cacheConfiguration Configurazione di memorizzazione nella cache associata a questa regola. CacheConfiguration
customForwardingPath Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso in ingresso. corda
forwardingProtocol Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontdoorProprietà

Nome Descrizione Valore
back-endPools Pool back-end disponibili per le regole di routing. back-endpool[]
backendPoolsSettings Impostazioni per tutti i pool back-end BackendPoolsSettings
enabledState Stato operativo del servizio di bilanciamento del carico di Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
friendlyName Nome descrittivo per frontdoor corda
frontendEndpoints Endpoint front-end disponibili per le regole di routing. frontendEndpoint[]
healthProbeSettings Impostazioni del probe di integrità associate a questa istanza di Frontdoor. HealthProbeSettingsModel[]
loadBalancingSettings Impostazioni di bilanciamento del carico associate a questa istanza di Frontdoor. LoadBalancingSettingsModel[]
routingRules Regole di routing associate a questa frontdoor. RoutingRule[]

Front-endEndpoint

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà dell'endpoint front-end FrontndEndpointProperties

FrontndEndpointProperties

Nome Descrizione Valore
hostName Nome host del front-endEndpoint. Deve essere un nome di dominio. corda
sessionAffinityEnabledState Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
sessionAffinityTtlSeconds INUTILIZZATO. Questo campo verrà ignorato. Durata (TTL) da usare in secondi per l'affinità di sessione, se applicabile. Int
webApplicationFirewallPolicyLink Definisce i criteri web application firewall per ogni host (se applicabile) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrizione Valore
Id ID risorsa. corda

HealthProbeSettingsModel

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà delle impostazioni del probe di integrità HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome Descrizione Valore
enabledState Indica se abilitare i probe di integrità da eseguire su back-end definiti in back-endPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato. 'Disabilitato'
'Enabled'
healthProbeMethod Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools. 'GET'
'HEAD'
intervalInSeconds Numero di secondi tra i probe di integrità. Int
sentiero Percorso da usare per il probe di integrità. Il valore predefinito è / corda
protocollo Schema di protocollo da usare per questo probe 'Http'
'Https'

LoadBalancingSettingsModel

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà delle impostazioni di bilanciamento del carico LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome Descrizione Valore
additionalLatencyMilliseconds Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più bassa Int
sampleSize Numero di campioni da considerare per le decisioni di bilanciamento del carico Int
successfulSamplesRequired Numero di campioni entro il periodo di campionamento che deve avere esito positivo Int

Microsoft.Network/frontdoors

Nome Descrizione Valore
apiVersion Versione dell'API '2020-04-01'
ubicazione Percorso della risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 5
Lunghezza massima = 5
Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obbligatorio)
proprietà Proprietà del servizio di bilanciamento del carico frontdoor FrontDoorProprietà
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Network/frontdoors'

RedirectConfiguration

Nome Descrizione Valore
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio)
customFragment Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #. corda
customHost Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione. corda
customPath Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione. corda
customQueryString Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in <>chiave =<formato> valore. Prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &. corda
redirectProtocol Protocollo della destinazione in cui viene reindirizzato il traffico 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico. 'Trovato'
'Spostato'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Nome Descrizione Valore

RouteConfiguration

Nome Descrizione Valore
@odata.type Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" per il tipo ForwardingConfiguration. Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" per il tipo RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio)

RoutingRule

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà della regola di routing di Frontdoor RoutingRuleProperties

RoutingRuleProperties

Nome Descrizione Valore
acceptedProtocols Schemi di protocollo che corrispondono a questa regola Matrice di stringhe contenente uno dei seguenti elementi:
'Http'
'Https'
enabledState Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
frontendEndpoints Endpoint front-end associati a questa regola SubResource []
patternsToMatch Modelli di route della regola. string[]
routeConfiguration Riferimento alla configurazione di routing. RouteConfiguration
rulesEngine Riferimento a una configurazione specifica del motore regole da applicare a questa route. SubResource
webApplicationFirewallPolicyLink Definisce i criteri web application firewall per ogni regola di routing (se applicabile) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrizione Valore
Id ID risorsa. corda

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

Modelli di avvio rapido

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

Sagoma Descrizione
Aggiungere un dominio personalizzato e un certificato personalizzato con Frontdoor

Distribuire in Azure
Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor con un certificato gestito dal cliente
Aggiungere un dominio personalizzato e un certificato gestito con Frontdoor

Distribuire in Azure
Questo modello esegue l'onboarding e protegge un dominio personalizzato con Frontdoor
Configurare l'affinità di sessione per i nomi host di Frontdoor

Distribuire in Azure
Questo modello aggiorna una frontdoor per abilitare l'affinità di sessione per l'host front-end, inviando così il traffico successivo dalla stessa sessione utente allo stesso back-end.
controllare i probe di integrità per i back-end in Frontdoor

Distribuire in Azure
Questo modello aggiorna frontdoor per modificare le impostazioni del probe di integrità impostando il percorso del probe e anche gli intervalli in cui verranno inviati i probe.
Creare una frontdoor di base

Distribuire in Azure
Questo modello crea una configurazione frontdoor di base con un singolo back-end.
Creare una frontdoor con reindirizzamento DA HTTP a HTTPS

Distribuire in Azure
Questo modello crea una configurazione di Frontdoor per il reindirizzamento DA HTTP a HTTPS.
Creare una frontdoor con più back-end e pool back-end

Distribuire in Azure
Questo modello crea una frontdoor con bilanciamento del carico configurato per più back-end in un pool back-end e anche tra pool back-end in base al percorso URL.
Creare frontdoor di Azure davanti a Gestione API di Azure

Distribuire in Azure
Questo esempio illustra come usare Frontdoor di Azure come servizio di bilanciamento del carico globale davanti a Gestione API di Azure.
Creare Frontdoor con Active-Standby config

Distribuire in Azure
Questo modello crea una frontdoor che illustra il routing basato sulla priorità per Active-Standby topologia dell'applicazione.
Creare Frontdoor con memorizzazione nella cache abilitata per determinate route

Distribuire in Azure
Questo modello crea una frontdoor con memorizzazione nella cache abilitata per la configurazione di routing definita, memorizzando nella cache tutti gli asset statici per il carico di lavoro.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa frontdoor 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 risorsa

Per creare una risorsa Microsoft.Network/frontDoors, aggiungere il comando Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2020-04-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                privateLinkAlias = "string"
                privateLinkApprovalMessage = "string"
                weight = int
              }
            ]
            healthProbeSettings = {
              id = "string"
            }
            loadBalancingSettings = {
              id = "string"
            }
          }
        }
      ]
      backendPoolsSettings = {
        enforceCertificateNameCheck = "string"
        sendRecvTimeoutSeconds = int
      }
      enabledState = "string"
      friendlyName = "string"
      frontendEndpoints = [
        {
          id = "string"
          name = "string"
          properties = {
            hostName = "string"
            sessionAffinityEnabledState = "string"
            sessionAffinityTtlSeconds = int
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
      healthProbeSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            enabledState = "string"
            healthProbeMethod = "string"
            intervalInSeconds = int
            path = "string"
            protocol = "string"
          }
        }
      ]
      loadBalancingSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            additionalLatencyMilliseconds = int
            sampleSize = int
            successfulSamplesRequired = int
          }
        }
      ]
      routingRules = [
        {
          id = "string"
          name = "string"
          properties = {
            acceptedProtocols = [
              "string"
            ]
            enabledState = "string"
            frontendEndpoints = [
              {
                id = "string"
              }
            ]
            patternsToMatch = [
              "string"
            ]
            routeConfiguration = {
              @odata.type = "string"
              // For remaining properties, see RouteConfiguration objects
            }
            rulesEngine = {
              id = "string"
            }
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
    }
  })
}

Oggetti RouteConfiguration

Impostare la proprietà @odata.type per specificare il tipo di oggetto.

Per #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, usare:

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
  backendPool = {
    id = "string"
  }
  cacheConfiguration = {
    cacheDuration = "string"
    dynamicCompression = "string"
    queryParameters = "string"
    queryParameterStripDirective = "string"
  }
  customForwardingPath = "string"
  forwardingProtocol = "string"
}

Per #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, usare:

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
  customFragment = "string"
  customHost = "string"
  customPath = "string"
  customQueryString = "string"
  redirectProtocol = "string"
  redirectType = "string"
}

Valori delle proprietà

Back-end

Nome Descrizione Valore
indirizzo Posizione del back-end (indirizzo IP o FQDN) corda
backendHostHeader Valore da usare come intestazione host inviata al back-end. Se vuoto o non specificato, il valore predefinito è l'host in ingresso. corda
enabledState Indica se abilitare l'uso di questo back-end. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
httpPort Numero di porta TCP HTTP. Deve essere compreso tra 1 e 65535. Int

Vincoli:
Valore minimo = 1
Valore massimo = 65535
httpsPort Numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535. Int

Vincoli:
Valore minimo = 1
Valore massimo = 65535
priorità Priorità da usare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro. Int

Vincoli:
Valore minimo = 1
Valore massimo = 5
privateLinkAlias Alias della risorsa collegamento privato. Il popolamento di questo campo facoltativo indica che il back-end è "Privato" corda
privateLinkApprovalMessage Messaggio personalizzato da includere nella richiesta di approvazione per la connessione al collegamento privato corda
peso Peso di questo endpoint a scopo di bilanciamento del carico. Int

Vincoli:
Valore minimo = 1
Valore massimo = 1000

BackendPool

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà del pool back-end frontdoor BackendPoolProperties

BackendPoolProperties

Nome Descrizione Valore
back-end Set di back-end per questo pool back-end[]
healthProbeSettings Impostazioni del probe di integrità L7 per un pool back-end SubResource
loadBalancingSettings Impostazioni di bilanciamento del carico per un pool back-end SubResource

BackendPoolsSettings

Nome Descrizione Valore
enforceCertificateNameCheck Indica se applicare il controllo del nome del certificato alle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS. 'Disabilitato'
'Enabled'
sendRecvTimeoutSeconds Inviare e ricevere il timeout sulla richiesta di inoltro al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce. Int

Vincoli:
Valore minimo = 16

CacheConfiguration

Nome Descrizione Valore
cacheDuration Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP richiede che il valore non sia più di un anno corda
dynamicCompression Indica se usare la compressione dinamica per il contenuto memorizzato nella cache 'Disabilitato'
'Enabled'
queryParameters parametri di query da includere o escludere (delimitati da virgole). corda
queryParameterStripDirective Trattamento dei termini di query URL quando si forma la chiave della cache. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Nome Descrizione Valore
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obbligatorio)
backendPool Riferimento a BackendPool a cui viene instradata questa regola. SubResource
cacheConfiguration Configurazione di memorizzazione nella cache associata a questa regola. CacheConfiguration
customForwardingPath Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso in ingresso. corda
forwardingProtocol Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontdoorProprietà

Nome Descrizione Valore
back-endPools Pool back-end disponibili per le regole di routing. back-endpool[]
backendPoolsSettings Impostazioni per tutti i pool back-end BackendPoolsSettings
enabledState Stato operativo del servizio di bilanciamento del carico di Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
friendlyName Nome descrittivo per frontdoor corda
frontendEndpoints Endpoint front-end disponibili per le regole di routing. frontendEndpoint[]
healthProbeSettings Impostazioni del probe di integrità associate a questa istanza di Frontdoor. HealthProbeSettingsModel[]
loadBalancingSettings Impostazioni di bilanciamento del carico associate a questa istanza di Frontdoor. LoadBalancingSettingsModel[]
routingRules Regole di routing associate a questa frontdoor. RoutingRule[]

Front-endEndpoint

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà dell'endpoint front-end FrontndEndpointProperties

FrontndEndpointProperties

Nome Descrizione Valore
hostName Nome host del front-endEndpoint. Deve essere un nome di dominio. corda
sessionAffinityEnabledState Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
sessionAffinityTtlSeconds INUTILIZZATO. Questo campo verrà ignorato. Durata (TTL) da usare in secondi per l'affinità di sessione, se applicabile. Int
webApplicationFirewallPolicyLink Definisce i criteri web application firewall per ogni host (se applicabile) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrizione Valore
Id ID risorsa. corda

HealthProbeSettingsModel

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà delle impostazioni del probe di integrità HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nome Descrizione Valore
enabledState Indica se abilitare i probe di integrità da eseguire su back-end definiti in back-endPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato. 'Disabilitato'
'Enabled'
healthProbeMethod Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools. 'GET'
'HEAD'
intervalInSeconds Numero di secondi tra i probe di integrità. Int
sentiero Percorso da usare per il probe di integrità. Il valore predefinito è / corda
protocollo Schema di protocollo da usare per questo probe 'Http'
'Https'

LoadBalancingSettingsModel

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà delle impostazioni di bilanciamento del carico LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nome Descrizione Valore
additionalLatencyMilliseconds Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più bassa Int
sampleSize Numero di campioni da considerare per le decisioni di bilanciamento del carico Int
successfulSamplesRequired Numero di campioni entro il periodo di campionamento che deve avere esito positivo Int

Microsoft.Network/frontdoors

Nome Descrizione Valore
ubicazione Percorso della risorsa. corda
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 5
Lunghezza massima = 5
Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (obbligatorio)
proprietà Proprietà del servizio di bilanciamento del carico frontdoor FrontDoorProprietà
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Network/frontDoors@2020-04-01"

RedirectConfiguration

Nome Descrizione Valore
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio)
customFragment Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #. corda
customHost Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione. corda
customPath Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione. corda
customQueryString Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in <>chiave =<formato> valore. Prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &. corda
redirectProtocol Protocollo della destinazione in cui viene reindirizzato il traffico 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico. 'Trovato'
'Spostato'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Nome Descrizione Valore

RouteConfiguration

Nome Descrizione Valore
@odata.type Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" per il tipo ForwardingConfiguration. Impostare su "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" per il tipo RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (obbligatorio)

RoutingRule

Nome Descrizione Valore
Id ID risorsa. corda
nome Nome risorsa. corda
proprietà Proprietà della regola di routing di Frontdoor RoutingRuleProperties

RoutingRuleProperties

Nome Descrizione Valore
acceptedProtocols Schemi di protocollo che corrispondono a questa regola Matrice di stringhe contenente uno dei seguenti elementi:
'Http'
'Https'
enabledState Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled' 'Disabilitato'
'Enabled'
frontendEndpoints Endpoint front-end associati a questa regola SubResource []
patternsToMatch Modelli di route della regola. string[]
routeConfiguration Riferimento alla configurazione di routing. RouteConfiguration
rulesEngine Riferimento a una configurazione specifica del motore regole da applicare a questa route. SubResource
webApplicationFirewallPolicyLink Definisce i criteri web application firewall per ogni regola di routing (se applicabile) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Nome Descrizione Valore
Id ID risorsa. corda

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda