Microsoft.Network frontDoors 2019-04-01
Definice prostředku Bicep
Typ prostředku frontDoors je možné nasadit do:
- Skupiny prostředků – viz příkazy pro nasazení skupin 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í 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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:
- Skupiny prostředků – viz příkazy nasazení 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í 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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" |