Sdílet prostřednictvím

Microsoft.Network frontDoors 2020-01-01

  • Článek

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@2020-01-01' = {
  location: 'string'
  name: 'string'
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              privateLinkAlias: 'string'
              privateLinkApprovalMessage: 'string'
              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'
          }
        }
      }
    ]
  }
  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: {
    cacheDuration: 'string'
    dynamicCompression: 'string'
    queryParameters: '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í

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
enabledState Jestli chcete 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 v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
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
privateLinkAlias Alias prostředku Private Link. Naplnění tohoto volitelného pole označuje, ž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 Linku řetězec
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
id 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

BackendPoolProperties

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

BackendPoolsSettings

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
sendRecvTimeoutSeconds Odeslání a příjem časového limitu při přeposílání požadavku do back-endu Po dosažení časového limitu požadavek selže a vrátí se. Int

Omezení:
Minimální hodnota = 16

CacheConfiguration

Jméno Popis Hodnota
cacheDuration Doba trvání, 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 Zda použít dynamickou kompresi 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 Ošetření výrazů dotazu adresy URL při vytváření klíče mezipaměti StripAll
StripAllExcept
StripNone
StripOnly

ForwardingConfiguration

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
cacheConfiguration Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. CacheConfiguration
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
'MatchRequest'

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
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 frontDooru řetězec
frontendendové body Front-endové koncové body 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[]
směrovací pravidla Pravidla směrování přidružená k této službě Front Door. routingRule[]

Frontendendpoint

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

FrontendEndpointProperties

Jméno Popis Hodnota
hostName 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
id ID prostředku. řetězec

HealthProbeSettingsModel

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

HealthProbeSettingsProperties

Jméno Popis Hodnota
enabledState Jestli chcete povolit, aby sondy stavu byly provedeny proti back-endům definovaným v back-endových fondech. Sondy stavu je možné zakázat pouze v případě, že existuje jeden povolený back-end v jednom povoleném back-endovém fondu. Zakázáno
Povoleno
healthProbeMethod Konfiguruje, kterou metodu HTTP použít k sondování back-endů definovaných v back-endPools. GET
"HEAD"
intervalInSeconds 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
id 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
additionalLatencyMilliseconds Další latence v milisekundách pro sondy, které spadají do kontejneru s nejnižší latencí Int
sampleSize 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

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

RedirectConfiguration

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
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
customPath Ú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
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 cíle, do kterého 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

Značky prostředků

Jméno Popis Hodnota

RouteConfiguration

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
id 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
enabledState 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. string[]
routeConfiguration Odkaz na konfiguraci směrování. RouteConfiguration
RulesEngine Odkaz na konkrétní konfiguraci stroje pravidel, který se má na tuto trasu použít. subresource

Podsourc

Jméno Popis Hodnota
id ID prostředku. řetězec

Ukázky rychlého startu

Následující ukázky rychlého startu nasadí tento typ 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": "2020-01-01",
  "name": "string",
  "location": "string",
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "privateLinkAlias": "string",
              "privateLinkApprovalMessage": "string",
              "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"
          }
        }
      }
    ]
  },
  "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": {
    "cacheDuration": "string",
    "dynamicCompression": "string",
    "queryParameters": "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í

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
enabledState Jestli chcete 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 v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
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
privateLinkAlias Alias prostředku Private Link. Naplnění tohoto volitelného pole označuje, ž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 Linku řetězec
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
id 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

BackendPoolProperties

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

BackendPoolsSettings

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
sendRecvTimeoutSeconds Odeslání a příjem časového limitu při přeposílání požadavku do back-endu Po dosažení časového limitu požadavek selže a vrátí se. Int

Omezení:
Minimální hodnota = 16

CacheConfiguration

Jméno Popis Hodnota
cacheDuration Doba trvání, 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 Zda použít dynamickou kompresi 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 Ošetření výrazů dotazu adresy URL při vytváření klíče mezipaměti StripAll
StripAllExcept
StripNone
StripOnly

ForwardingConfiguration

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
cacheConfiguration Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. CacheConfiguration
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
'MatchRequest'

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
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 frontDooru řetězec
frontendendové body Front-endové koncové body 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[]
směrovací pravidla Pravidla směrování přidružená k této službě Front Door. routingRule[]

Frontendendpoint

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

FrontendEndpointProperties

Jméno Popis Hodnota
hostName 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
id ID prostředku. řetězec

HealthProbeSettingsModel

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

HealthProbeSettingsProperties

Jméno Popis Hodnota
enabledState Jestli chcete povolit, aby sondy stavu byly provedeny proti back-endům definovaným v back-endových fondech. Sondy stavu je možné zakázat pouze v případě, že existuje jeden povolený back-end v jednom povoleném back-endovém fondu. Zakázáno
Povoleno
healthProbeMethod Konfiguruje, kterou metodu HTTP použít k sondování back-endů definovaných v back-endPools. GET
"HEAD"
intervalInSeconds 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
id 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
additionalLatencyMilliseconds Další latence v milisekundách pro sondy, které spadají do kontejneru s nejnižší latencí Int
sampleSize 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

Microsoft.Network/frontDoors

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2020-01-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 = 5
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

RedirectConfiguration

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
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
customPath Ú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
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 cíle, do kterého 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

Značky prostředků

Jméno Popis Hodnota

RouteConfiguration

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
id 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
enabledState 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. string[]
routeConfiguration Odkaz na konfiguraci směrování. RouteConfiguration
RulesEngine Odkaz na konkrétní konfiguraci stroje pravidel, který se má na tuto trasu použít. subresource

Podsourc

Jméno Popis Hodnota
id ID prostředku. řetězec

Šablony pro rychlý start

Následující šablony pro rychlý start nasazují 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@2020-01-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                privateLinkAlias = "string"
                privateLinkApprovalMessage = "string"
                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"
            }
          }
        }
      ]
    }
  })
}

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

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
enabledState Jestli chcete 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 v rozmezí 1 až 65535. Int

Omezení:
Minimální hodnota = 1
Maximální hodnota = 65535
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
privateLinkAlias Alias prostředku Private Link. Naplnění tohoto volitelného pole označuje, ž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 Linku řetězec
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
id 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

BackendPoolProperties

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

BackendPoolsSettings

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
sendRecvTimeoutSeconds Odeslání a příjem časového limitu při přeposílání požadavku do back-endu Po dosažení časového limitu požadavek selže a vrátí se. Int

Omezení:
Minimální hodnota = 16

CacheConfiguration

Jméno Popis Hodnota
cacheDuration Doba trvání, 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 Zda použít dynamickou kompresi 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 Ošetření výrazů dotazu adresy URL při vytváření klíče mezipaměti StripAll
StripAllExcept
StripNone
StripOnly

ForwardingConfiguration

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
cacheConfiguration Konfigurace ukládání do mezipaměti přidružená k tomuto pravidlu. CacheConfiguration
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
'MatchRequest'

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
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 frontDooru řetězec
frontendendové body Front-endové koncové body 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[]
směrovací pravidla Pravidla směrování přidružená k této službě Front Door. routingRule[]

Frontendendpoint

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

FrontendEndpointProperties

Jméno Popis Hodnota
hostName 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
id ID prostředku. řetězec

HealthProbeSettingsModel

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

HealthProbeSettingsProperties

Jméno Popis Hodnota
enabledState Jestli chcete povolit, aby sondy stavu byly provedeny proti back-endům definovaným v back-endových fondech. Sondy stavu je možné zakázat pouze v případě, že existuje jeden povolený back-end v jednom povoleném back-endovém fondu. Zakázáno
Povoleno
healthProbeMethod Konfiguruje, kterou metodu HTTP použít k sondování back-endů definovaných v back-endPools. GET
"HEAD"
intervalInSeconds 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
id 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
additionalLatencyMilliseconds Další latence v milisekundách pro sondy, které spadají do kontejneru s nejnižší latencí Int
sampleSize 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

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 = 5
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@2020-01-01"

RedirectConfiguration

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
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
customPath Ú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
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 cíle, do kterého 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

Značky prostředků

Jméno Popis Hodnota

RouteConfiguration

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
id 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
enabledState 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. string[]
routeConfiguration Odkaz na konfiguraci směrování. RouteConfiguration
RulesEngine Odkaz na konkrétní konfiguraci stroje pravidel, který se má na tuto trasu použít. subresource

Podsourc

Jméno Popis Hodnota
id ID prostředku. řetězec