Sdílet prostřednictvím


Microsoft.Network frontDoors 2019-04-01

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@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
          }
        }
      }
    ]
  }
}

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: {
    dynamicCompression: '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
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'

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 HealthProbeSettingsVlastnosti

HealthProbeSettingsVlastnosti

Název Description Hodnota
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

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
dynamicCompression Použití dynamické komprese pro obsah uložený v mezipaměti Zakázáno
'Povoleno'
queryParameterStripDirective Zpracování výrazů dotazu adresy URL při vytváření klíče mezipaměti. 'StripAll'
StripNone

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

Šablony pro rychlý start

Následující šablony rychlého startu 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, jak používat Službu Azure Front Door jako globální nástroj 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 povolenou ukládáním do mezipaměti pro definovanou konfiguraci směrování a tím do mezipaměti ukládat 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ří 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í z 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 pomocí služby 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 konfigurací Active-Standby

Nasazení do Azure
Tato šablona vytvoří službu Front Door, která ukazuje 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": "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
          }
        }
      }
    ]
  }
}

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": {
    "dynamicCompression": "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 '2019-04-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 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
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'

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
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

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
dynamicCompression Použití dynamické komprese pro obsah uložený v mezipaměti Zakázáno
'Povoleno'
queryParameterStripDirective Zpracování výrazů dotazu adresy URL při vytváření klíče mezipaměti. 'StripAll'
StripNone

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

Šablony pro rychlý start

Následující šablony rychlého startu 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, jak používat Službu Azure Front Door jako globální nástroj 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 povolenou ukládáním do mezipaměti pro definovanou konfiguraci směrování a tím do mezipaměti ukládat 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ří 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í z 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 pomocí služby 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 konfigurací Active-Standby

Nasazení do Azure
Tato šablona vytvoří službu Front Door, která ukazuje 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 Terraformu (zprostředkovatele 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@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
            }
          }
        }
      ]
    }
  })
}

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 = {
    dynamicCompression = "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í

přední vrátka

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

Limit počtu znaků: 5-64

Platné znaky:
Alfanumerické znaky a spojovníky.

Začátek a konec alfanumerickým znakem

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
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"

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
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

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
dynamicCompression Použití dynamické komprese pro obsah uložený v mezipaměti "Zakázáno"
"Povoleno"
queryParameterStripDirective Zpracování výrazů dotazu adresy URL při vytváření klíče mezipaměti. "StripAll"
"StripNone"

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"