Dela via

Microsoft.Network frontDoors 2020-05-01

  • Artikel

Bicep-resursdefinition

Resurstypen frontDoors kan distribueras med åtgärder som mål:

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@2020-05-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'
              privateLinkLocation: 'string'
              privateLinkResourceId: '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'
  }
}

RouteConfiguration-objekt

Ange egenskapen @odata.type för att ange typ av objekt.

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

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

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

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

Egenskapsvärden

Serverdel

Namn Beskrivning Värde
adress Plats för serverdelen (IP-adress eller FQDN) sträng
backendHostHeader Värdet som ska användas som värdrubriken som skickas till serverdelen. Om det är tomt eller ospecificerat är detta standardvärdet för den inkommande värden. 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

Begränsningar:
Minsta värde = 1
Maxvärde = 65535
httpsPort HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 65535
prioritering 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

Begränsningar:
Minsta värde = 1
Maxvärde = 5
privateLinkAlias Aliaset för Private Link-resursen. Att fylla i det här valfria fältet anger att den här serverdelen är "Privat" sträng
privateLinkApprovalMessage Ett anpassat meddelande som ska ingå i godkännandebegäran för att ansluta till Private Link sträng
privateLinkLocation Platsen för Private Link-resursen. Krävs endast om "privateLinkResourceId" har fyllts i sträng
privateLinkResourceId Resurs-ID för Private Link-resursen. Att fylla i det här valfria fältet anger att den här serverdelen är "Privat" sträng
vikt Den här slutpunktens vikt för belastningsutjämning. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 1 000

Serverdelspool

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för Front Door-serverdelspoolen BackendPoolProperties

BackendPoolEgenskaper

Namn Beskrivning Värde
serverdelar 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

BackendPoolsSettings

Namn 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"
sendRecvTimeoutSeconds Tidsgränsen för att skicka och ta emot vid vidarebefordran av begäran till serverdelen. När tidsgränsen nås misslyckas begäran och returneras. Int

Begränsningar:
Minsta värde = 16

CacheConfiguration

Namn Beskrivning Värde
cacheDuration Hur länge innehållet måste cachelagras. Det tillåtna formatet är i ISO 8601-format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP kräver att värdet inte är längre än ett år sträng
dynamicCompression Om dynamisk komprimering ska användas för cachelagrat innehåll "Inaktiverad"
"Aktiverad"
queryParameters frågeparametrar som ska inkluderas eller exkluderas (kommaavgränsade). sträng
queryParameterStripDirective Behandling av URL-frågetermer när du bildar cachenyckeln. "StripAll"
"StripAllExcept"
"StripNone"
"StripOnly"

VidarebefordranKonfiguration

Namn 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åt vara tom om du vill använda inkommande sökväg. sträng
forwardingProtocol Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. "HttpOnly"
"HttpsOnly"
"MatchRequest"

FrontDoorProperties

Namn Beskrivning Värde
backendPools Serverdelspooler som är tillgängliga för routningsregler. BackendPool[]
backendPoolsSettings Inställningar för alla serverdelspooler 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[]

FrontendEndpoint

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för klientdelsslutpunkten FrontendEndpointProperties

FrontendEndpointProperties

Namn Beskrivning Värde
hostName Värdnamnet för klientdelenEndpoint. Måste vara ett domännamn. sträng
sessionAffinityEnabledState Om du vill tillåta sessionstillhörighet på den här värden. Giltiga alternativ är "Aktiverade" eller "Inaktiverade" "Inaktiverad"
"Aktiverad"
sessionAffinityTtlSeconds OANVÄND. Det här fältet ignoreras. Den TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. Int
webApplicationFirewallPolicyLink Definierar brandväggsprincipen för webbprogram för varje värd (om tillämpligt) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Namn Beskrivning Värde
Id Resurs-ID. sträng

HealthProbeSettingsModel

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för hälsoavsökningsinställningarna HealthProbeSettingsEgenskaper

HealthProbeSettingsProperties

Namn Beskrivning Värde
enabledState Om du vill aktivera hälsoavsökningar mot serverdelar som definierats under backendPools. Hälsoavsökningar kan bara inaktiveras om det finns en enda aktiverad serverdel i en enda aktiverad serverdelspool. "Inaktiverad"
"Aktiverad"
healthProbeMethod Konfigurerar vilken HTTP-metod som ska användas för att avsöka de serverdelar som definierats under backendPools. "GET"
"HEAD"
intervalInSeconds Antalet sekunder mellan hälsoavsökningar. Int
stig Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ sträng
protokoll Protokollschema som ska användas för den här avsökningen "Http"
"Https"

LoadBalancingSettingsModel

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för belastningsutjämningsinställningarna LoadBalancingSettingsEgenskaper

LoadBalancingSettingsEgenskaper

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

Microsoft.Network/frontDoors

Namn Beskrivning Värde
plats Resursplats. sträng
Namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Max längd = 5
Mönster = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (krävs)
Egenskaper Egenskaper för Front Door Load Balancer FrontDoorProperties
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

RedirectConfiguration

Namn 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åt vara tom 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 tom om du vill använda den inkommande sökvägen som målsökväg. sträng
customQueryString Den uppsättning 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 tom för att bevara den inkommande frågesträngen. Frågesträngen måste vara i <nyckel>=<värde> format. Den första? och & läggs till automatiskt så ta inte med dem i fronten, men separera flera frågesträngar med &. sträng
redirectProtocol Protokollet för målet till där trafiken omdirigeras "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Omdirigeringstypen som regeln ska använda vid omdirigering av trafik. "Hittades"
"Flyttad"
"PermanentRedirect"
"TemporaryRedirect"

ResourceTags

Namn Beskrivning Värde

RouteConfiguration

Namn Beskrivning Värde
@odata.type Ange till "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" för typen ForwardingConfiguration. Ange till "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" för typ RedirectConfiguration. "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs)

RoutingRule

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för Front Door-routningsregeln RoutingRuleProperties

RoutingRuleEgenskaper

Namn 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
rulesEngine En referens till en specifik regelmotorkonfiguration som ska tillämpas på den här vägen. SubResource
webApplicationFirewallPolicyLink Definierar brandväggsprincipen för webbaserade program för varje routningsregel (om tillämpligt) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Namn Beskrivning Värde
Id Resurs-ID. sträng

SubResource

Namn Beskrivning Värde
Id Resurs-ID. sträng

Snabbstartsexempel

Följande snabbstartsexempel distribuerar den här resurstypen.

Bicep-fil Beskrivning
Lägg till anpassad domän och anpassat certifikat med Front Door Den här mallen registrerar och skyddar en anpassad domän med Front Door med ett kundhanterat certifikat
Lägg till anpassad domän och hanterat certifikat med Front Door Den här mallen registrerar och skyddar en anpassad domän med Front Door
Kontroll hälsoavsökningar för dina serverdelar på Front Door 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 en grundläggande Front Door- Den här mallen skapar en grundläggande Front Door-konfiguration med en enda serverdel.
Skapa en Front Door med HTTP till HTTPS-omdirigering Den här mallen skapar en Front Door-konfiguration för HTTP till HTTPS-omdirigering.

Resursdefinition för ARM-mall

Resurstypen frontDoors kan distribueras med åtgärder som mål:

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": "2020-05-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",
              "privateLinkLocation": "string",
              "privateLinkResourceId": "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"
  }
}

RouteConfiguration-objekt

Ange egenskapen @odata.type för att ange typ av objekt.

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

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

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

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

Egenskapsvärden

Serverdel

Namn Beskrivning Värde
adress Plats för serverdelen (IP-adress eller FQDN) sträng
backendHostHeader Värdet som ska användas som värdrubriken som skickas till serverdelen. Om det är tomt eller ospecificerat är detta standardvärdet för den inkommande värden. 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

Begränsningar:
Minsta värde = 1
Maxvärde = 65535
httpsPort HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 65535
prioritering 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

Begränsningar:
Minsta värde = 1
Maxvärde = 5
privateLinkAlias Aliaset för Private Link-resursen. Att fylla i det här valfria fältet anger att den här serverdelen är "Privat" sträng
privateLinkApprovalMessage Ett anpassat meddelande som ska ingå i godkännandebegäran för att ansluta till Private Link sträng
privateLinkLocation Platsen för Private Link-resursen. Krävs endast om "privateLinkResourceId" har fyllts i sträng
privateLinkResourceId Resurs-ID för Private Link-resursen. Att fylla i det här valfria fältet anger att den här serverdelen är "Privat" sträng
vikt Den här slutpunktens vikt för belastningsutjämning. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 1 000

Serverdelspool

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för Front Door-serverdelspoolen BackendPoolProperties

BackendPoolEgenskaper

Namn Beskrivning Värde
serverdelar 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

BackendPoolsSettings

Namn 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"
sendRecvTimeoutSeconds Tidsgränsen för att skicka och ta emot vid vidarebefordran av begäran till serverdelen. När tidsgränsen nås misslyckas begäran och returneras. Int

Begränsningar:
Minsta värde = 16

CacheConfiguration

Namn Beskrivning Värde
cacheDuration Hur länge innehållet måste cachelagras. Det tillåtna formatet är i ISO 8601-format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP kräver att värdet inte är längre än ett år sträng
dynamicCompression Om dynamisk komprimering ska användas för cachelagrat innehåll "Inaktiverad"
"Aktiverad"
queryParameters frågeparametrar som ska inkluderas eller exkluderas (kommaavgränsade). sträng
queryParameterStripDirective Behandling av URL-frågetermer när du bildar cachenyckeln. "StripAll"
"StripAllExcept"
"StripNone"
"StripOnly"

VidarebefordranKonfiguration

Namn 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åt vara tom om du vill använda inkommande sökväg. sträng
forwardingProtocol Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. "HttpOnly"
"HttpsOnly"
"MatchRequest"

FrontDoorProperties

Namn Beskrivning Värde
backendPools Serverdelspooler som är tillgängliga för routningsregler. BackendPool[]
backendPoolsSettings Inställningar för alla serverdelspooler 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[]

FrontendEndpoint

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för klientdelsslutpunkten FrontendEndpointProperties

FrontendEndpointProperties

Namn Beskrivning Värde
hostName Värdnamnet för klientdelenEndpoint. Måste vara ett domännamn. sträng
sessionAffinityEnabledState Om du vill tillåta sessionstillhörighet på den här värden. Giltiga alternativ är "Aktiverade" eller "Inaktiverade" "Inaktiverad"
"Aktiverad"
sessionAffinityTtlSeconds OANVÄND. Det här fältet ignoreras. Den TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. Int
webApplicationFirewallPolicyLink Definierar brandväggsprincipen för webbprogram för varje värd (om tillämpligt) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Namn Beskrivning Värde
Id Resurs-ID. sträng

HealthProbeSettingsModel

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för hälsoavsökningsinställningarna HealthProbeSettingsEgenskaper

HealthProbeSettingsProperties

Namn Beskrivning Värde
enabledState Om du vill aktivera hälsoavsökningar mot serverdelar som definierats under backendPools. Hälsoavsökningar kan bara inaktiveras om det finns en enda aktiverad serverdel i en enda aktiverad serverdelspool. "Inaktiverad"
"Aktiverad"
healthProbeMethod Konfigurerar vilken HTTP-metod som ska användas för att avsöka de serverdelar som definierats under backendPools. "GET"
"HEAD"
intervalInSeconds Antalet sekunder mellan hälsoavsökningar. Int
stig Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ sträng
protokoll Protokollschema som ska användas för den här avsökningen "Http"
"Https"

LoadBalancingSettingsModel

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för belastningsutjämningsinställningarna LoadBalancingSettingsEgenskaper

LoadBalancingSettingsEgenskaper

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

Microsoft.Network/frontDoors

Namn Beskrivning Värde
apiVersion API-versionen '2020-05-01'
plats Resursplats. sträng
Namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Max längd = 5
Mönster = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (krävs)
Egenskaper Egenskaper för Front Door Load Balancer FrontDoorProperties
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.Network/frontDoors"

RedirectConfiguration

Namn 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åt vara tom 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 tom om du vill använda den inkommande sökvägen som målsökväg. sträng
customQueryString Den uppsättning 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 tom för att bevara den inkommande frågesträngen. Frågesträngen måste vara i <nyckel>=<värde> format. Den första? och & läggs till automatiskt så ta inte med dem i fronten, men separera flera frågesträngar med &. sträng
redirectProtocol Protokollet för målet till där trafiken omdirigeras "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Omdirigeringstypen som regeln ska använda vid omdirigering av trafik. "Hittades"
"Flyttad"
"PermanentRedirect"
"TemporaryRedirect"

ResourceTags

Namn Beskrivning Värde

RouteConfiguration

Namn Beskrivning Värde
@odata.type Ange till "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" för typen ForwardingConfiguration. Ange till "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" för typ RedirectConfiguration. "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs)

RoutingRule

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för Front Door-routningsregeln RoutingRuleProperties

RoutingRuleEgenskaper

Namn 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
rulesEngine En referens till en specifik regelmotorkonfiguration som ska tillämpas på den här vägen. SubResource
webApplicationFirewallPolicyLink Definierar brandväggsprincipen för webbaserade program för varje routningsregel (om tillämpligt) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Namn Beskrivning Värde
Id Resurs-ID. sträng

SubResource

Namn Beskrivning Värde
Id Resurs-ID. sträng

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
Lägg 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
Lägg 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
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.
Kontroll hälsoavsökningar för dina serverdelar på 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 en grundläggande Front Door-

Distribuera till Azure 		Den här mallen skapar en grundläggande Front Door-konfiguration med en enda serverdel.
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.
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 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 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.
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 eventuella statiska tillgångar för din arbetsbelastning.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen frontDoors kan distribueras med åtgärder som mål:

  • 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@2020-05-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"
                privateLinkLocation = "string"
                privateLinkResourceId = "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"
            }
          }
        }
      ]
    }
  })
}

RouteConfiguration-objekt

Ange egenskapen @odata.type för att ange typ av objekt.

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

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

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

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

Egenskapsvärden

Serverdel

Namn Beskrivning Värde
adress Plats för serverdelen (IP-adress eller FQDN) sträng
backendHostHeader Värdet som ska användas som värdrubriken som skickas till serverdelen. Om det är tomt eller ospecificerat är detta standardvärdet för den inkommande värden. 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

Begränsningar:
Minsta värde = 1
Maxvärde = 65535
httpsPort HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 65535
prioritering 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

Begränsningar:
Minsta värde = 1
Maxvärde = 5
privateLinkAlias Aliaset för Private Link-resursen. Att fylla i det här valfria fältet anger att den här serverdelen är "Privat" sträng
privateLinkApprovalMessage Ett anpassat meddelande som ska ingå i godkännandebegäran för att ansluta till Private Link sträng
privateLinkLocation Platsen för Private Link-resursen. Krävs endast om "privateLinkResourceId" har fyllts i sträng
privateLinkResourceId Resurs-ID för Private Link-resursen. Att fylla i det här valfria fältet anger att den här serverdelen är "Privat" sträng
vikt Den här slutpunktens vikt för belastningsutjämning. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 1 000

Serverdelspool

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för Front Door-serverdelspoolen BackendPoolProperties

BackendPoolEgenskaper

Namn Beskrivning Värde
serverdelar 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

BackendPoolsSettings

Namn 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"
sendRecvTimeoutSeconds Tidsgränsen för att skicka och ta emot vid vidarebefordran av begäran till serverdelen. När tidsgränsen nås misslyckas begäran och returneras. Int

Begränsningar:
Minsta värde = 16

CacheConfiguration

Namn Beskrivning Värde
cacheDuration Hur länge innehållet måste cachelagras. Det tillåtna formatet är i ISO 8601-format (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP kräver att värdet inte är längre än ett år sträng
dynamicCompression Om dynamisk komprimering ska användas för cachelagrat innehåll "Inaktiverad"
"Aktiverad"
queryParameters frågeparametrar som ska inkluderas eller exkluderas (kommaavgränsade). sträng
queryParameterStripDirective Behandling av URL-frågetermer när du bildar cachenyckeln. "StripAll"
"StripAllExcept"
"StripNone"
"StripOnly"

VidarebefordranKonfiguration

Namn 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åt vara tom om du vill använda inkommande sökväg. sträng
forwardingProtocol Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. "HttpOnly"
"HttpsOnly"
"MatchRequest"

FrontDoorProperties

Namn Beskrivning Värde
backendPools Serverdelspooler som är tillgängliga för routningsregler. BackendPool[]
backendPoolsSettings Inställningar för alla serverdelspooler 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[]

FrontendEndpoint

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för klientdelsslutpunkten FrontendEndpointProperties

FrontendEndpointProperties

Namn Beskrivning Värde
hostName Värdnamnet för klientdelenEndpoint. Måste vara ett domännamn. sträng
sessionAffinityEnabledState Om du vill tillåta sessionstillhörighet på den här värden. Giltiga alternativ är "Aktiverade" eller "Inaktiverade" "Inaktiverad"
"Aktiverad"
sessionAffinityTtlSeconds OANVÄND. Det här fältet ignoreras. Den TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. Int
webApplicationFirewallPolicyLink Definierar brandväggsprincipen för webbprogram för varje värd (om tillämpligt) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Namn Beskrivning Värde
Id Resurs-ID. sträng

HealthProbeSettingsModel

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för hälsoavsökningsinställningarna HealthProbeSettingsEgenskaper

HealthProbeSettingsProperties

Namn Beskrivning Värde
enabledState Om du vill aktivera hälsoavsökningar mot serverdelar som definierats under backendPools. Hälsoavsökningar kan bara inaktiveras om det finns en enda aktiverad serverdel i en enda aktiverad serverdelspool. "Inaktiverad"
"Aktiverad"
healthProbeMethod Konfigurerar vilken HTTP-metod som ska användas för att avsöka de serverdelar som definierats under backendPools. "GET"
"HEAD"
intervalInSeconds Antalet sekunder mellan hälsoavsökningar. Int
stig Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ sträng
protokoll Protokollschema som ska användas för den här avsökningen "Http"
"Https"

LoadBalancingSettingsModel

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för belastningsutjämningsinställningarna LoadBalancingSettingsEgenskaper

LoadBalancingSettingsEgenskaper

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

Microsoft.Network/frontDoors

Namn Beskrivning Värde
plats Resursplats. sträng
Namn Resursnamnet sträng

Begränsningar:
Minsta längd = 5
Max längd = 5
Mönster = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (krävs)
Egenskaper Egenskaper för Front Door Load Balancer FrontDoorProperties
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.Network/frontDoors@2020-05-01"

RedirectConfiguration

Namn 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åt vara tom 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 tom om du vill använda den inkommande sökvägen som målsökväg. sträng
customQueryString Den uppsättning 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 tom för att bevara den inkommande frågesträngen. Frågesträngen måste vara i <nyckel>=<värde> format. Den första? och & läggs till automatiskt så ta inte med dem i fronten, men separera flera frågesträngar med &. sträng
redirectProtocol Protokollet för målet till där trafiken omdirigeras "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Omdirigeringstypen som regeln ska använda vid omdirigering av trafik. "Hittades"
"Flyttad"
"PermanentRedirect"
"TemporaryRedirect"

ResourceTags

Namn Beskrivning Värde

RouteConfiguration

Namn Beskrivning Värde
@odata.type Ange till "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" för typen ForwardingConfiguration. Ange till "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" för typ RedirectConfiguration. "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs)

RoutingRule

Namn Beskrivning Värde
Id Resurs-ID. sträng
Namn Resursnamn. sträng
Egenskaper Egenskaper för Front Door-routningsregeln RoutingRuleProperties

RoutingRuleEgenskaper

Namn 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
rulesEngine En referens till en specifik regelmotorkonfiguration som ska tillämpas på den här vägen. SubResource
webApplicationFirewallPolicyLink Definierar brandväggsprincipen för webbaserade program för varje routningsregel (om tillämpligt) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Namn Beskrivning Värde
Id Resurs-ID. sträng

SubResource

Namn Beskrivning Värde
Id Resurs-ID. sträng