Dela via


Microsoft.Network frontDoors 2019-04-01

Bicep-resursdefinition

Resurstypen frontDoors kan distribueras till:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Network/frontDoors-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Network/frontDoors@2019-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              weight: int
            }
          ]
          healthProbeSettings: {
            id: 'string'
          }
          loadBalancingSettings: {
            id: 'string'
          }
        }
      }
    ]
    backendPoolsSettings: {
      enforceCertificateNameCheck: 'string'
    }
    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: {
          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
          }
        }
      }
    ]
  }
}

RouteConfiguration-objekt

Ange egenskapen @odata.type för att ange objekttypen.

För #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration använder du:

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

För #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration använder du:

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

Egenskapsvärden

frontDoors

Name Beskrivning Värde
name Resursnamnet sträng (krävs)

Teckengräns: 5–64

Giltiga tecken:
Alfanumeriska tecken och bindestreck.

Börja och sluta med alfanumeriskt.

Resursnamnet måste vara unikt i Hela Azure.
location Resursplats. sträng
tags Resurstaggar. Ordlista med taggnamn och värden. Se Taggar i mallar
properties Egenskaper för Front Door Load Balancer FrontDoorProperties

FrontDoorProperties

Name Beskrivning Värde
backendPools Serverdelspooler som är tillgängliga för routningsregler. BackendPool[]
backendPoolsSettings Inställningar för alla backendPools BackendPoolsSettings
enabledState Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är Aktiverade eller Inaktiverade "Inaktiverad"
"Aktiverad"
friendlyName Ett eget namn för frontDoor sträng
frontendEndpoints Klientdelsslutpunkter som är tillgängliga för routningsregler. FrontendEndpoint[]
healthProbeSettings Inställningar för hälsoavsökning som är associerade med den här Front Door-instansen. HealthProbeSettingsModel[]
loadBalancingSettings Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen. LoadBalancingSettingsModel[]
routingRules Routningsregler som är associerade med denna Front Door. RoutingRule[]

Serverdelspool

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för Front Door-serverdelspoolen BackendPoolProperties

BackendPoolProperties

Name Beskrivning Värde
Backends Uppsättningen serverdelar för den här poolen Serverdel[]
healthProbeSettings L7-hälsoavsökningsinställningar för en serverdelspool Underresurs
loadBalancingSettings Inställningar för belastningsutjämning för en serverdelspool SubResource

Serverdel

Name Beskrivning Värde
adress Plats för serverdelen (IP-adress eller FQDN) sträng
backendHostHeader Värdet som ska användas som värdrubrik som skickas till serverdelen. Om den är tom eller ospecificerad används den inkommande värden som standard. sträng
enabledState Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "aktiverade" eller "inaktiverade" "Inaktiverad"
"Aktiverad"
httpPort HTTP TCP-portnumret. Måste vara mellan 1 och 65535. int
httpsPort HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. int
prioritet Prioritet att använda för belastningsutjämning. Högre prioriteringar används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri. int
vikt Vikt för den här slutpunkten för belastningsutjämning. int

SubResource

Name Beskrivning Värde
id Resurs-ID. sträng

BackendPoolsSettings

Name Beskrivning Värde
enforceCertificateNameCheck Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden. "Inaktiverad"
"Aktiverad"

KlientdelSlutpunkt

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för klientdelsslutpunkten KlientdelEndpointEgenskaper

KlientdelEndpointEgenskaper

Name Beskrivning Värde
Värdnamn Värdnamnet för frontendEndpoint. Måste vara ett domännamn. sträng
sessionAffinityEnabledState Om sessionstillhörighet ska tillåtas på den här värden. Giltiga alternativ är "Aktiverad" eller "Inaktiverad" "Inaktiverad"
"Aktiverad"
sessionAffinityTtlSeconds OANVÄNDA. Det här fältet ignoreras. TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. int
webApplicationFirewallPolicyLink Definierar Web Application Firewall princip för varje värd (om tillämpligt) FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Name Beskrivning Värde
id Resurs-ID. sträng

HealthProbeSettingsModel

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för hälsoavsökningsinställningarna HealthProbeSettingsProperties

HealthProbeSettingsProperties

Name Beskrivning Värde
intervalInSeconds Antalet sekunder mellan hälsoavsökningar. int
path Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ sträng
Protokollet Protokollschema som ska användas för den här avsökningen "Http"
"Https"

LoadBalancingSettingsModel

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för belastningsutjämningsinställningarna LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Name Beskrivning Värde
additionalLatencyMilliseconds Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med kortast svarstid int
sampleSize Antalet exempel som ska övervägas för beslut om belastningsutjämning int
successfulSamplesRequired Antalet prover inom exempelperioden som måste lyckas int

RoutingRule

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för Front Door-routningsregeln RoutingRuleProperties

RoutingRuleProperties

Name Beskrivning Värde
acceptedProtocols Protokollscheman som ska matchas för den här regeln Strängmatris som innehåller något av:
"Http"
"Https"
enabledState Om du vill aktivera användning av den här regeln. Tillåtna värden är Aktiverade eller Inaktiverade "Inaktiverad"
"Aktiverad"
frontendEndpoints Klientdelsslutpunkter som är associerade med den här regeln SubResource[]
patternsToMatch Regelns vägmönster. string[]
routeConfiguration En referens till routningskonfigurationen. RouteConfiguration

RouteConfiguration

Name Beskrivning Värde
@odata.type Ange objekttyp #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (krävs)

ForwardingConfiguration

Name Beskrivning Värde
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (krävs)
backendPool En referens till backendPool som den här regeln dirigerar till. Underresurs
cacheConfiguration Cachelagringskonfigurationen som är associerad med den här regeln. CacheConfiguration
customForwardingPath En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Lämna tomt om du vill använda den inkommande sökvägen. sträng
forwardingProtocol Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. "HttpOnly"
"HttpsOnly"
"MatchRequest"

CacheConfiguration

Name Beskrivning Värde
dynamicCompression Om dynamisk komprimering ska användas för cachelagrat innehåll "Inaktiverad"
"Aktiverad"
queryParameterStripDirective Behandling av URL-frågetermer när cachenyckeln skapas. "StripAll"
"StripNone"

RedirectConfiguration

Name Beskrivning Värde
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs)
customFragment Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Ta inte med #. sträng
customHost Värd för omdirigering. Lämna tomt om du vill använda den inkommande värden som målvärd. sträng
customPath Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tomt om du vill använda den inkommande sökvägen som målsökväg. sträng
customQueryString Uppsättningen frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tomt för att bevara den inkommande frågesträngen. Frågesträngen måste vara i {key}={value}-format. Den första? och & läggs till automatiskt, så ta inte med dem längst fram, utan avgränsa flera frågesträngar med &. sträng
redirectProtocol Protokollet för målet dit trafiken omdirigeras "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Omdirigeringstypen som regeln använder vid omdirigering av trafik. "Hittades"
"Flyttad"
"PermanentRedirect"
"TemporaryRedirect"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Skapa Azure Front Door framför Azure API Management

Distribuera till Azure
Det här exemplet visar hur du använder Azure Front Door som global lastbalanserare framför Azure API Management.
Skapa en grundläggande Front Door

Distribuera till Azure
Den här mallen skapar en grundläggande Front Door-konfiguration med en enda serverdel.
Skapa Front Door med cachelagring aktiverat för vissa vägar

Distribuera till Azure
Den här mallen skapar en Front Door med cachelagring aktiverat för den definierade routningskonfigurationen och cachelagrar därmed statiska tillgångar för din arbetsbelastning.
Skapa en Front Door med flera serverdelar och serverdelspooler

Distribuera till Azure
Den här mallen skapar en Front Door med belastningsutjämning konfigurerad för flera serverdelar i en serverdelspool och även över serverdelspooler baserat på URL-sökväg.
Skapa en Front Door med HTTP till HTTPS-omdirigering

Distribuera till Azure
Den här mallen skapar en Front Door-konfiguration för HTTP till HTTPS-omdirigering.
Lägga till anpassad domän och hanterat certifikat med Front Door

Distribuera till Azure
Den här mallen registrerar och skyddar en anpassad domän med Front Door
Lägga till anpassad domän och anpassat certifikat med Front Door

Distribuera till Azure
Den här mallen registrerar och skyddar en anpassad domän med Front Door med ett kundhanterat certifikat
Kontrollera hälsoavsökningar för dina serverdelar i Front Door

Distribuera till Azure
Den här mallen uppdaterar Din Front Door för att ändra inställningarna för hälsoavsökningen genom att ange sökvägen för avsökningen och även de intervall som avsökningarna ska skickas i.
Skapa Front Door med Active-Standby-konfiguration

Distribuera till Azure
Den här mallen skapar en Front Door som visar prioritetsbaserad routning för Active-Standby programtopologi.
Konfigurera sessionstillhörighet för dina Front Door-värdnamn

Distribuera till Azure
Den här mallen uppdaterar en Front Door för att aktivera sessionstillhörighet för klientdelsvärden och skickar därmed efterföljande trafik från samma användarsession till samma serverdel.

Resursdefinition för ARM-mall

Resurstypen frontDoors kan distribueras till:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Network/frontDoors-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2019-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "weight": "int"
            }
          ],
          "healthProbeSettings": {
            "id": "string"
          },
          "loadBalancingSettings": {
            "id": "string"
          }
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "string"
    },
    "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": {
          "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
          }
        }
      }
    ]
  }
}

RouteConfiguration-objekt

Ange egenskapen @odata.type för att ange objekttypen.

För #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration använder du:

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

För #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration använder du:

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

Egenskapsvärden

frontDoors

Name Beskrivning Värde
typ Resurstypen "Microsoft.Network/frontDoors"
apiVersion Resurs-API-versionen '2019-04-01'
name Resursnamnet sträng (krävs)

Teckengräns: 5–64

Giltiga tecken:
Alfanumeriska tecken och bindestreck.

Börja och sluta med alfanumeriskt.

Resursnamnet måste vara unikt i Hela Azure.
location Resursplats. sträng
tags Resurstaggar. Ordlista med taggnamn och värden. Se Taggar i mallar
properties Egenskaper för Front Door-Load Balancer FrontDoorEgenskaper

FrontDoorEgenskaper

Name Beskrivning Värde
backendPools Serverdelspooler som är tillgängliga för routningsregler. BackendPool[]
backendPoolsSettings Inställningar för alla backendPools BackendPoolsSettings
enabledState Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är "aktiverade" eller "inaktiverade" "Inaktiverad"
"Aktiverad"
friendlyName Ett eget namn för frontDoor sträng
frontendEndpoints Klientdelsslutpunkter som är tillgängliga för routningsregler. FrontendEndpoint[]
healthProbeSettings Hälsoavsökningsinställningar som är associerade med den här Front Door-instansen. HealthProbeSettingsModel[]
loadBalancingSettings Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen. LoadBalancingSettingsModel[]
routingRules Routningsregler som är associerade med denna Front Door. RoutingRule[]

Serverdelspool

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för Front Door-serverdelspoolen BackendPoolEgenskaper

BackendPoolEgenskaper

Name Beskrivning Värde
Backends Uppsättningen serverdelar för den här poolen Serverdel[]
healthProbeSettings L7-hälsoavsökningsinställningar för en serverdelspool SubResource
loadBalancingSettings Belastningsutjämningsinställningar för en serverdelspool SubResource

Serverdel

Name Beskrivning Värde
adress Plats för serverdelen (IP-adress eller FQDN) sträng
backendHostHeader Värdet som ska användas som värdrubrik som skickas till serverdelen. Om den är tom eller ospecificerad används den inkommande värden som standard. sträng
enabledState Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "aktiverade" eller "inaktiverade" "Inaktiverad"
"Aktiverad"
httpPort HTTP TCP-portnumret. Måste vara mellan 1 och 65535. int
httpsPort HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. int
prioritet Prioritet att använda för belastningsutjämning. Högre prioriteter används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri. int
vikt Den här slutpunktens vikt för belastningsutjämning. int

Underresurs

Name Beskrivning Värde
id Resurs-ID. sträng

BackendPoolsSettings

Name Beskrivning Värde
enforceCertificateNameCheck Om du vill framtvinga kontroll av certifikatnamn på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden. "Inaktiverad"
"Aktiverad"

KlientdelSlutpunkt

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för klientdelsslutpunkten FrontendEndpointProperties

FrontendEndpointProperties

Name Beskrivning Värde
Värdnamn Värdnamnet för frontendEndpoint. Måste vara ett domännamn. sträng
sessionAffinityEnabledState Om sessionstillhörighet ska tillåtas på den här värden. Giltiga alternativ är "Aktiverad" eller "Inaktiverad" "Inaktiverad"
"Aktiverad"
sessionAffinityTtlSeconds OANVÄNDA. Det här fältet ignoreras. TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. int
webApplicationFirewallPolicyLink Definierar Web Application Firewall princip för varje värd (om tillämpligt) FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Name Beskrivning Värde
id Resurs-ID. sträng

HealthProbeSettingsModel

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för hälsoavsökningsinställningarna HealthProbeSettingsProperties

HealthProbeSettingsProperties

Name Beskrivning Värde
intervalInSeconds Antalet sekunder mellan hälsoavsökningar. int
path Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ sträng
Protokollet Protokollschema som ska användas för den här avsökningen "Http"
"Https"

LoadBalancingSettingsModel

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för belastningsutjämningsinställningarna LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Name Beskrivning Värde
additionalLatencyMilliseconds Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med kortast svarstid int
sampleSize Antalet exempel som ska övervägas för beslut om belastningsutjämning int
successfulSamplesRequired Antalet prover inom exempelperioden som måste lyckas int

RoutingRule

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för Front Door-routningsregeln RoutingRuleProperties

RoutingRuleProperties

Name Beskrivning Värde
acceptedProtocols Protokollscheman som ska matchas för den här regeln Strängmatris som innehåller något av:
"Http"
"Https"
enabledState Om du vill aktivera användning av den här regeln. Tillåtna värden är Aktiverade eller Inaktiverade "Inaktiverad"
"Aktiverad"
frontendEndpoints Klientdelsslutpunkter som är associerade med den här regeln SubResource[]
patternsToMatch Regelns vägmönster. string[]
routeConfiguration En referens till routningskonfigurationen. RouteConfiguration

RouteConfiguration

Name Beskrivning Värde
@odata.type Ange objekttyp #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (krävs)

ForwardingConfiguration

Name Beskrivning Värde
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (krävs)
backendPool En referens till backendPool som den här regeln dirigerar till. Underresurs
cacheConfiguration Cachelagringskonfigurationen som är associerad med den här regeln. CacheConfiguration
customForwardingPath En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Lämna tomt om du vill använda den inkommande sökvägen. sträng
forwardingProtocol Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. "HttpOnly"
"HttpsOnly"
"MatchRequest"

CacheConfiguration

Name Beskrivning Värde
dynamicCompression Om dynamisk komprimering ska användas för cachelagrat innehåll "Inaktiverad"
"Aktiverad"
queryParameterStripDirective Behandling av URL-frågetermer när cachenyckeln skapas. "StripAll"
"StripNone"

RedirectConfiguration

Name Beskrivning Värde
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs)
customFragment Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Ta inte med #. sträng
customHost Värd för omdirigering. Lämna tomt om du vill använda den inkommande värden som målvärd. sträng
customPath Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tomt om du vill använda den inkommande sökvägen som målsökväg. sträng
customQueryString Uppsättningen frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tomt för att bevara den inkommande frågesträngen. Frågesträngen måste vara i {key}={value}-format. Den första? och & läggs till automatiskt, så ta inte med dem längst fram, utan avgränsa flera frågesträngar med &. sträng
redirectProtocol Protokollet för målet dit trafiken omdirigeras "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Omdirigeringstypen som regeln använder vid omdirigering av trafik. "Hittades"
"Flyttad"
"PermanentRedirect"
"TemporaryRedirect"

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Skapa Azure Front Door framför Azure API Management

Distribuera till Azure
Det här exemplet visar hur du använder Azure Front Door som global lastbalanserare framför Azure API Management.
Skapa en grundläggande Front Door

Distribuera till Azure
Den här mallen skapar en grundläggande Front Door-konfiguration med en enda serverdel.
Skapa Front Door med cachelagring aktiverat för vissa vägar

Distribuera till Azure
Den här mallen skapar en Front Door med cachelagring aktiverat för den definierade routningskonfigurationen och cachelagrar därmed statiska tillgångar för din arbetsbelastning.
Skapa en Front Door med flera serverdelar och serverdelspooler

Distribuera till Azure
Den här mallen skapar en Front Door med belastningsutjämning konfigurerad för flera serverdelar i en serverdelspool och även över serverdelspooler baserat på URL-sökväg.
Skapa en Front Door med HTTP till HTTPS-omdirigering

Distribuera till Azure
Den här mallen skapar en Front Door-konfiguration för HTTP till HTTPS-omdirigering.
Lägga till anpassad domän och hanterat certifikat med Front Door

Distribuera till Azure
Den här mallen registrerar och skyddar en anpassad domän med Front Door
Lägga till anpassad domän och anpassat certifikat med Front Door

Distribuera till Azure
Den här mallen registrerar och skyddar en anpassad domän med Front Door med ett kundhanterat certifikat
Kontrollera hälsoavsökningar för dina serverdelar i Front Door

Distribuera till Azure
Den här mallen uppdaterar Din Front Door för att ändra inställningarna för hälsoavsökningen genom att ange sökvägen för avsökningen och även de intervall som avsökningarna ska skickas i.
Skapa Front Door med Active-Standby-konfiguration

Distribuera till Azure
Den här mallen skapar en Front Door som visar prioritetsbaserad routning för Active-Standby programtopologi.
Konfigurera sessionstillhörighet för dina Front Door-värdnamn

Distribuera till Azure
Den här mallen uppdaterar en Front Door för att aktivera sessionstillhörighet för klientdelsvärden och skickar därmed efterföljande trafik från samma användarsession till samma serverdel.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen frontDoors kan distribueras till:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Network/frontDoors-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2019-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                weight = int
              }
            ]
            healthProbeSettings = {
              id = "string"
            }
            loadBalancingSettings = {
              id = "string"
            }
          }
        }
      ]
      backendPoolsSettings = {
        enforceCertificateNameCheck = "string"
      }
      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 = {
            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
            }
          }
        }
      ]
    }
  })
}

RouteConfiguration-objekt

Ange egenskapen @odata.type för att ange objekttypen.

För #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration använder du:

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

För #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration använder du:

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

Egenskapsvärden

frontDoors

Name Beskrivning Värde
typ Resurstypen "Microsoft.Network/frontDoors@2019-04-01"
name Resursnamnet sträng (krävs)

Teckengräns: 5–64

Giltiga tecken:
Alfanumeriska tecken och bindestreck.

Börja och sluta med alfanumeriskt.

Resursnamnet måste vara unikt i Hela Azure.
location Resursplats. sträng
parent_id Om du vill distribuera till en resursgrupp använder du ID:t för den resursgruppen. sträng (krävs)
tags Resurstaggar. Ordlista med taggnamn och värden.
properties Egenskaper för Front Door Load Balancer FrontDoorProperties

FrontDoorProperties

Name Beskrivning Värde
backendPools Serverdelspooler som är tillgängliga för routningsregler. BackendPool[]
backendPoolsSettings Inställningar för alla backendPools BackendPoolsSettings
enabledState Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är Aktiverade eller Inaktiverade "Inaktiverad"
"Aktiverad"
friendlyName Ett eget namn för frontDoor sträng
frontendEndpoints Klientdelsslutpunkter som är tillgängliga för routningsregler. FrontendEndpoint[]
healthProbeSettings Inställningar för hälsoavsökning som är associerade med den här Front Door-instansen. HealthProbeSettingsModel[]
loadBalancingSettings Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen. LoadBalancingSettingsModel[]
routingRules Routningsregler som är associerade med denna Front Door. RoutingRule[]

Serverdelspool

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för Front Door-serverdelspoolen BackendPoolProperties

BackendPoolProperties

Name Beskrivning Värde
Backends Uppsättningen serverdelar för den här poolen Serverdel[]
healthProbeSettings L7-hälsoavsökningsinställningar för en serverdelspool Underresurs
loadBalancingSettings Inställningar för belastningsutjämning för en serverdelspool Underresurs

Serverdel

Name Beskrivning Värde
adress Plats för serverdelen (IP-adress eller FQDN) sträng
backendHostHeader Det värde som ska användas som värdrubrik som skickas till serverdelen. Om det är tomt eller ospecificerat används den inkommande värden som standard. sträng
enabledState Om du vill aktivera användning av den här serverdelen. Tillåtna värden är Aktiverade eller Inaktiverade "Inaktiverad"
"Aktiverad"
httpPort HTTP TCP-portnumret. Måste vara mellan 1 och 65535. int
httpsPort HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. int
prioritet Prioritet att använda för belastningsutjämning. Högre prioriteter används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri. int
vikt Den här slutpunktens vikt för belastningsutjämning. int

Underresurs

Name Beskrivning Värde
id Resurs-ID. sträng

BackendPoolsSettings

Name Beskrivning Värde
enforceCertificateNameCheck Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden. "Inaktiverad"
"Aktiverad"

KlientdelSlutpunkt

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för klientdelsslutpunkten KlientdelEndpointEgenskaper

KlientdelEndpointEgenskaper

Name Beskrivning Värde
Värdnamn Värdnamnet för frontendEndpoint. Måste vara ett domännamn. sträng
sessionAffinityEnabledState Om sessionstillhörighet ska tillåtas på den här värden. Giltiga alternativ är "Aktiverad" eller "Inaktiverad" "Inaktiverad"
"Aktiverad"
sessionAffinityTtlSeconds OANVÄNDA. Det här fältet ignoreras. TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. int
webApplicationFirewallPolicyLink Definierar Web Application Firewall princip för varje värd (om tillämpligt) FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Name Beskrivning Värde
id Resurs-ID. sträng

HealthProbeSettingsModel

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för hälsoavsökningsinställningarna HealthProbeSettingsEgenskaper

HealthProbeSettingsEgenskaper

Name Beskrivning Värde
intervalInSeconds Antalet sekunder mellan hälsoavsökningar. int
path Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ sträng
Protokollet Protokollschema som ska användas för den här avsökningen "Http"
"Https"

LoadBalancingSettingsModel

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för belastningsutjämningsinställningarna LoadBalancingSettingsEgenskaper

LoadBalancingSettingsEgenskaper

Name Beskrivning Värde
additionalLatencyMilliseconds Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med lägst svarstid int
sampleSize Antalet exempel som ska övervägas för beslut om belastningsutjämning int
successfulSamplesRequired Antalet exempel inom exempelperioden som måste lyckas int

RoutingRule

Name Beskrivning Värde
id Resurs-ID. sträng
name Resursnamn. sträng
properties Egenskaper för frontdörrens routningsregel RoutingRuleEgenskaper

RoutingRuleEgenskaper

Name Beskrivning Värde
acceptedProtocols Protokollscheman som matchar för den här regeln Strängmatris som innehåller något av:
"Http"
"Https"
enabledState Om du vill aktivera användning av den här regeln. Tillåtna värden är "aktiverade" eller "inaktiverade" "Inaktiverad"
"Aktiverad"
frontendEndpoints Klientdelsslutpunkter som är associerade med den här regeln SubResource[]
patternsToMatch Regelns vägmönster. string[]
routeConfiguration En referens till routningskonfigurationen. RouteConfiguration

RouteConfiguration

Name Beskrivning Värde
@odata.type Ange objekttyp #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (krävs)

VidarebefordranKonfiguration

Name Beskrivning Värde
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (krävs)
backendPool En referens till backendPool som den här regeln dirigerar till. SubResource
cacheConfiguration Cachelagringskonfigurationen som är associerad med den här regeln. CacheConfiguration
customForwardingPath En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Lämna tomt om du vill använda inkommande sökväg. sträng
forwardingProtocol Protokoll som den här regeln använder när trafik vidarebefordras till serverdelar. "HttpOnly"
"HttpsOnly"
"MatchRequest"

CacheConfiguration

Name Beskrivning Värde
dynamicCompression Om dynamisk komprimering ska användas för cachelagrat innehåll "Inaktiverad"
"Aktiverad"
queryParameterStripDirective Behandling av URL-frågetermer när cachenyckeln skapas. "StripAll"
"StripNone"

RedirectConfiguration

Name Beskrivning Värde
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs)
customFragment Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Inkludera inte #. sträng
customHost Värd för omdirigering. Lämna tomt om du vill använda den inkommande värden som målvärd. sträng
customPath Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tomt om du vill använda den inkommande sökvägen som målsökväg. sträng
customQueryString Uppsättningen frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tomt för att bevara den inkommande frågesträngen. Frågesträngen måste vara i {key}={value}-format. Den första? och & läggs till automatiskt, så ta inte med dem längst fram, utan avgränsa flera frågesträngar med &. sträng
redirectProtocol Protokollet för målet dit trafiken omdirigeras "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Omdirigeringstypen som regeln använder vid omdirigering av trafik. "Hittades"
"Flyttad"
"PermanentRedirect"
"TemporaryRedirect"