Sdílet prostřednictvím


Microsoft.Network frontDoors 2019-04-01

Definice prostředku Bicep

Typ prostředku frontDoors je možné nasadit s operacemi, které cílí:

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' = {
  location: 'string'
  name: 'string'
  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
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Objekty RouteConfiguration

Nastavte vlastnost @odata.type určit typ objektu.

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationpouž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.FrontdoorRedirectConfigurationpoužijte:

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

Hodnoty vlastností

Microsoft.Network/frontDoors

Jméno Popis Hodnota
umístění Umístění prostředku řetězec
Jméno Název prostředku řetězec

Omezení:
Minimální délka = 5
Maximální délka = 64
Model = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (povinné)
vlastnosti Vlastnosti služby Front Door Load Balancer FrontDoorProperties
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

Back-end

Jméno Popis 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 odesílaná do back-endu. Pokud je prázdné nebo nezadané, výchozí hodnota je pro příchozího hostitele. řetězec
Povolený stav Jestli chcete povolit použití tohoto back-endu. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
Rozhraní httpPort Číslo portu HTTP TCP. Musí být v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
Protokol httpsPort Číslo portu HTTPS TCP. Musí být v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
priorita Priorita pro vyrovnávání zatížení. Pokud je back-end s nižší prioritou v pořádku, nebudou se pro vyrovnávání zatížení používat vyšší priority. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 5
hmotnost Váha tohoto koncového bodu pro účely vyrovnávání zatížení Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 1000

Fond back-endů

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti back-endového fondu služby Front Door back-endpoolProperties

Vlastnosti backendového bazénu

Jméno Popis Hodnota
back-endy Sada back-endů pro tento fond back-endové[]
Nastavení healthProbeSettings Nastavení sondy stavu L7 pro back-endový fond subresource
loadBalancingSettings Nastavení vyrovnávání zatížení pro back-endový fond subresource

Nastavení BackendPools

Jméno Popis Hodnota
enforceCertificateNameCheck Určuje, jestli chcete vynutit kontrolu 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

Konfigurace mezipaměti

Jméno Popis Hodnota
dynamická komprese Zda použít dynamickou kompresi pro obsah uložený v mezipaměti Zakázáno
Povoleno
Směrnice queryParameterStripDirective Ošetření výrazů dotazu adresy URL při vytváření klíče mezipaměti StripAll
StripNone

Konfigurace předávání

Jméno Popis Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration (povinné)
back-endPool Odkaz na back-endový fond, do kterého se toto pravidlo směruje. subresource
konfigurace mezipaměti Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. CacheConfiguration
Vlastnost customForwardingPath Vlastní cesta použitá k přepsání cest prostředků, které odpovídají tomuto pravidlu. Pokud chcete použít příchozí cestu, nechejte prázdné. řetězec
forwardingProtocol Toto pravidlo se použije při předávání provozu do back-endů. HttpOnly
HttpsOnly
'Žádost o shodu'

FrontDoorProperties

Jméno Popis Hodnota
back-endPools Back-endové fondy dostupné pro pravidla směrování. back-endpool[]
backendPoolsSettings Nastavení pro všechny back-endové fondy BackendPoolsSettings
Povolený stav 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
přátelský název Popisný název frontDooru řetězec
frontendendové body Front-endové koncové body dostupné pro pravidla směrování FrontendEndpoint []
Nastavení healthProbeSettings Nastavení sondy stavu přidružené k této instanci služby Front Door Model nastavení HealthProbe[]
loadBalancingSettings Nastavení vyrovnávání zatížení přidružené k této instanci služby Front Door. LoadBalancingSettingsModel[]
směrovací pravidla Pravidla směrování přidružená k této službě Front Door. routingRule[]

Frontendendpoint

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti koncového bodu front-endu frontendEndpointProperties

Vlastnosti koncového bodu Frontendu

Jméno Popis Hodnota
Název hostitele Název hostitele frontendendpointu. Musí to být název domény. řetězec
sessionAffinityEnabledState Určuje, jestli chcete povolit spřažení relací na tomto hostiteli. Platné možnosti jsou Povolené nebo Zakázané. Zakázáno
Povoleno
sessionAffinityTtlSeconds NEPOUŽITÝ. Toto pole bude ignorováno. Hodnota TTL, která se má použít v sekundách pro spřažení relace, pokud je k dispozici. Int
webApplicationFirewallPolicyLink Definuje zásady firewallu webových aplikací pro každého hostitele (pokud je to možné). FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec

HealthProbeSettingsModel

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti nastavení sondy stavu HealthProbeSettingsProperties

HealthProbeSettingsProperties

Jméno Popis Hodnota
interval v sekundách Počet sekund mezi sondami stavu. Int
cesta 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

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti nastavení vyrovnávání zatížení LoadBalancingSettingsProperties

Vyrovnávání zatíženíSettingsProperties

Jméno Popis Hodnota
additionalLatencyMillisekundy Další latence v milisekundách pro sondy, které spadají do kontejneru s nejnižší latencí Int
velikost vzorku Počet vzorků, které je potřeba zvážit při rozhodování o vyrovnávání zatížení Int
successfulSamplesRequired Počet vzorků v období výběru, které musí proběhnout úspěšně Int

Konfigurace přesměrování

Jméno Popis Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)
customFragment Fragment, který se má přidat k adrese URL pro přesměrování Fragment je část adresy URL, která následuje po #. Nezahrnujte soubor #. řetězec
Hostitel customHost 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
Vlastní cesta Úplná cesta k přesměrování. Cesta nemůže být prázdná a musí začínat parametrem /. Pokud chcete jako cílovou cestu použít příchozí cestu, nechejte prázdnou. řetězec
Ř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<klíče >=<hodnota>. První? a & budou přidány automaticky, takže je nezahrnujte do popředí, ale oddělte více řetězců dotazu pomocí &. řetězec
redirectProtocol (Protokol přesměrování) Protokol cíle, do kterého se provoz přesměruje HttpOnly
HttpsOnly
'Žádost o shodu'
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

Značky prostředků

Jméno Popis Hodnota

Konfigurace trasy

Jméno Popis Hodnota
@odata.type Pro typ ForwardingConfigurationnastavte hodnotu #Microsoft.Azure.FrontDoorForwardingConfiguration. Pro typ RedirectConfigurationnastavte hodnotu #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)

Směrovací pravidla

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti pravidla směrování služby Front Door routingRuleProperties

RoutingRuleProperties

Jméno Popis Hodnota
akceptovanéProtocols Schémata protokolu, která se mají shodovat s tímto pravidlem Řetězcové pole obsahující některou z těchto možností:
Http
Https
Povolený stav Zda chcete povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
frontendendové body Koncové body front-endu přidružené k tomuto pravidlu subresource[]
patternsToMatch Vzory tras pravidla. řetězec[]
konfigurace trasy Odkaz na konfiguraci směrování. RouteConfiguration

Podsourc

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec

Příklady použití

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Modul Popis
Azure Front Door Modul prostředků AVM pro Azure Front Door

Ukázky rychlého startu Azure

Následující šablony Azure pro rychlý start obsahují ukázky Bicep pro nasazení tohoto typu prostředku.

Soubor Bicep Popis
Přidání vlastní domény a vlastního certifikátu pomocí služby Front Door Tato šablona nasadí a zabezpečí vlastní doménu pomocí služby Front Door s certifikátem spravovaným zákazníkem.
Přidání vlastní domény a spravovaného certifikátu pomocí služby Front Door Tato šablona onboarduje a zabezpečuje vlastní doménu pomocí služby Front Door.
kontroly stavu back-endů ve službě Front Door Tato šablona aktualizuje službu Front Door, aby změnila nastavení sondy stavu nastavením cesty sondy a také intervaly, ve kterých se sondy odešlou.
Vytvoření základního služby Front Door Tato šablona vytvoří základní konfiguraci služby Front Door s jedním back-endem.
vytvoření služby Front Door s přesměrováním HTTP na HTTPS Tato šablona vytvoří konfiguraci služby Front Door pro přesměrování HTTP na HTTPS.

Definice prostředku šablony ARM

Typ prostředku frontDoors je možné nasadit s operacemi, které cílí:

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í JSON.

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

Objekty RouteConfiguration

Nastavte vlastnost @odata.type určit typ objektu.

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationpouž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.FrontdoorRedirectConfigurationpoužijte:

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

Hodnoty vlastností

Microsoft.Network/frontDoors

Jméno Popis Hodnota
Verze rozhraní apiVersion Verze rozhraní API '2019-04-01'
umístění Umístění prostředku řetězec
Jméno Název prostředku řetězec

Omezení:
Minimální délka = 5
Maximální délka = 64
Model = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (povinné)
vlastnosti Vlastnosti služby Front Door Load Balancer FrontDoorProperties
visačky Značky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku Microsoft.Network/frontDoors

Back-end

Jméno Popis 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 odesílaná do back-endu. Pokud je prázdné nebo nezadané, výchozí hodnota je pro příchozího hostitele. řetězec
Povolený stav Jestli chcete povolit použití tohoto back-endu. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
Rozhraní httpPort Číslo portu HTTP TCP. Musí být v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
Protokol httpsPort Číslo portu HTTPS TCP. Musí být v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
priorita Priorita pro vyrovnávání zatížení. Pokud je back-end s nižší prioritou v pořádku, nebudou se pro vyrovnávání zatížení používat vyšší priority. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 5
hmotnost Váha tohoto koncového bodu pro účely vyrovnávání zatížení Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 1000

Fond back-endů

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti back-endového fondu služby Front Door back-endpoolProperties

Vlastnosti backendového bazénu

Jméno Popis Hodnota
back-endy Sada back-endů pro tento fond back-endové[]
Nastavení healthProbeSettings Nastavení sondy stavu L7 pro back-endový fond subresource
loadBalancingSettings Nastavení vyrovnávání zatížení pro back-endový fond subresource

Nastavení BackendPools

Jméno Popis Hodnota
enforceCertificateNameCheck Určuje, jestli chcete vynutit kontrolu 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

Konfigurace mezipaměti

Jméno Popis Hodnota
dynamická komprese Zda použít dynamickou kompresi pro obsah uložený v mezipaměti Zakázáno
Povoleno
Směrnice queryParameterStripDirective Ošetření výrazů dotazu adresy URL při vytváření klíče mezipaměti StripAll
StripNone

Konfigurace předávání

Jméno Popis Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration (povinné)
back-endPool Odkaz na back-endový fond, do kterého se toto pravidlo směruje. subresource
konfigurace mezipaměti Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. CacheConfiguration
Vlastnost customForwardingPath Vlastní cesta použitá k přepsání cest prostředků, které odpovídají tomuto pravidlu. Pokud chcete použít příchozí cestu, nechejte prázdné. řetězec
forwardingProtocol Toto pravidlo se použije při předávání provozu do back-endů. HttpOnly
HttpsOnly
'Žádost o shodu'

FrontDoorProperties

Jméno Popis Hodnota
back-endPools Back-endové fondy dostupné pro pravidla směrování. back-endpool[]
backendPoolsSettings Nastavení pro všechny back-endové fondy BackendPoolsSettings
Povolený stav 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
přátelský název Popisný název frontDooru řetězec
frontendendové body Front-endové koncové body dostupné pro pravidla směrování FrontendEndpoint []
Nastavení healthProbeSettings Nastavení sondy stavu přidružené k této instanci služby Front Door Model nastavení HealthProbe[]
loadBalancingSettings Nastavení vyrovnávání zatížení přidružené k této instanci služby Front Door. LoadBalancingSettingsModel[]
směrovací pravidla Pravidla směrování přidružená k této službě Front Door. routingRule[]

Frontendendpoint

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti koncového bodu front-endu frontendEndpointProperties

Vlastnosti koncového bodu Frontendu

Jméno Popis Hodnota
Název hostitele Název hostitele frontendendpointu. Musí to být název domény. řetězec
sessionAffinityEnabledState Určuje, jestli chcete povolit spřažení relací na tomto hostiteli. Platné možnosti jsou Povolené nebo Zakázané. Zakázáno
Povoleno
sessionAffinityTtlSeconds NEPOUŽITÝ. Toto pole bude ignorováno. Hodnota TTL, která se má použít v sekundách pro spřažení relace, pokud je k dispozici. Int
webApplicationFirewallPolicyLink Definuje zásady firewallu webových aplikací pro každého hostitele (pokud je to možné). FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec

HealthProbeSettingsModel

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti nastavení sondy stavu HealthProbeSettingsProperties

HealthProbeSettingsProperties

Jméno Popis Hodnota
interval v sekundách Počet sekund mezi sondami stavu. Int
cesta 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

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti nastavení vyrovnávání zatížení LoadBalancingSettingsProperties

Vyrovnávání zatíženíSettingsProperties

Jméno Popis Hodnota
additionalLatencyMillisekundy Další latence v milisekundách pro sondy, které spadají do kontejneru s nejnižší latencí Int
velikost vzorku Počet vzorků, které je potřeba zvážit při rozhodování o vyrovnávání zatížení Int
successfulSamplesRequired Počet vzorků v období výběru, které musí proběhnout úspěšně Int

Konfigurace přesměrování

Jméno Popis Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)
customFragment Fragment, který se má přidat k adrese URL pro přesměrování Fragment je část adresy URL, která následuje po #. Nezahrnujte soubor #. řetězec
Hostitel customHost 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
Vlastní cesta Úplná cesta k přesměrování. Cesta nemůže být prázdná a musí začínat parametrem /. Pokud chcete jako cílovou cestu použít příchozí cestu, nechejte prázdnou. řetězec
Ř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<klíče >=<hodnota>. První? a & budou přidány automaticky, takže je nezahrnujte do popředí, ale oddělte více řetězců dotazu pomocí &. řetězec
redirectProtocol (Protokol přesměrování) Protokol cíle, do kterého se provoz přesměruje HttpOnly
HttpsOnly
'Žádost o shodu'
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

Značky prostředků

Jméno Popis Hodnota

Konfigurace trasy

Jméno Popis Hodnota
@odata.type Pro typ ForwardingConfigurationnastavte hodnotu #Microsoft.Azure.FrontDoorForwardingConfiguration. Pro typ RedirectConfigurationnastavte hodnotu #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)

Směrovací pravidla

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti pravidla směrování služby Front Door routingRuleProperties

RoutingRuleProperties

Jméno Popis Hodnota
akceptovanéProtocols Schémata protokolu, která se mají shodovat s tímto pravidlem Řetězcové pole obsahující některou z těchto možností:
Http
Https
Povolený stav Zda chcete povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
frontendendové body Koncové body front-endu přidružené k tomuto pravidlu subresource[]
patternsToMatch Vzory tras pravidla. řetězec[]
konfigurace trasy Odkaz na konfiguraci směrování. RouteConfiguration

Podsourc

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec

Příklady použití

Šablony Azure pro rychlý start

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Šablona Popis
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 s certifikátem spravovaným zákazníkem.
Přidání vlastní domény a spravovaného certifikátu pomocí služby Front Door

nasazení do Azure
Tato šablona onboarduje a zabezpečuje vlastní doménu pomocí služby Front Door.
konfigurace spřažení relací pro názvy hostitelů služby Front Door

nasazení do Azure
Tato šablona aktualizuje službu Front Door, aby povolila spřažení relací pro vašeho hostitele front-endu, čímž odešle následný provoz ze stejné uživatelské relace do stejného back-endu.
kontroly stavu back-endů ve službě Front Door

nasazení do Azure
Tato šablona aktualizuje službu Front Door, aby změnila nastavení sondy stavu nastavením cesty sondy a také intervaly, ve kterých se sondy odešlou.
Vytvoření základního 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 přesměrováním HTTP na HTTPS

nasazení do Azure
Tato šablona vytvoří konfiguraci služby Front Door pro přesměrování HTTP na HTTPS.
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é mezi back-endovými fondy na základě cesty URL.
vytvoření služby Azure Front Door před službou Azure API Management

nasazení do Azure
Tato ukázka ukazuje, jak používat Azure Front Door jako globální nástroj pro vyrovnávání zatížení před službou Azure API Management.
Vytvoření služby Front Door s konfiguračními Active-Standby

nasazení do Azure
Tato šablona vytvoří službu Front Door, která předvádí směrování na základě priority pro topologii Active-Standby aplikací.
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í, takže se všechny statické prostředky pro vaši úlohu ukládají do mezipaměti.

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku frontDoors je možné nasadit s operacemi, které cílí:

  • 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"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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 určit typ objektu.

Pro #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationpouž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.FrontdoorRedirectConfigurationpoužijte:

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

Hodnoty vlastností

Microsoft.Network/frontDoors

Jméno Popis Hodnota
umístění Umístění prostředku řetězec
Jméno Název prostředku řetězec

Omezení:
Minimální délka = 5
Maximální délka = 64
Model = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (povinné)
vlastnosti Vlastnosti služby Front Door Load Balancer FrontDoorProperties
visačky Značky prostředků Slovník názvů a hodnot značek
typ Typ prostředku Microsoft.Network/frontDoors@2019-04-01

Back-end

Jméno Popis 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 odesílaná do back-endu. Pokud je prázdné nebo nezadané, výchozí hodnota je pro příchozího hostitele. řetězec
Povolený stav Jestli chcete povolit použití tohoto back-endu. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
Rozhraní httpPort Číslo portu HTTP TCP. Musí být v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
Protokol httpsPort Číslo portu HTTPS TCP. Musí být v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
priorita Priorita pro vyrovnávání zatížení. Pokud je back-end s nižší prioritou v pořádku, nebudou se pro vyrovnávání zatížení používat vyšší priority. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 5
hmotnost Váha tohoto koncového bodu pro účely vyrovnávání zatížení Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 1000

Fond back-endů

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti back-endového fondu služby Front Door back-endpoolProperties

Vlastnosti backendového bazénu

Jméno Popis Hodnota
back-endy Sada back-endů pro tento fond back-endové[]
Nastavení healthProbeSettings Nastavení sondy stavu L7 pro back-endový fond subresource
loadBalancingSettings Nastavení vyrovnávání zatížení pro back-endový fond subresource

Nastavení BackendPools

Jméno Popis Hodnota
enforceCertificateNameCheck Určuje, jestli chcete vynutit kontrolu 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

Konfigurace mezipaměti

Jméno Popis Hodnota
dynamická komprese Zda použít dynamickou kompresi pro obsah uložený v mezipaměti Zakázáno
Povoleno
Směrnice queryParameterStripDirective Ošetření výrazů dotazu adresy URL při vytváření klíče mezipaměti StripAll
StripNone

Konfigurace předávání

Jméno Popis Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration (povinné)
back-endPool Odkaz na back-endový fond, do kterého se toto pravidlo směruje. subresource
konfigurace mezipaměti Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. CacheConfiguration
Vlastnost customForwardingPath Vlastní cesta použitá k přepsání cest prostředků, které odpovídají tomuto pravidlu. Pokud chcete použít příchozí cestu, nechejte prázdné. řetězec
forwardingProtocol Toto pravidlo se použije při předávání provozu do back-endů. HttpOnly
HttpsOnly
'Žádost o shodu'

FrontDoorProperties

Jméno Popis Hodnota
back-endPools Back-endové fondy dostupné pro pravidla směrování. back-endpool[]
backendPoolsSettings Nastavení pro všechny back-endové fondy BackendPoolsSettings
Povolený stav 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
přátelský název Popisný název frontDooru řetězec
frontendendové body Front-endové koncové body dostupné pro pravidla směrování FrontendEndpoint []
Nastavení healthProbeSettings Nastavení sondy stavu přidružené k této instanci služby Front Door Model nastavení HealthProbe[]
loadBalancingSettings Nastavení vyrovnávání zatížení přidružené k této instanci služby Front Door. LoadBalancingSettingsModel[]
směrovací pravidla Pravidla směrování přidružená k této službě Front Door. routingRule[]

Frontendendpoint

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti koncového bodu front-endu frontendEndpointProperties

Vlastnosti koncového bodu Frontendu

Jméno Popis Hodnota
Název hostitele Název hostitele frontendendpointu. Musí to být název domény. řetězec
sessionAffinityEnabledState Určuje, jestli chcete povolit spřažení relací na tomto hostiteli. Platné možnosti jsou Povolené nebo Zakázané. Zakázáno
Povoleno
sessionAffinityTtlSeconds NEPOUŽITÝ. Toto pole bude ignorováno. Hodnota TTL, která se má použít v sekundách pro spřažení relace, pokud je k dispozici. Int
webApplicationFirewallPolicyLink Definuje zásady firewallu webových aplikací pro každého hostitele (pokud je to možné). FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec

HealthProbeSettingsModel

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti nastavení sondy stavu HealthProbeSettingsProperties

HealthProbeSettingsProperties

Jméno Popis Hodnota
interval v sekundách Počet sekund mezi sondami stavu. Int
cesta 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

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti nastavení vyrovnávání zatížení LoadBalancingSettingsProperties

Vyrovnávání zatíženíSettingsProperties

Jméno Popis Hodnota
additionalLatencyMillisekundy Další latence v milisekundách pro sondy, které spadají do kontejneru s nejnižší latencí Int
velikost vzorku Počet vzorků, které je potřeba zvážit při rozhodování o vyrovnávání zatížení Int
successfulSamplesRequired Počet vzorků v období výběru, které musí proběhnout úspěšně Int

Konfigurace přesměrování

Jméno Popis Hodnota
@odata.type #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)
customFragment Fragment, který se má přidat k adrese URL pro přesměrování Fragment je část adresy URL, která následuje po #. Nezahrnujte soubor #. řetězec
Hostitel customHost 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
Vlastní cesta Úplná cesta k přesměrování. Cesta nemůže být prázdná a musí začínat parametrem /. Pokud chcete jako cílovou cestu použít příchozí cestu, nechejte prázdnou. řetězec
Ř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<klíče >=<hodnota>. První? a & budou přidány automaticky, takže je nezahrnujte do popředí, ale oddělte více řetězců dotazu pomocí &. řetězec
redirectProtocol (Protokol přesměrování) Protokol cíle, do kterého se provoz přesměruje HttpOnly
HttpsOnly
'Žádost o shodu'
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

Značky prostředků

Jméno Popis Hodnota

Konfigurace trasy

Jméno Popis Hodnota
@odata.type Pro typ ForwardingConfigurationnastavte hodnotu #Microsoft.Azure.FrontDoorForwardingConfiguration. Pro typ RedirectConfigurationnastavte hodnotu #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (povinné)

Směrovací pravidla

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec
Jméno Název prostředku řetězec
vlastnosti Vlastnosti pravidla směrování služby Front Door routingRuleProperties

RoutingRuleProperties

Jméno Popis Hodnota
akceptovanéProtocols Schémata protokolu, která se mají shodovat s tímto pravidlem Řetězcové pole obsahující některou z těchto možností:
Http
Https
Povolený stav Zda chcete povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno). Zakázáno
Povoleno
frontendendové body Koncové body front-endu přidružené k tomuto pravidlu subresource[]
patternsToMatch Vzory tras pravidla. řetězec[]
konfigurace trasy Odkaz na konfiguraci směrování. RouteConfiguration

Podsourc

Jméno Popis Hodnota
identifikační číslo ID prostředku. řetězec