Delen via


Microsoft.Network frontDoors 2020-01-01

Bicep-resourcedefinitie

Het resourcetype frontDoors kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Network/frontDoors-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Network/frontDoors@2020-01-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'
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

RouteConfiguration-objecten

Stel de eigenschap @odata.type in om het type object op te geven.

Gebruik voor #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration:

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

Gebruik voor #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration:

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

Eigenschapswaarden

Back-end

Naam Beschrijving Waarde
adres Locatie van de back-end (IP-adres of FQDN) snaar
backendHostHeader De waarde die moet worden gebruikt als de hostheader die naar de back-end wordt verzonden. Als dit leeg of niet is opgegeven, wordt deze standaard ingesteld op de binnenkomende host. snaar
enabledState Of u dit gebruik van deze back-end wilt inschakelen. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
httpPort Het HTTP TCP-poortnummer. Moet tussen 1 en 65535 zijn. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
httpsPort Het HTTPS TCP-poortnummer. Moet tussen 1 en 65535 zijn. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
voorrang Prioriteit die moet worden gebruikt voor taakverdeling. Hogere prioriteiten worden niet gebruikt voor taakverdeling als een back-end met een lagere prioriteit in orde is. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 5
privateLinkAlias De alias van de Private Link-resource. Als u dit optionele veld invult, geeft u aan dat deze back-end privé is snaar
privateLinkApprovalMessage Een aangepast bericht dat moet worden opgenomen in de goedkeuringsaanvraag om verbinding te maken met de Private Link snaar
gewicht Gewicht van dit eindpunt voor taakverdelingsdoeleinden. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 1000

Back-endpool

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de Front Door-back-endpool BackendPoolProperties-

BackendPoolProperties

Naam Beschrijving Waarde
back-ends De set back-ends voor deze pool back-end[]
healthProbeSettings L7-statustestinstellingen voor een back-endpool SubResource-
loadBalancingSettings Taakverdelingsinstellingen voor een back-endpool SubResource-

BackendPoolsSettings

Naam Beschrijving Waarde
enforceCertificateNameCheck Of de certificaatnaam moet worden gecontroleerd op HTTPS-aanvragen voor alle back-endpools. Geen effect op niet-HTTPS-aanvragen. 'Uitgeschakeld'
'Ingeschakeld'
sendRecvTimeoutSeconds Time-out verzenden en ontvangen bij het doorsturen van een aanvraag naar de back-end. Wanneer de time-out is bereikt, mislukt de aanvraag en retourneert deze. Int

Beperkingen:
Minimumwaarde = 16

CacheConfiguration

Naam Beschrijving Waarde
cacheDuration De duur waarvoor de inhoud in de cache moet worden opgeslagen. Toegestane indeling heeft een ISO 8601-indeling (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP vereist dat de waarde niet langer dan een jaar is snaar
dynamicCompression Of dynamische compressie moet worden gebruikt voor inhoud in de cache 'Uitgeschakeld'
'Ingeschakeld'
queryParameters queryparameters die moeten worden opgenomen of uitgesloten (door komma's gescheiden). snaar
queryParameterStripDirective Behandeling van URL-querytermen bij het vormen van de cachesleutel. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Naam Beschrijving Waarde
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (vereist)
backendPool Een verwijzing naar de BackendPool waarnaar deze regel wordt gerouteerd. SubResource-
cacheConfiguration De cacheconfiguratie die aan deze regel is gekoppeld. CacheConfiguration-
customForwardingPath Een aangepast pad dat wordt gebruikt om resourcepaden te herschrijven die overeenkomen met deze regel. Laat leeg om het binnenkomende pad te gebruiken. snaar
forwardingProtocol Protocol dat door deze regel wordt gebruikt bij het doorsturen van verkeer naar back-ends. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontDoorProperties

Naam Beschrijving Waarde
backendPools Back-endpools die beschikbaar zijn voor routeringsregels. BackendPool[]
backendPoolsSettings Instellingen voor alle back-endpools BackendPoolsSettings-
enabledState Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
friendlyName Een beschrijvende naam voor de frontDoor snaar
frontendEndpoints Front-endeindpunten die beschikbaar zijn voor routeringsregels. FrontendEndpoint[]
healthProbeSettings Statustestinstellingen die zijn gekoppeld aan dit Front Door-exemplaar. HealthProbeSettingsModel[]
loadBalancingSettings Taakverdelingsinstellingen die zijn gekoppeld aan dit Front Door-exemplaar. LoadBalancingSettingsModel[]
routingRules Routeringsregels die aan deze Front Door zijn gekoppeld. RoutingRule[]

FrontendEndpoint

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van het front-endeindpunt FrontendEndpointProperties-

FrontendEndpointProperties

Naam Beschrijving Waarde
hostName De hostnaam van het frontendEndpoint. Moet een domeinnaam zijn. snaar
sessionAffinityEnabledState Of sessieaffiniteit op deze host moet worden toegestaan. Geldige opties zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
sessionAffinityTtlSeconds ONGEBRUIKT. Dit veld wordt genegeerd. De TTL die in seconden moet worden gebruikt voor sessieaffiniteit, indien van toepassing. Int
webApplicationFirewallPolicyLink Definieert het Web Application Firewall-beleid voor elke host (indien van toepassing) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar

HealthProbeSettingsModel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de statustestinstellingen HealthProbeSettingsProperties-

HealthProbeSettingsProperties

Naam Beschrijving Waarde
enabledState Of statustests moeten worden uitgevoerd op basis van back-ends die zijn gedefinieerd onder backendPools. Statustests kunnen alleen worden uitgeschakeld als er één back-end is ingeschakeld in een back-endpool met één ingeschakelde back-end. 'Uitgeschakeld'
'Ingeschakeld'
healthProbeMethod Hiermee configureert u welke HTTP-methode moet worden gebruikt om de back-ends te testen die zijn gedefinieerd onder backendPools. 'GET'
'HEAD'
intervalInSeconds Het aantal seconden tussen statustests. Int
pad Het pad dat moet worden gebruikt voor de statustest. Standaard is/ snaar
protocol Protocolschema dat moet worden gebruikt voor deze test 'Http'
'Https'

LoadBalancingSettingsModel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de taakverdelingsinstellingen LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Naam Beschrijving Waarde
additionalLatencyMilliseconds De extra latentie in milliseconden voor tests die in de laagste latentiebucket vallen Int
sampleSize Het aantal voorbeelden dat moet worden overwogen voor taakverdelingsbeslissingen Int
successfulSamplesRequired Het aantal steekproeven binnen de steekproefperiode die moet slagen Int

Microsoft.Network/frontDoors

Naam Beschrijving Waarde
plaats Resourcelocatie. snaar
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 5
Patroon = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (vereist)
Eigenschappen Eigenschappen van de Front Door Load Balancer FrontDoorProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

RedirectConfiguration

Naam Beschrijving Waarde
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (vereist)
customFragment Fragment dat moet worden toegevoegd aan de omleidings-URL. Fragment is het deel van de URL die na #komt. Neem het #-bestand niet op. snaar
customHost Host om te leiden. Laat leeg om de binnenkomende host als doelhost te gebruiken. snaar
customPath Het volledige pad om om te leiden. Pad mag niet leeg zijn en moet beginnen met /. Laat leeg om het binnenkomende pad als doelpad te gebruiken. snaar
customQueryString De set queryreeksen die in de omleidings-URL moeten worden geplaatst. Als u deze waarde instelt, wordt elke bestaande querytekenreeks vervangen; laat leeg om de binnenkomende queryreeks te behouden. De querytekenreeks moet <sleutel>=<waarde> notatie hebben. De eerste? en & wordt automatisch toegevoegd, dus neem ze niet op aan de voorkant, maar scheid meerdere queryreeksen met &. snaar
redirectProtocol Het protocol van de bestemming waarnaar het verkeer wordt omgeleid 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType Het omleidingstype dat door de regel wordt gebruikt bij het omleiden van verkeer. 'Gevonden'
'Verplaatst'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Naam Beschrijving Waarde

RouteConfiguration

Naam Beschrijving Waarde
@odata.type Ingesteld op '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' voor het type ForwardingConfiguration. Ingesteld op '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' voor het type RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (vereist)

Routeringsregel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de Front Door-routeringsregel RoutingRuleProperties-

RoutingRuleProperties

Naam Beschrijving Waarde
acceptedProtocols Protocolschema's die overeenkomen met deze regel Tekenreeksmatrix met een van de volgende waarden:
'Http'
'Https'
enabledState Of u deze regel wilt gebruiken. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
frontendEndpoints Front-endeindpunten die zijn gekoppeld aan deze regel SubResource[]
patternsToMatch De routepatronen van de regel. tekenreeks[]
routeConfiguration Een verwijzing naar de routeringsconfiguratie. RouteConfiguration-
rulesEngine Een verwijzing naar een specifieke regelengineconfiguratie die moet worden toegepast op deze route. SubResource-

SubResource

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar

Quickstart-voorbeelden

In de volgende quickstartvoorbeelden wordt dit resourcetype geïmplementeerd.

Bicep-bestand Beschrijving
Aangepast domein en aangepast certificaat toevoegen met Front Door- Deze sjabloon onboardt en beveiligt een aangepast domein met Front Door met een door de klant beheerd certificaat
Aangepast domein en beheerd certificaat toevoegen met Front Door- Deze sjabloon onboardt en beveiligt een aangepast domein met Front Door
Controlestatustests voor uw back-ends op Front Door Met deze sjabloon wordt uw Front Door bijgewerkt om de statustestinstellingen te wijzigen door het testpad in te stellen en ook de intervallen waarin de tests worden verzonden.
Een eenvoudige Front Door- maken Met deze sjabloon maakt u een eenvoudige Front Door-configuratie met één back-end.
Een Front Door maken met HTTP naar HTTPS-omleiding Met deze sjabloon maakt u een Front Door-configuratie voor omleiding van HTTP naar HTTPS.

Resourcedefinitie van ARM-sjabloon

Het resourcetype frontDoors kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Network/frontDoors-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2020-01-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"
          }
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

RouteConfiguration-objecten

Stel de eigenschap @odata.type in om het type object op te geven.

Gebruik voor #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration:

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

Gebruik voor #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration:

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

Eigenschapswaarden

Back-end

Naam Beschrijving Waarde
adres Locatie van de back-end (IP-adres of FQDN) snaar
backendHostHeader De waarde die moet worden gebruikt als de hostheader die naar de back-end wordt verzonden. Als dit leeg of niet is opgegeven, wordt deze standaard ingesteld op de binnenkomende host. snaar
enabledState Of u dit gebruik van deze back-end wilt inschakelen. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
httpPort Het HTTP TCP-poortnummer. Moet tussen 1 en 65535 zijn. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
httpsPort Het HTTPS TCP-poortnummer. Moet tussen 1 en 65535 zijn. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
voorrang Prioriteit die moet worden gebruikt voor taakverdeling. Hogere prioriteiten worden niet gebruikt voor taakverdeling als een back-end met een lagere prioriteit in orde is. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 5
privateLinkAlias De alias van de Private Link-resource. Als u dit optionele veld invult, geeft u aan dat deze back-end privé is snaar
privateLinkApprovalMessage Een aangepast bericht dat moet worden opgenomen in de goedkeuringsaanvraag om verbinding te maken met de Private Link snaar
gewicht Gewicht van dit eindpunt voor taakverdelingsdoeleinden. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 1000

Back-endpool

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de Front Door-back-endpool BackendPoolProperties-

BackendPoolProperties

Naam Beschrijving Waarde
back-ends De set back-ends voor deze pool back-end[]
healthProbeSettings L7-statustestinstellingen voor een back-endpool SubResource-
loadBalancingSettings Taakverdelingsinstellingen voor een back-endpool SubResource-

BackendPoolsSettings

Naam Beschrijving Waarde
enforceCertificateNameCheck Of de certificaatnaam moet worden gecontroleerd op HTTPS-aanvragen voor alle back-endpools. Geen effect op niet-HTTPS-aanvragen. 'Uitgeschakeld'
'Ingeschakeld'
sendRecvTimeoutSeconds Time-out verzenden en ontvangen bij het doorsturen van een aanvraag naar de back-end. Wanneer de time-out is bereikt, mislukt de aanvraag en retourneert deze. Int

Beperkingen:
Minimumwaarde = 16

CacheConfiguration

Naam Beschrijving Waarde
cacheDuration De duur waarvoor de inhoud in de cache moet worden opgeslagen. Toegestane indeling heeft een ISO 8601-indeling (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP vereist dat de waarde niet langer dan een jaar is snaar
dynamicCompression Of dynamische compressie moet worden gebruikt voor inhoud in de cache 'Uitgeschakeld'
'Ingeschakeld'
queryParameters queryparameters die moeten worden opgenomen of uitgesloten (door komma's gescheiden). snaar
queryParameterStripDirective Behandeling van URL-querytermen bij het vormen van de cachesleutel. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Naam Beschrijving Waarde
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (vereist)
backendPool Een verwijzing naar de BackendPool waarnaar deze regel wordt gerouteerd. SubResource-
cacheConfiguration De cacheconfiguratie die aan deze regel is gekoppeld. CacheConfiguration-
customForwardingPath Een aangepast pad dat wordt gebruikt om resourcepaden te herschrijven die overeenkomen met deze regel. Laat leeg om het binnenkomende pad te gebruiken. snaar
forwardingProtocol Protocol dat door deze regel wordt gebruikt bij het doorsturen van verkeer naar back-ends. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontDoorProperties

Naam Beschrijving Waarde
backendPools Back-endpools die beschikbaar zijn voor routeringsregels. BackendPool[]
backendPoolsSettings Instellingen voor alle back-endpools BackendPoolsSettings-
enabledState Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
friendlyName Een beschrijvende naam voor de frontDoor snaar
frontendEndpoints Front-endeindpunten die beschikbaar zijn voor routeringsregels. FrontendEndpoint[]
healthProbeSettings Statustestinstellingen die zijn gekoppeld aan dit Front Door-exemplaar. HealthProbeSettingsModel[]
loadBalancingSettings Taakverdelingsinstellingen die zijn gekoppeld aan dit Front Door-exemplaar. LoadBalancingSettingsModel[]
routingRules Routeringsregels die aan deze Front Door zijn gekoppeld. RoutingRule[]

FrontendEndpoint

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van het front-endeindpunt FrontendEndpointProperties-

FrontendEndpointProperties

Naam Beschrijving Waarde
hostName De hostnaam van het frontendEndpoint. Moet een domeinnaam zijn. snaar
sessionAffinityEnabledState Of sessieaffiniteit op deze host moet worden toegestaan. Geldige opties zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
sessionAffinityTtlSeconds ONGEBRUIKT. Dit veld wordt genegeerd. De TTL die in seconden moet worden gebruikt voor sessieaffiniteit, indien van toepassing. Int
webApplicationFirewallPolicyLink Definieert het Web Application Firewall-beleid voor elke host (indien van toepassing) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar

HealthProbeSettingsModel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de statustestinstellingen HealthProbeSettingsProperties-

HealthProbeSettingsProperties

Naam Beschrijving Waarde
enabledState Of statustests moeten worden uitgevoerd op basis van back-ends die zijn gedefinieerd onder backendPools. Statustests kunnen alleen worden uitgeschakeld als er één back-end is ingeschakeld in een back-endpool met één ingeschakelde back-end. 'Uitgeschakeld'
'Ingeschakeld'
healthProbeMethod Hiermee configureert u welke HTTP-methode moet worden gebruikt om de back-ends te testen die zijn gedefinieerd onder backendPools. 'GET'
'HEAD'
intervalInSeconds Het aantal seconden tussen statustests. Int
pad Het pad dat moet worden gebruikt voor de statustest. Standaard is/ snaar
protocol Protocolschema dat moet worden gebruikt voor deze test 'Http'
'Https'

LoadBalancingSettingsModel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de taakverdelingsinstellingen LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Naam Beschrijving Waarde
additionalLatencyMilliseconds De extra latentie in milliseconden voor tests die in de laagste latentiebucket vallen Int
sampleSize Het aantal voorbeelden dat moet worden overwogen voor taakverdelingsbeslissingen Int
successfulSamplesRequired Het aantal steekproeven binnen de steekproefperiode die moet slagen Int

Microsoft.Network/frontDoors

Naam Beschrijving Waarde
apiVersion De API-versie '2020-01-01'
plaats Resourcelocatie. snaar
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 5
Patroon = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (vereist)
Eigenschappen Eigenschappen van de Front Door Load Balancer FrontDoorProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het resourcetype 'Microsoft.Network/frontDoors'

RedirectConfiguration

Naam Beschrijving Waarde
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (vereist)
customFragment Fragment dat moet worden toegevoegd aan de omleidings-URL. Fragment is het deel van de URL die na #komt. Neem het #-bestand niet op. snaar
customHost Host om te leiden. Laat leeg om de binnenkomende host als doelhost te gebruiken. snaar
customPath Het volledige pad om om te leiden. Pad mag niet leeg zijn en moet beginnen met /. Laat leeg om het binnenkomende pad als doelpad te gebruiken. snaar
customQueryString De set queryreeksen die in de omleidings-URL moeten worden geplaatst. Als u deze waarde instelt, wordt elke bestaande querytekenreeks vervangen; laat leeg om de binnenkomende queryreeks te behouden. De querytekenreeks moet <sleutel>=<waarde> notatie hebben. De eerste? en & wordt automatisch toegevoegd, dus neem ze niet op aan de voorkant, maar scheid meerdere queryreeksen met &. snaar
redirectProtocol Het protocol van de bestemming waarnaar het verkeer wordt omgeleid 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType Het omleidingstype dat door de regel wordt gebruikt bij het omleiden van verkeer. 'Gevonden'
'Verplaatst'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Naam Beschrijving Waarde

RouteConfiguration

Naam Beschrijving Waarde
@odata.type Ingesteld op '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' voor het type ForwardingConfiguration. Ingesteld op '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' voor het type RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (vereist)

Routeringsregel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de Front Door-routeringsregel RoutingRuleProperties-

RoutingRuleProperties

Naam Beschrijving Waarde
acceptedProtocols Protocolschema's die overeenkomen met deze regel Tekenreeksmatrix met een van de volgende waarden:
'Http'
'Https'
enabledState Of u deze regel wilt gebruiken. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
frontendEndpoints Front-endeindpunten die zijn gekoppeld aan deze regel SubResource[]
patternsToMatch De routepatronen van de regel. tekenreeks[]
routeConfiguration Een verwijzing naar de routeringsconfiguratie. RouteConfiguration-
rulesEngine Een verwijzing naar een specifieke regelengineconfiguratie die moet worden toegepast op deze route. SubResource-

SubResource

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon Beschrijving
Aangepast domein en aangepast certificaat toevoegen met Front Door-

implementeren in Azure
Deze sjabloon onboardt en beveiligt een aangepast domein met Front Door met een door de klant beheerd certificaat
Aangepast domein en beheerd certificaat toevoegen met Front Door-

implementeren in Azure
Deze sjabloon onboardt en beveiligt een aangepast domein met Front Door
Sessieaffiniteit configureren voor uw Front Door-hostnamen

implementeren in Azure
Met deze sjabloon wordt een Front Door bijgewerkt om sessieaffiniteit in te schakelen voor uw front-endhost, waardoor volgend verkeer van dezelfde gebruikerssessie naar dezelfde back-end wordt verzonden.
Controlestatustests voor uw back-ends op Front Door

implementeren in Azure
Met deze sjabloon wordt uw Front Door bijgewerkt om de statustestinstellingen te wijzigen door het testpad in te stellen en ook de intervallen waarin de tests worden verzonden.
Een eenvoudige Front Door- maken

implementeren in Azure
Met deze sjabloon maakt u een eenvoudige Front Door-configuratie met één back-end.
Een Front Door maken met HTTP naar HTTPS-omleiding

implementeren in Azure
Met deze sjabloon maakt u een Front Door-configuratie voor omleiding van HTTP naar HTTPS.
Een Front Door maken met meerdere back-ends en back-endpools

implementeren in Azure
Met deze sjabloon maakt u een Front Door met taakverdeling die is geconfigureerd voor meerdere back-ends in een back-endpool en ook voor back-endpools op basis van HET URL-pad.
Azure Front Door maken vóór Azure API Management

implementeren in Azure
In dit voorbeeld ziet u hoe u Azure Front Door gebruikt als een globale load balancer voor Azure API Management.
Front Door maken met Active-Standby configuratie

implementeren in Azure
Met deze sjabloon maakt u een Front Door die op prioriteit gebaseerde routering demonstreert voor Active-Standby toepassingstopologie.
Front Door maken met caching ingeschakeld voor bepaalde routes

implementeren in Azure
Met deze sjabloon maakt u een Front Door waarvoor caching is ingeschakeld voor de gedefinieerde routeringsconfiguratie, waardoor statische assets voor uw workload in de cache worden opgeslagen.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype frontDoors kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.Network/frontDoors-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2020-01-01"
  name = "string"
  location = "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"
            }
          }
        }
      ]
    }
  })
  tags = {
    {customized property} = "string"
  }
}

RouteConfiguration-objecten

Stel de eigenschap @odata.type in om het type object op te geven.

Gebruik voor #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration:

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

Gebruik voor #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration:

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

Eigenschapswaarden

Back-end

Naam Beschrijving Waarde
adres Locatie van de back-end (IP-adres of FQDN) snaar
backendHostHeader De waarde die moet worden gebruikt als de hostheader die naar de back-end wordt verzonden. Als dit leeg of niet is opgegeven, wordt deze standaard ingesteld op de binnenkomende host. snaar
enabledState Of u dit gebruik van deze back-end wilt inschakelen. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
httpPort Het HTTP TCP-poortnummer. Moet tussen 1 en 65535 zijn. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
httpsPort Het HTTPS TCP-poortnummer. Moet tussen 1 en 65535 zijn. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
voorrang Prioriteit die moet worden gebruikt voor taakverdeling. Hogere prioriteiten worden niet gebruikt voor taakverdeling als een back-end met een lagere prioriteit in orde is. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 5
privateLinkAlias De alias van de Private Link-resource. Als u dit optionele veld invult, geeft u aan dat deze back-end privé is snaar
privateLinkApprovalMessage Een aangepast bericht dat moet worden opgenomen in de goedkeuringsaanvraag om verbinding te maken met de Private Link snaar
gewicht Gewicht van dit eindpunt voor taakverdelingsdoeleinden. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 1000

Back-endpool

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de Front Door-back-endpool BackendPoolProperties-

BackendPoolProperties

Naam Beschrijving Waarde
back-ends De set back-ends voor deze pool back-end[]
healthProbeSettings L7-statustestinstellingen voor een back-endpool SubResource-
loadBalancingSettings Taakverdelingsinstellingen voor een back-endpool SubResource-

BackendPoolsSettings

Naam Beschrijving Waarde
enforceCertificateNameCheck Of de certificaatnaam moet worden gecontroleerd op HTTPS-aanvragen voor alle back-endpools. Geen effect op niet-HTTPS-aanvragen. 'Uitgeschakeld'
'Ingeschakeld'
sendRecvTimeoutSeconds Time-out verzenden en ontvangen bij het doorsturen van een aanvraag naar de back-end. Wanneer de time-out is bereikt, mislukt de aanvraag en retourneert deze. Int

Beperkingen:
Minimumwaarde = 16

CacheConfiguration

Naam Beschrijving Waarde
cacheDuration De duur waarvoor de inhoud in de cache moet worden opgeslagen. Toegestane indeling heeft een ISO 8601-indeling (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP vereist dat de waarde niet langer dan een jaar is snaar
dynamicCompression Of dynamische compressie moet worden gebruikt voor inhoud in de cache 'Uitgeschakeld'
'Ingeschakeld'
queryParameters queryparameters die moeten worden opgenomen of uitgesloten (door komma's gescheiden). snaar
queryParameterStripDirective Behandeling van URL-querytermen bij het vormen van de cachesleutel. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

ForwardingConfiguration

Naam Beschrijving Waarde
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (vereist)
backendPool Een verwijzing naar de BackendPool waarnaar deze regel wordt gerouteerd. SubResource-
cacheConfiguration De cacheconfiguratie die aan deze regel is gekoppeld. CacheConfiguration-
customForwardingPath Een aangepast pad dat wordt gebruikt om resourcepaden te herschrijven die overeenkomen met deze regel. Laat leeg om het binnenkomende pad te gebruiken. snaar
forwardingProtocol Protocol dat door deze regel wordt gebruikt bij het doorsturen van verkeer naar back-ends. 'HttpOnly'
'HttpsOnly'
'MatchRequest'

FrontDoorProperties

Naam Beschrijving Waarde
backendPools Back-endpools die beschikbaar zijn voor routeringsregels. BackendPool[]
backendPoolsSettings Instellingen voor alle back-endpools BackendPoolsSettings-
enabledState Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
friendlyName Een beschrijvende naam voor de frontDoor snaar
frontendEndpoints Front-endeindpunten die beschikbaar zijn voor routeringsregels. FrontendEndpoint[]
healthProbeSettings Statustestinstellingen die zijn gekoppeld aan dit Front Door-exemplaar. HealthProbeSettingsModel[]
loadBalancingSettings Taakverdelingsinstellingen die zijn gekoppeld aan dit Front Door-exemplaar. LoadBalancingSettingsModel[]
routingRules Routeringsregels die aan deze Front Door zijn gekoppeld. RoutingRule[]

FrontendEndpoint

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van het front-endeindpunt FrontendEndpointProperties-

FrontendEndpointProperties

Naam Beschrijving Waarde
hostName De hostnaam van het frontendEndpoint. Moet een domeinnaam zijn. snaar
sessionAffinityEnabledState Of sessieaffiniteit op deze host moet worden toegestaan. Geldige opties zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
sessionAffinityTtlSeconds ONGEBRUIKT. Dit veld wordt genegeerd. De TTL die in seconden moet worden gebruikt voor sessieaffiniteit, indien van toepassing. Int
webApplicationFirewallPolicyLink Definieert het Web Application Firewall-beleid voor elke host (indien van toepassing) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar

HealthProbeSettingsModel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de statustestinstellingen HealthProbeSettingsProperties-

HealthProbeSettingsProperties

Naam Beschrijving Waarde
enabledState Of statustests moeten worden uitgevoerd op basis van back-ends die zijn gedefinieerd onder backendPools. Statustests kunnen alleen worden uitgeschakeld als er één back-end is ingeschakeld in een back-endpool met één ingeschakelde back-end. 'Uitgeschakeld'
'Ingeschakeld'
healthProbeMethod Hiermee configureert u welke HTTP-methode moet worden gebruikt om de back-ends te testen die zijn gedefinieerd onder backendPools. 'GET'
'HEAD'
intervalInSeconds Het aantal seconden tussen statustests. Int
pad Het pad dat moet worden gebruikt voor de statustest. Standaard is/ snaar
protocol Protocolschema dat moet worden gebruikt voor deze test 'Http'
'Https'

LoadBalancingSettingsModel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de taakverdelingsinstellingen LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Naam Beschrijving Waarde
additionalLatencyMilliseconds De extra latentie in milliseconden voor tests die in de laagste latentiebucket vallen Int
sampleSize Het aantal voorbeelden dat moet worden overwogen voor taakverdelingsbeslissingen Int
successfulSamplesRequired Het aantal steekproeven binnen de steekproefperiode die moet slagen Int

Microsoft.Network/frontDoors

Naam Beschrijving Waarde
plaats Resourcelocatie. snaar
naam De resourcenaam snaar

Beperkingen:
Minimale lengte = 5
Maximale lengte = 5
Patroon = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (vereist)
Eigenschappen Eigenschappen van de Front Door Load Balancer FrontDoorProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het resourcetype "Microsoft.Network/frontDoors@2020-01-01"

RedirectConfiguration

Naam Beschrijving Waarde
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (vereist)
customFragment Fragment dat moet worden toegevoegd aan de omleidings-URL. Fragment is het deel van de URL die na #komt. Neem het #-bestand niet op. snaar
customHost Host om te leiden. Laat leeg om de binnenkomende host als doelhost te gebruiken. snaar
customPath Het volledige pad om om te leiden. Pad mag niet leeg zijn en moet beginnen met /. Laat leeg om het binnenkomende pad als doelpad te gebruiken. snaar
customQueryString De set queryreeksen die in de omleidings-URL moeten worden geplaatst. Als u deze waarde instelt, wordt elke bestaande querytekenreeks vervangen; laat leeg om de binnenkomende queryreeks te behouden. De querytekenreeks moet <sleutel>=<waarde> notatie hebben. De eerste? en & wordt automatisch toegevoegd, dus neem ze niet op aan de voorkant, maar scheid meerdere queryreeksen met &. snaar
redirectProtocol Het protocol van de bestemming waarnaar het verkeer wordt omgeleid 'HttpOnly'
'HttpsOnly'
'MatchRequest'
redirectType Het omleidingstype dat door de regel wordt gebruikt bij het omleiden van verkeer. 'Gevonden'
'Verplaatst'
'PermanentRedirect'
'TemporaryRedirect'

ResourceTags

Naam Beschrijving Waarde

RouteConfiguration

Naam Beschrijving Waarde
@odata.type Ingesteld op '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' voor het type ForwardingConfiguration. Ingesteld op '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' voor het type RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (vereist)

Routeringsregel

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar
naam Resourcenaam. snaar
Eigenschappen Eigenschappen van de Front Door-routeringsregel RoutingRuleProperties-

RoutingRuleProperties

Naam Beschrijving Waarde
acceptedProtocols Protocolschema's die overeenkomen met deze regel Tekenreeksmatrix met een van de volgende waarden:
'Http'
'Https'
enabledState Of u deze regel wilt gebruiken. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld 'Uitgeschakeld'
'Ingeschakeld'
frontendEndpoints Front-endeindpunten die zijn gekoppeld aan deze regel SubResource[]
patternsToMatch De routepatronen van de regel. tekenreeks[]
routeConfiguration Een verwijzing naar de routeringsconfiguratie. RouteConfiguration-
rulesEngine Een verwijzing naar een specifieke regelengineconfiguratie die moet worden toegepast op deze route. SubResource-

SubResource

Naam Beschrijving Waarde
legitimatiebewijs Resource-id. snaar