Sdílet prostřednictvím


Microsoft.Network frontDoors

Definice prostředku Bicep

Typ prostředku frontDoors je možné nasadit do:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Network/frontDoors, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Network/frontDoors@2021-06-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
              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'
          }
        }
      }
    ]
  }
}

Objekty RouteConfiguration

Nastavte vlastnost @odata.type a určete typ objektu.

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration použijte:

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

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration použijte:

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

Hodnoty vlastností

frontDoors

Název Description Hodnota
name Název prostředku string (povinné)

Omezení počtu znaků: 5–64

Platné znaky:
Alfanumerické znaky a pomlčky.

Začátek a konec alfanumerickými znaky

Název prostředku musí být v rámci Azure jedinečný.
location Umístění prostředku. řetězec
tags Značky prostředků. Slovník názvů a hodnot značek. Zobrazit značky v šablonách
properties Vlastnosti Load Balancer služby Front Door Vlastnosti frontdoor

Vlastnosti frontdoor

Název Description Hodnota
back-endPools Back-endové fondy dostupné pro pravidla směrování Back-endPool[]
back-endPoolsNastavení Nastavení pro všechny back-endové fondy BackendPoolsSettings
enabledState Provozní stav nástroje pro vyrovnávání zatížení služby Front Door. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
Friendlyname Popisný název pro frontDoor řetězec
frontendEndpoints Koncové body front-endu dostupné pro pravidla směrování FrontendEndpoint[]
healthProbeSettings Nastavení sondy stavu přidružené k této instanci služby Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Nastavení vyrovnávání zatížení přidružené k této instanci služby Front Door. LoadBalancingSettingsModel[]
pravidla směrování Pravidla směrování přidružená k této službě Front Door Směrovací pravidla[]

Back-endový fond

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti back-endového fondu služby Front Door BackendPoolVlastnosti

BackendPoolVlastnosti

Název Description Hodnota
Backendy Sada back-endů pro tento fond Back-end[]
healthProbeSettings Nastavení sondy stavu L7 pro back-endový fond Dílčí zdroj
loadBalancingSettings Nastavení vyrovnávání zatížení pro back-endový fond Dílčí zdroj

Back-end

Název Description Hodnota
adresa Umístění back-endu (IP adresa nebo plně kvalifikovaný název domény) řetězec
backendHostHeader Hodnota, která se má použít jako hlavička hostitele odeslaná do back-endu. Pokud je hodnota prázdná nebo nespecifikovaná, použije se výchozí hodnota příchozího hostitele. řetězec
enabledState Jestli chcete povolit použití tohoto back-endu. Povolené hodnoty jsou Povoleno nebo Zakázáno. Zakázáno
'Povoleno'
httpPort Číslo portu HTTP TCP. Musí být mezi 1 a 65535. int
httpsPort Číslo portu TCP https. Musí být mezi 1 a 65535. int
Prioritou Priorita, která se má použít pro vyrovnávání zatížení Pokud je back-end s nižší prioritou v pořádku, vyšší priority se pro vyrovnávání zatížení nepoužijí. int
privateLinkAlias Alias prostředku Private Link. Vyplnění tohoto volitelného pole znamená, že tento back-end je privátní. řetězec
privateLinkApprovalMessage Vlastní zpráva, která se má zahrnout do žádosti o schválení pro připojení k Private Link řetězec
privateLinkLocation Umístění prostředku Private Link. Povinné pouze v případě, že je vyplněna hodnota privateLinkResourceId. řetězec
privateLinkResourceId ID prostředku Private Link. Vyplnění tohoto volitelného pole znamená, že tento back-end je privátní. řetězec
hmotnost Váha tohoto koncového bodu pro účely vyrovnávání zatížení int

Dílčí zdroj

Název Description Hodnota
id ID prostředku. řetězec

Back-endPoolsSettings

Název Description Hodnota
enforceCertificateNameCheck Jestli se má vynucovat kontrola názvu certifikátu u požadavků HTTPS na všechny back-endové fondy. Žádný vliv na požadavky jiného typu než HTTPS. Zakázáno
'Povoleno'
sendRecvTimeoutSeconds Vypršení časového limitu odesílání a příjmu při žádosti o přeposílání do back-endu Po dosažení časového limitu požadavek selže a vrátí se. int

FrontendEndpoint

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti koncového bodu front-endu FrontendEndpointProperties

FrontendEndpointProperties

Název Description Hodnota
Hostname Název hostitele frontendendového bodu. Musí to být název domény. řetězec
sessionAffinityEnabledState Jestli se má povolit spřažení relací na tomto hostiteli. Platné možnosti jsou Povoleno nebo Zakázáno. Zakázáno
'Povoleno'
sessionAffinityTtlSeconds NEPOUŽITÉ. Toto pole bude ignorováno. Hodnota TTL, která se použije v sekundách pro spřažení relací, pokud je k dispozici. int
webApplicationFirewallPolicyLink Definuje zásady Web Application Firewall pro každého hostitele (pokud je k dispozici). FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Název Description Hodnota
id ID prostředku. řetězec

HealthProbeSettingsModel

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti nastavení sondy stavu HealthProbeSettingsProperties

HealthProbeSettingsProperties

Název Description Hodnota
enabledState Jestli chcete povolit, aby se pro back-endy definované v back-endových fondech provedly sondy stavu. Sondy stavu je možné zakázat pouze v případě, že je v jednom povoleném back-endovém fondu jeden povolený back-end. Zakázáno
'Povoleno'
healthProbeMethod Konfiguruje metodu HTTP, která se má použít k sondování back-endů definovaných v back-endpools. 'GET'
'HEAD'
intervalInSeconds Počet sekund mezi sondami stavu. int
program Cesta, která se má použít pro sondu stavu. Výchozí hodnota je / řetězec
Protokol Schéma protokolu, které se má použít pro tuto sondu Http
Https

LoadBalancingSettingsModel

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti nastavení vyrovnávání zatížení LoadBalancingSettingsVlastnosti

LoadBalancingSettingsVlastnosti

Název Description Hodnota
additionalLatencyMilliseconds Další latence v milisekundách, aby sondy spadly do kbelíku s nejnižší latencí int
sampleSize Počet vzorků, které je třeba vzít v úvahu při rozhodování o vyrovnávání zatížení int
successfulSamplesRequired Počet vzorků během období výběru, které musí být úspěšné int

RoutingRule

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti pravidla směrování služby Front Door RoutingRuleProperties

RoutingRuleProperties

Název Description Hodnota
acceptedProtocols Schémata protokolů, která se mají shodovat s tímto pravidlem Pole řetězců obsahující některou z těchto možností:
Http
Https
enabledState Zda se má povolit použití tohoto pravidla. Povolené hodnoty jsou Povoleno nebo Zakázáno. Zakázáno
'Povoleno'
frontendEndpoints Koncové body front-endu přidružené k tomuto pravidlu SubResource[]
patternsToMatch Vzory tras pravidla. string[]
routeConfiguration Odkaz na konfiguraci směrování. Konfigurace trasy
rulesEngine Odkaz na konkrétní konfiguraci modulu pravidel, která se má použít pro tuto trasu. Dílčí zdroj
webApplicationFirewallPolicyLink Definuje zásady Web Application Firewall pro každé pravidlo směrování (pokud je k dispozici). RoutingRuleUpdateParametersWebApplicationFirewallPol...

Konfigurace trasy

Název Description Hodnota
@odata.type Nastavení typu objektu #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)

Konfigurace předávání

Název Description Hodnota
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (povinné)
back-endPool Odkaz na BackendPool, do kterého toto pravidlo směruje. Dílčí zdroj
cacheConfiguration Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. Konfigurace mezipaměti
customForwardingPath Vlastní cesta použitá k přepsání cest k prostředkům, které odpovídají tomuto pravidlu. Pokud chcete použít příchozí cestu, nechejte prázdnou. řetězec
forwardingProtocol Protokol, který toto pravidlo použije při předávání provozu do back-endů. HttpOnly
HttpsOnly
'MatchRequest'

Konfigurace mezipaměti

Název Description Hodnota
cacheDuration Doba trvání, po kterou se musí obsah ukládat do mezipaměti. Povolený formát je ve formátu ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP vyžaduje, aby hodnota nebyla delší než rok. řetězec
dynamicCompression Použití dynamické komprese pro obsah uložený v mezipaměti Zakázáno
'Povoleno'
queryParameters parametry dotazu, které se mají zahrnout nebo vyloučit (oddělené čárkami). řetězec
queryParameterStripDirective Zpracování výrazů dotazu adresy URL při vytváření klíče mezipaměti. 'StripAll'
'StripAllExcept'
StripNone
"StripOnly"

RedirectConfiguration

Název Description Hodnota
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (povinné)
customFragment Fragment, který se má přidat do adresy URL pro přesměrování. Fragment je část adresy URL, která přichází za #. Nezahrnujte soubor #. řetězec
vlastní hostitel Hostitel, který se má přesměrovat. Pokud chcete jako cílového hostitele použít příchozího hostitele, ponechte prázdné. řetězec
customPath Úplná cesta k přesměrování. Cesta nemůže být prázdná a musí začínat na /. Pokud chcete jako cílovou cestu použít příchozí cestu, ponechte prázdnou. řetězec
customQueryString Sada řetězců dotazu, které se mají umístit do adresy URL pro přesměrování. Nastavení této hodnoty by nahradilo jakýkoli existující řetězec dotazu; ponechte prázdný, aby se zachoval řetězec příchozího dotazu. Řetězec dotazu musí být ve formátu {key}={value}. První ? a & se přidají automaticky, takže je nezahrnujte do popředí, ale oddělujte několik řetězců dotazu pomocí &. řetězec
redirectProtocol Protokol cíle, kam se provoz přesměruje HttpOnly
HttpsOnly
'MatchRequest'
redirectType Typ přesměrování, který pravidlo použije při přesměrování provozu. 'Nalezeno'
'Přesunuto'
PermanentRedirect
TemporaryRedirect

RoutingRuleUpdateParametersWebApplicationFirewallPol...

Název Description Hodnota
id ID prostředku. řetězec

Šablony pro rychlý start

Následující šablony pro rychlý start nasadí tento typ prostředku.

Template (Šablona) Description
Vytvoření služby Azure Front Door před azure API Management

Nasazení do Azure
Tato ukázka ukazuje použití služby Azure Front Door jako globálního nástroje pro vyrovnávání zatížení před azure API Management.
Vytvoření základní služby Front Door

Nasazení do Azure
Tato šablona vytvoří základní konfiguraci služby Front Door s jedním back-endem.
Vytvoření služby Front Door s povoleným ukládáním do mezipaměti pro určité trasy

Nasazení do Azure
Tato šablona vytvoří službu Front Door s povoleným ukládáním do mezipaměti pro definovanou konfiguraci směrování, a tím do mezipaměti ukládají všechny statické prostředky pro vaši úlohu.
Vytvoření služby Front Door s několika back-endy a back-endovými fondy

Nasazení do Azure
Tato šablona vytvoří službu Front Door s vyrovnáváním zatížení nakonfigurovaným pro více back-endů v back-endovém fondu a také napříč back-endovými fondy na základě cesty URL.
Vytvoření služby Front Door s přesměrováním z HTTP na HTTPS

Nasazení do Azure
Tato šablona vytvoří konfiguraci služby Front Door pro přesměrování HTTP na HTTPS.
Přidání vlastní domény a spravovaného certifikátu pomocí služby Front Door

Nasazení do Azure
Tato šablona nasadí a zabezpečí vlastní doménu pomocí služby Front Door.
Přidání vlastní domény a vlastního certifikátu pomocí služby Front Door

Nasazení do Azure
Tato šablona nasadí a zabezpečí vlastní doménu se službou Front Door pomocí certifikátu spravovaného zákazníkem.
Řízení sond stavu pro back-endy ve službě Front Door

Nasazení do Azure
Tato šablona aktualizuje službu Front Door tak, aby změnila nastavení sondy stavu nastavením cesty sondy a také intervalů, ve kterých se budou sondy odesílat.
Vytvoření služby Front Door s Active-Standby konfigurací

Nasazení do Azure
Tato šablona vytvoří službu Front Door, která demonstruje směrování na základě priority pro Active-Standby topologii aplikací.
Konfigurace spřažení relací pro názvy hostitelů služby Front Door

Nasazení do Azure
Tato šablona aktualizuje službu Front Door tak, aby umožňovala spřažení relací pro vašeho front-endového hostitele, a tím odesílá následný provoz ze stejné uživatelské relace do stejného back-endu.

Definice prostředku šablony ARM

Typ prostředku frontDoors je možné nasadit do:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Network/frontDoors, přidejte do šablony následující kód JSON.

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2021-06-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",
              "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"
          }
        }
      }
    ]
  }
}

Objekty RouteConfiguration

Nastavte vlastnost @odata.type a určete typ objektu.

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration použijte:

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

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration použijte:

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

Hodnoty vlastností

frontDoors

Název Description Hodnota
typ Typ prostředku Microsoft.Network/frontDoors
apiVersion Verze rozhraní API prostředku '2021-06-01'
name Název prostředku string (povinné)

Omezení počtu znaků: 5–64

Platné znaky:
Alfanumerické znaky a pomlčky.

Začátek a konec alfanumerickými znaky

Název prostředku musí být v rámci Azure jedinečný.
location Umístění prostředku. řetězec
tags Značky prostředků. Slovník názvů a hodnot značek. Zobrazit značky v šablonách
properties Vlastnosti Load Balancer služby Front Door Vlastnosti frontdoor

Vlastnosti frontdoor

Název Description Hodnota
back-endPools Back-endové fondy dostupné pro pravidla směrování Back-endPool[]
back-endPoolsNastavení Nastavení pro všechny back-endové fondy BackendPoolsSettings
enabledState Provozní stav nástroje pro vyrovnávání zatížení služby Front Door. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
Friendlyname Popisný název pro frontDoor řetězec
frontendEndpoints Koncové body front-endu dostupné pro pravidla směrování FrontendEndpoint[]
healthProbeSettings Nastavení sondy stavu přidružené k této instanci služby Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Nastavení vyrovnávání zatížení přidružené k této instanci služby Front Door. LoadBalancingSettingsModel[]
pravidla směrování Pravidla směrování přidružená k této službě Front Door Směrovací pravidla[]

Back-endový fond

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti back-endového fondu služby Front Door BackendPoolVlastnosti

BackendPoolVlastnosti

Název Description Hodnota
Backendy Sada back-endů pro tento fond Back-end[]
healthProbeSettings Nastavení sondy stavu L7 pro back-endový fond Dílčí zdroj
loadBalancingSettings Nastavení vyrovnávání zatížení pro back-endový fond Dílčí zdroj

Back-end

Název Description Hodnota
adresa Umístění back-endu (IP adresa nebo plně kvalifikovaný název domény) řetězec
backendHostHeader Hodnota, která se použije jako hlavička hostitele odeslaná do back-endu. Pokud je toto pole prázdné nebo neurčené, použije se výchozí hodnota příchozího hostitele. řetězec
enabledState Jestli se má povolit použití tohoto back-endu. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
httpPort Číslo portu HTTP TCP. Musí být mezi 1 a 65535. int
httpsPort Číslo portu HTTPS TCP. Musí být mezi 1 a 65535. int
Prioritou Priorita, která se má použít pro vyrovnávání zatížení. Pokud je back-end s nižší prioritou v pořádku, vyšší priority se pro vyrovnávání zatížení nepoužijí. int
privateLinkAlias Alias prostředku Private Link. Vyplnění tohoto volitelného pole znamená, že tento back-end je privátní. řetězec
privateLinkApprovalMessage Vlastní zpráva, která se má zahrnout do žádosti o schválení pro připojení k Private Link řetězec
privateLinkLocation Umístění prostředku Private Link. Povinné pouze v případě, že se vyplní privateLinkResourceId. řetězec
privateLinkResourceId ID prostředku Private Link. Vyplnění tohoto volitelného pole znamená, že tento back-end je privátní. řetězec
hmotnost Váha tohoto koncového bodu pro účely vyrovnávání zatížení int

Dílčí zdroj

Název Description Hodnota
id ID prostředku. řetězec

BackendPoolsSettings

Název Description Hodnota
enforceCertificateNameCheck Jestli se má vynucovat kontrola názvu certifikátu u požadavků HTTPS na všechny back-endové fondy. Na požadavky jiného typu než HTTPS nemá žádný vliv. Zakázáno
Povoleno
sendRecvTimeoutSeconds Vypršení časového limitu odesílání a přijímání požadavků na přeposílání do back-endu Po dosažení časového limitu požadavek selže a vrátí se. int

Koncový bod front-endu

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti koncového bodu front-endu Vlastnosti koncového bodu front-endu

Vlastnosti koncového bodu front-endu

Název Description Hodnota
Hostname Název hostitele frontendEndpoint. Musí to být název domény. řetězec
sessionAffinityEnabledState Zda povolit spřažení relace na tomto hostiteli. Platné možnosti jsou Povoleno nebo Zakázáno. Zakázáno
Povoleno
sessionAffinityTtlSeconds NEPOUŽITÉ. Toto pole bude ignorováno. Hodnota TTL, která se použije v sekundách pro spřažení relací, pokud je k dispozici. int
webApplicationFirewallPolicyLink Definuje zásady Web Application Firewall pro každého hostitele (pokud je k dispozici). FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Název Description Hodnota
id ID prostředku. řetězec

HealthProbeSettingsModel

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti nastavení sondy stavu HealthProbeSettingsVlastnosti

HealthProbeSettingsVlastnosti

Název Description Hodnota
enabledState Jestli chcete povolit, aby se sondy stavu pro back-endy definované v rámci backendPools. Sondy stavu je možné zakázat pouze v případě, že je v jednom povoleném back-endovém fondu jeden povolený back-end. Zakázáno
Povoleno
healthProbeMethod Nakonfiguruje metodu HTTP, která se má použít k sondování back-endů definovaných v rámci backendPools. GET
'HEAD'
intervalInSeconds Počet sekund mezi sondami stavu. int
program Cesta, která se má použít pro sondu stavu. Výchozí hodnota je / řetězec
Protokol Schéma protokolu, které se má použít pro tuto sondu Http
Https

LoadBalancingSettingsModel

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti nastavení vyrovnávání zatížení LoadBalancingSettingsVlastnosti

LoadBalancingSettingsVlastnosti

Název Description Hodnota
additionalLatencyMilliseconds Dodatečná latence v milisekundách, aby sondy spadly do kbelíku s nejnižší latencí int
velikost vzorku Počet vzorků, které se mají zvážit při rozhodování o vyrovnávání zatížení int
successfulSamplesRequired Počet vzorků během období výběru, které musí být úspěšné int

RoutingRule

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti pravidla směrování služby Front Door RoutingRuleProperties

RoutingRuleProperties

Název Description Hodnota
přijatoProtocols Schémata protokolů, která se mají pro toto pravidlo shodovat Pole řetězců obsahující některou z těchto možností:
Http
Https
enabledState Určuje, jestli se má povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
frontendEndpoints Koncové body front-endu přidružené k tomuto pravidlu Dílčí zdroj[]
vzoryToMatch Vzory tras pravidla. string[]
konfigurace trasy Odkaz na konfiguraci směrování. Konfigurace trasy
pravidlaEngine Odkaz na konkrétní konfiguraci stroje pravidel, která se použije pro tuto trasu. Dílčí zdroj
webApplicationFirewallPolicyLink Definuje zásady Web Application Firewall pro každé pravidlo směrování (pokud je k dispozici). RoutingRuleUpdateParametersWebApplicationFirewallPol...

Konfigurace trasy

Název Description Hodnota
@odata.type Nastavení typu objektu #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)

ForwardingConfiguration

Název Description Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration (povinné)
back-endPool Odkaz na back-endpool, do kterého se toto pravidlo směruje. Dílčí zdroj
konfigurace mezipaměti Konfigurace ukládání do mezipaměti přidružené k tomuto pravidlu. Konfigurace mezipaměti
customForwardingPath Vlastní cesta používaná k přepsání cest k prostředkům, které odpovídají tomuto pravidlu. Pokud chcete použít příchozí cestu, ponechejte prázdnou. řetězec
forwardingProtocol Protokol, který toto pravidlo použije při předávání provozu do back-endů. HttpOnly
HttpsOnly
'MatchRequest'

Konfigurace mezipaměti

Název Description Hodnota
cacheDuration Doba, po kterou se obsah musí ukládat do mezipaměti. Povolený formát je ve formátu ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Http vyžaduje, aby hodnota nebyla delší než rok. řetězec
dynamicCompression Jestli se má použít dynamická komprese pro obsah uložený v mezipaměti Zakázáno
Povoleno
parametry dotazu parametry dotazu, které se mají zahrnout nebo vyloučit (oddělené čárkami). řetězec
queryParameterStripDirective Zpracování termínů dotazu adresy URL při vytváření klíče mezipaměti. 'StripAll'
'StripAllExcept'
'StripNone'
'StripOnly'

RedirectConfiguration

Název Description Hodnota
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (povinné)
customFragment Fragment, který se má přidat do adresy URL pro přesměrování. Fragment je část adresy URL, která následuje za #. Nezahrnujte soubor #. řetězec
vlastní hostitel Hostitel, který se má přesměrovat. Ponechte prázdné, pokud chcete jako cílového hostitele použít příchozího hostitele. řetězec
vlastní cesta Úplná cesta k přesměrování. Cesta nemůže být prázdná a musí začínat na /. Ponechte prázdnou, pokud chcete jako cílovou cestu použít příchozí cestu. řetězec
customQueryString Sada řetězců dotazu, které se mají umístit do adresy URL pro přesměrování. Nastavení této hodnoty by nahradilo všechny existující řetězce dotazu; ponechte prázdnou, aby se zachoval řetězec příchozího dotazu. Řetězec dotazu musí být ve formátu {key}={value}. První ? a & se přidají automaticky, takže je nezahrnujte do popředí, ale oddělujte více řetězců dotazů pomocí &. řetězec
redirectProtocol Protokol cíle, kam se provoz přesměruje HttpOnly
HttpsOnly
'MatchRequest'
typ přesměrování Typ přesměrování, který pravidlo použije při přesměrování provozu. "Nalezeno"
Přesunuto
PermanentRedirect
TemporaryRedirect

RoutingRuleUpdateParametersWebApplicationFirewallPol...

Název Description Hodnota
id ID prostředku. řetězec

Šablony pro rychlý start

Následující šablony pro rychlý start nasadí tento typ prostředku.

Template (Šablona) Description
Vytvoření služby Azure Front Door před azure API Management

Nasazení do Azure
Tato ukázka ukazuje použití služby Azure Front Door jako globálního nástroje pro vyrovnávání zatížení před azure API Management.
Vytvoření základní služby Front Door

Nasazení do Azure
Tato šablona vytvoří základní konfiguraci služby Front Door s jedním back-endem.
Vytvoření služby Front Door s povoleným ukládáním do mezipaměti pro určité trasy

Nasazení do Azure
Tato šablona vytvoří službu Front Door s povoleným ukládáním do mezipaměti pro definovanou konfiguraci směrování, a tím do mezipaměti ukládají všechny statické prostředky pro vaši úlohu.
Vytvoření služby Front Door s několika back-endy a back-endovými fondy

Nasazení do Azure
Tato šablona vytvoří službu Front Door s vyrovnáváním zatížení nakonfigurovaným pro více back-endů v back-endovém fondu a také napříč back-endovými fondy na základě cesty URL.
Vytvoření služby Front Door s přesměrováním z HTTP na HTTPS

Nasazení do Azure
Tato šablona vytvoří konfiguraci služby Front Door pro přesměrování HTTP na HTTPS.
Přidání vlastní domény a spravovaného certifikátu pomocí služby Front Door

Nasazení do Azure
Tato šablona nasadí a zabezpečí vlastní doménu pomocí služby Front Door.
Přidání vlastní domény a vlastního certifikátu pomocí služby Front Door

Nasazení do Azure
Tato šablona nasadí a zabezpečí vlastní doménu se službou Front Door pomocí certifikátu spravovaného zákazníkem.
Řízení sond stavu pro back-endy ve službě Front Door

Nasazení do Azure
Tato šablona aktualizuje službu Front Door tak, aby změnila nastavení sondy stavu nastavením cesty sondy a také intervalů, ve kterých se budou sondy odesílat.
Vytvoření služby Front Door s Active-Standby konfigurací

Nasazení do Azure
Tato šablona vytvoří službu Front Door, která demonstruje směrování na základě priority pro Active-Standby topologii aplikací.
Konfigurace spřažení relací pro názvy hostitelů služby Front Door

Nasazení do Azure
Tato šablona aktualizuje službu Front Door tak, aby umožňovala spřažení relací pro vašeho front-endového hostitele, a tím odesílá následný provoz ze stejné uživatelské relace do stejného back-endu.

Definice prostředku Terraform (poskytovatel AzAPI)

Typ prostředku frontDoors je možné nasadit do:

  • Skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Network/frontDoors, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2021-06-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
                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"
            }
          }
        }
      ]
    }
  })
}

Objekty RouteConfiguration

Nastavte vlastnost @odata.type a určete typ objektu.

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration použijte:

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

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration použijte:

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

Hodnoty vlastností

frontDoors

Název Description Hodnota
typ Typ prostředku Microsoft.Network/frontDoors@2021-06-01
name Název prostředku string (povinné)

Omezení počtu znaků: 5–64

Platné znaky:
Alfanumerické znaky a pomlčky.

Začátek a konec alfanumerickými znaky

Název prostředku musí být v rámci Azure jedinečný.
location Umístění prostředku. řetězec
parent_id K nasazení do skupiny prostředků použijte ID této skupiny prostředků. string (povinné)
tags Značky prostředků. Slovník názvů a hodnot značek.
properties Vlastnosti Load Balancer služby Front Door Vlastnosti frontdoor

Vlastnosti frontdoor

Název Description Hodnota
back-endPools Back-endové fondy dostupné pro pravidla směrování Back-endPool[]
back-endPoolsNastavení Nastavení pro všechny back-endové fondy BackendPoolsSettings
enabledState Provozní stav nástroje pro vyrovnávání zatížení služby Front Door. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). "Zakázáno"
"Povoleno"
Friendlyname Popisný název pro frontDoor řetězec
frontendEndpoints Koncové body front-endu dostupné pro pravidla směrování FrontendEndpoint[]
healthProbeSettings Nastavení sondy stavu přidružené k této instanci služby Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Nastavení vyrovnávání zatížení přidružené k této instanci služby Front Door. LoadBalancingSettingsModel[]
pravidla směrování Pravidla směrování přidružená k této službě Front Door Směrovací pravidla[]

Back-endový fond

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti back-endového fondu služby Front Door BackendPoolVlastnosti

BackendPoolVlastnosti

Název Description Hodnota
Backendy Sada back-endů pro tento fond Back-end[]
healthProbeSettings Nastavení sondy stavu L7 pro back-endový fond Dílčí zdroj
loadBalancingSettings Nastavení vyrovnávání zatížení pro back-endový fond Dílčí zdroj

Back-end

Název Description Hodnota
adresa Umístění back-endu (IP adresa nebo plně kvalifikovaný název domény) řetězec
backendHostHeader Hodnota, která se použije jako hlavička hostitele odeslaná do back-endu. Pokud je toto pole prázdné nebo neurčené, použije se výchozí hodnota příchozího hostitele. řetězec
enabledState Jestli se má povolit použití tohoto back-endu. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). "Zakázáno"
"Povoleno"
httpPort Číslo portu HTTP TCP. Musí být mezi 1 a 65535. int
httpsPort Číslo portu HTTPS TCP. Musí být mezi 1 a 65535. int
Prioritou Priorita, která se má použít pro vyrovnávání zatížení. Pokud je back-end s nižší prioritou v pořádku, vyšší priority se pro vyrovnávání zatížení nepoužijí. int
privateLinkAlias Alias prostředku Private Link. Vyplnění tohoto volitelného pole znamená, že tento back-end je privátní. řetězec
privateLinkApprovalMessage Vlastní zpráva, která se má zahrnout do žádosti o schválení pro připojení k Private Link řetězec
privateLinkLocation Umístění prostředku Private Link. Povinné pouze v případě, že se vyplní privateLinkResourceId. řetězec
privateLinkResourceId ID prostředku Private Link. Vyplnění tohoto volitelného pole znamená, že tento back-end je privátní. řetězec
hmotnost Váha tohoto koncového bodu pro účely vyrovnávání zatížení int

Dílčí zdroj

Název Description Hodnota
id ID prostředku. řetězec

BackendPoolsSettings

Název Description Hodnota
enforceCertificateNameCheck Jestli se má vynucovat kontrola názvu certifikátu u požadavků HTTPS na všechny back-endové fondy. Na požadavky jiného typu než HTTPS nemá žádný vliv. "Zakázáno"
"Povoleno"
sendRecvTimeoutSeconds Vypršení časového limitu odesílání a přijímání požadavků na přeposílání do back-endu Po dosažení časového limitu požadavek selže a vrátí se. int

Koncový bod front-endu

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti koncového bodu front-endu Vlastnosti koncového bodu front-endu

Vlastnosti koncového bodu front-endu

Název Description Hodnota
Hostname Název hostitele frontendEndpoint. Musí to být název domény. řetězec
sessionAffinityEnabledState Zda povolit spřažení relace na tomto hostiteli. Platné možnosti jsou Povoleno nebo Zakázáno. "Zakázáno"
"Povoleno"
sessionAffinityTtlSeconds NEPOUŽITÉ. Toto pole bude ignorováno. Hodnota TTL, která se použije v sekundách pro spřažení relací, pokud je k dispozici. int
webApplicationFirewallPolicyLink Definuje zásady Web Application Firewall pro každého hostitele (pokud je k dispozici). FrontendEndpointUpdateParametersWebApplicationFirewa...

FrontendEndpointUpdateParametersWebApplicationFirewa...

Název Description Hodnota
id ID prostředku. řetězec

HealthProbeSettingsModel

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti nastavení sondy stavu HealthProbeSettingsVlastnosti

HealthProbeSettingsVlastnosti

Název Description Hodnota
enabledState Jestli chcete povolit, aby se sondy stavu pro back-endy definované v rámci backendPools. Sondy stavu je možné zakázat pouze v případě, že je v jednom povoleném back-endovém fondu jeden povolený back-end. "Zakázáno"
"Povoleno"
healthProbeMethod Nakonfiguruje metodu HTTP, která se má použít k sondování back-endů definovaných v rámci backendPools. "GET"
"HEAD"
intervalInSeconds Počet sekund mezi sondami stavu. int
program Cesta, která se má použít pro sondu stavu. Výchozí hodnota je / řetězec
Protokol Schéma protokolu, které se má použít pro tuto sondu "Http"
"Https"

LoadBalancingSettingsModel

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti nastavení vyrovnávání zatížení LoadBalancingSettingsVlastnosti

LoadBalancingSettingsVlastnosti

Název Description Hodnota
additionalLatencyMilliseconds Dodatečná latence v milisekundách, aby sondy spadly do kbelíku s nejnižší latencí int
velikost vzorku Počet vzorků, které se mají zvážit při rozhodování o vyrovnávání zatížení int
successfulSamplesRequired Počet vzorků během období výběru, které musí být úspěšné int

RoutingRule

Název Description Hodnota
id ID prostředku. řetězec
name Název prostředku. řetězec
properties Vlastnosti pravidla směrování služby Front Door RoutingRuleProperties

RoutingRuleProperties

Název Description Hodnota
přijatoProtocols Schémata protokolů, která se mají pro toto pravidlo shodovat Pole řetězců obsahující některou z těchto možností:
"Http"
"Https"
enabledState Určuje, jestli se má povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). "Zakázáno"
"Povoleno"
frontendEndpoints Koncové body front-endu přidružené k tomuto pravidlu Dílčí zdroj[]
vzoryToMatch Vzory tras pravidla. string[]
konfigurace trasy Odkaz na konfiguraci směrování. Konfigurace trasy
pravidlaEngine Odkaz na konkrétní konfiguraci stroje pravidel, která se použije pro tuto trasu. Dílčí zdroj
webApplicationFirewallPolicyLink Definuje zásady Web Application Firewall pro každé pravidlo směrování (pokud je k dispozici). RoutingRuleUpdateParametersWebApplicationFirewallPol...

Konfigurace trasy

Název Description Hodnota
@odata.type Nastavení typu objektu #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)

ForwardingConfiguration

Název Description Hodnota
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (povinné)
back-endPool Odkaz na back-endpool, do kterého se toto pravidlo směruje. Dílčí zdroj
konfigurace mezipaměti Konfigurace ukládání do mezipaměti přidružené k tomuto pravidlu. Konfigurace mezipaměti
customForwardingPath Vlastní cesta používaná k přepsání cest k prostředkům, které odpovídají tomuto pravidlu. Pokud chcete použít příchozí cestu, nechejte prázdnou. řetězec
forwardingProtocol Protokol, který toto pravidlo použije při předávání provozu do back-endů. "HttpOnly"
"HttpsOnly"
"MatchRequest"

Konfigurace mezipaměti

Název Description Hodnota
cacheDuration Doba trvání, po kterou se musí obsah ukládat do mezipaměti. Povolený formát je ve formátu ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). HTTP vyžaduje, aby hodnota nebyla delší než rok. řetězec
dynamicCompression Použití dynamické komprese pro obsah uložený v mezipaměti "Zakázáno"
"Povoleno"
queryParameters parametry dotazu, které se mají zahrnout nebo vyloučit (oddělené čárkami). řetězec
queryParameterStripDirective Zpracování výrazů dotazu adresy URL při vytváření klíče mezipaměti. "StripAll"
"StripAllExcept"
"StripNone"
"StripOnly"

RedirectConfiguration

Název Description Hodnota
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (povinné)
customFragment Fragment, který se má přidat do adresy URL pro přesměrování. Fragment je část adresy URL, která přichází za #. Nezahrnujte soubor #. řetězec
vlastní hostitel Hostitel, který se má přesměrovat. Pokud chcete jako cílového hostitele použít příchozího hostitele, ponechte prázdné. řetězec
customPath Úplná cesta k přesměrování. Cesta nemůže být prázdná a musí začínat na /. Pokud chcete jako cílovou cestu použít příchozí cestu, ponechte prázdnou. řetězec
customQueryString Sada řetězců dotazu, které se mají umístit do adresy URL pro přesměrování. Nastavení této hodnoty by nahradilo jakýkoli existující řetězec dotazu; ponechte prázdný, aby se zachoval řetězec příchozího dotazu. Řetězec dotazu musí být ve formátu {key}={value}. První ? a & se přidají automaticky, takže je nezahrnujte do popředí, ale oddělujte několik řetězců dotazu pomocí &. řetězec
redirectProtocol Protokol cíle, kam se provoz přesměruje "HttpOnly"
"HttpsOnly"
"MatchRequest"
redirectType Typ přesměrování, který pravidlo použije při přesměrování provozu. "Nalezeno"
"Přesunuto"
"PermanentRedirect"
"TemporaryRedirect"

RoutingRuleUpdateParametersWebApplicationFirewallPol...

Název Description Hodnota
id ID prostředku. řetězec