Microsoft.Network frontDoors 2019-04-01
Bicep-resursdefinition
Resurstypen frontDoors kan distribueras till:
- Resursgrupper – Se kommandon för resursgruppsdistribution
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Network/frontDoors-resurs lägger du till följande Bicep i mallen.
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
}
}
}
]
}
}
RouteConfiguration-objekt
Ange egenskapen @odata.type för att ange objekttypen.
För #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration använder du:
'@odata.type': '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
backendPool: {
id: 'string'
}
cacheConfiguration: {
dynamicCompression: 'string'
queryParameterStripDirective: 'string'
}
customForwardingPath: 'string'
forwardingProtocol: 'string'
För #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration använder du:
'@odata.type': '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
customFragment: 'string'
customHost: 'string'
customPath: 'string'
customQueryString: 'string'
redirectProtocol: 'string'
redirectType: 'string'
Egenskapsvärden
frontDoors
Name | Beskrivning | Värde |
---|---|---|
name | Resursnamnet | sträng (krävs) Teckengräns: 5–64 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Resursnamnet måste vara unikt i Hela Azure. |
location | Resursplats. | sträng |
tags | Resurstaggar. | Ordlista med taggnamn och värden. Se Taggar i mallar |
properties | Egenskaper för Front Door Load Balancer | FrontDoorProperties |
FrontDoorProperties
Name | Beskrivning | Värde |
---|---|---|
backendPools | Serverdelspooler som är tillgängliga för routningsregler. | BackendPool[] |
backendPoolsSettings | Inställningar för alla backendPools | BackendPoolsSettings |
enabledState | Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är Aktiverade eller Inaktiverade | "Inaktiverad" "Aktiverad" |
friendlyName | Ett eget namn för frontDoor | sträng |
frontendEndpoints | Klientdelsslutpunkter som är tillgängliga för routningsregler. | FrontendEndpoint[] |
healthProbeSettings | Inställningar för hälsoavsökning som är associerade med den här Front Door-instansen. | HealthProbeSettingsModel[] |
loadBalancingSettings | Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen. | LoadBalancingSettingsModel[] |
routingRules | Routningsregler som är associerade med denna Front Door. | RoutingRule[] |
Serverdelspool
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för Front Door-serverdelspoolen | BackendPoolProperties |
BackendPoolProperties
Name | Beskrivning | Värde |
---|---|---|
Backends | Uppsättningen serverdelar för den här poolen | Serverdel[] |
healthProbeSettings | L7-hälsoavsökningsinställningar för en serverdelspool | Underresurs |
loadBalancingSettings | Inställningar för belastningsutjämning för en serverdelspool | SubResource |
Serverdel
Name | Beskrivning | Värde |
---|---|---|
adress | Plats för serverdelen (IP-adress eller FQDN) | sträng |
backendHostHeader | Värdet som ska användas som värdrubrik som skickas till serverdelen. Om den är tom eller ospecificerad används den inkommande värden som standard. | sträng |
enabledState | Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "aktiverade" eller "inaktiverade" | "Inaktiverad" "Aktiverad" |
httpPort | HTTP TCP-portnumret. Måste vara mellan 1 och 65535. | int |
httpsPort | HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. | int |
prioritet | Prioritet att använda för belastningsutjämning. Högre prioriteringar används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri. | int |
vikt | Vikt för den här slutpunkten för belastningsutjämning. | int |
SubResource
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
BackendPoolsSettings
Name | Beskrivning | Värde |
---|---|---|
enforceCertificateNameCheck | Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden. | "Inaktiverad" "Aktiverad" |
KlientdelSlutpunkt
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för klientdelsslutpunkten | KlientdelEndpointEgenskaper |
KlientdelEndpointEgenskaper
Name | Beskrivning | Värde |
---|---|---|
Värdnamn | Värdnamnet för frontendEndpoint. Måste vara ett domännamn. | sträng |
sessionAffinityEnabledState | Om sessionstillhörighet ska tillåtas på den här värden. Giltiga alternativ är "Aktiverad" eller "Inaktiverad" | "Inaktiverad" "Aktiverad" |
sessionAffinityTtlSeconds | OANVÄNDA. Det här fältet ignoreras. TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. | int |
webApplicationFirewallPolicyLink | Definierar Web Application Firewall princip för varje värd (om tillämpligt) | FrontendEndpointUpdateParametersWebApplicationFirewa... |
FrontendEndpointUpdateParametersWebApplicationFirewa...
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
HealthProbeSettingsModel
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för hälsoavsökningsinställningarna | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Name | Beskrivning | Värde |
---|---|---|
intervalInSeconds | Antalet sekunder mellan hälsoavsökningar. | int |
path | Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ | sträng |
Protokollet | Protokollschema som ska användas för den här avsökningen | "Http" "Https" |
LoadBalancingSettingsModel
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för belastningsutjämningsinställningarna | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Name | Beskrivning | Värde |
---|---|---|
additionalLatencyMilliseconds | Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med kortast svarstid | int |
sampleSize | Antalet exempel som ska övervägas för beslut om belastningsutjämning | int |
successfulSamplesRequired | Antalet prover inom exempelperioden som måste lyckas | int |
RoutingRule
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för Front Door-routningsregeln | RoutingRuleProperties |
RoutingRuleProperties
Name | Beskrivning | Värde |
---|---|---|
acceptedProtocols | Protokollscheman som ska matchas för den här regeln | Strängmatris som innehåller något av: "Http" "Https" |
enabledState | Om du vill aktivera användning av den här regeln. Tillåtna värden är Aktiverade eller Inaktiverade | "Inaktiverad" "Aktiverad" |
frontendEndpoints | Klientdelsslutpunkter som är associerade med den här regeln | SubResource[] |
patternsToMatch | Regelns vägmönster. | string[] |
routeConfiguration | En referens till routningskonfigurationen. | RouteConfiguration |
RouteConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | Ange objekttyp |
#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (krävs) |
ForwardingConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (krävs) | |
backendPool | En referens till backendPool som den här regeln dirigerar till. | Underresurs |
cacheConfiguration | Cachelagringskonfigurationen som är associerad med den här regeln. | CacheConfiguration |
customForwardingPath | En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Lämna tomt om du vill använda den inkommande sökvägen. | sträng |
forwardingProtocol | Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. | "HttpOnly" "HttpsOnly" "MatchRequest" |
CacheConfiguration
Name | Beskrivning | Värde |
---|---|---|
dynamicCompression | Om dynamisk komprimering ska användas för cachelagrat innehåll | "Inaktiverad" "Aktiverad" |
queryParameterStripDirective | Behandling av URL-frågetermer när cachenyckeln skapas. | "StripAll" "StripNone" |
RedirectConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs) | |
customFragment | Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Ta inte med #. | sträng |
customHost | Värd för omdirigering. Lämna tomt om du vill använda den inkommande värden som målvärd. | sträng |
customPath | Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tomt om du vill använda den inkommande sökvägen som målsökväg. | sträng |
customQueryString | Uppsättningen frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tomt för att bevara den inkommande frågesträngen. Frågesträngen måste vara i {key}={value}-format. Den första? och & läggs till automatiskt, så ta inte med dem längst fram, utan avgränsa flera frågesträngar med &. | sträng |
redirectProtocol | Protokollet för målet dit trafiken omdirigeras | "HttpOnly" "HttpsOnly" "MatchRequest" |
redirectType | Omdirigeringstypen som regeln använder vid omdirigering av trafik. | "Hittades" "Flyttad" "PermanentRedirect" "TemporaryRedirect" |
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
Mall | Description |
---|---|
Skapa Azure Front Door framför Azure API Management |
Det här exemplet visar hur du använder Azure Front Door som global lastbalanserare framför Azure API Management. |
Skapa en grundläggande Front Door |
Den här mallen skapar en grundläggande Front Door-konfiguration med en enda serverdel. |
Skapa Front Door med cachelagring aktiverat för vissa vägar |
Den här mallen skapar en Front Door med cachelagring aktiverat för den definierade routningskonfigurationen och cachelagrar därmed statiska tillgångar för din arbetsbelastning. |
Skapa en Front Door med flera serverdelar och serverdelspooler |
Den här mallen skapar en Front Door med belastningsutjämning konfigurerad för flera serverdelar i en serverdelspool och även över serverdelspooler baserat på URL-sökväg. |
Skapa en Front Door med HTTP till HTTPS-omdirigering |
Den här mallen skapar en Front Door-konfiguration för HTTP till HTTPS-omdirigering. |
Lägga till anpassad domän och hanterat certifikat med Front Door |
Den här mallen registrerar och skyddar en anpassad domän med Front Door |
Lägga till anpassad domän och anpassat certifikat med Front Door |
Den här mallen registrerar och skyddar en anpassad domän med Front Door med ett kundhanterat certifikat |
Kontrollera hälsoavsökningar för dina serverdelar i Front Door |
Den här mallen uppdaterar Din Front Door för att ändra inställningarna för hälsoavsökningen genom att ange sökvägen för avsökningen och även de intervall som avsökningarna ska skickas i. |
Skapa Front Door med Active-Standby-konfiguration |
Den här mallen skapar en Front Door som visar prioritetsbaserad routning för Active-Standby programtopologi. |
Konfigurera sessionstillhörighet för dina Front Door-värdnamn |
Den här mallen uppdaterar en Front Door för att aktivera sessionstillhörighet för klientdelsvärden och skickar därmed efterföljande trafik från samma användarsession till samma serverdel. |
Resursdefinition för ARM-mall
Resurstypen frontDoors kan distribueras till:
- Resursgrupper – Se kommandon för resursgruppsdistribution
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Network/frontDoors-resurs lägger du till följande JSON i mallen.
{
"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
}
}
}
]
}
}
RouteConfiguration-objekt
Ange egenskapen @odata.type för att ange objekttypen.
För #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration använder du:
"@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
"backendPool": {
"id": "string"
},
"cacheConfiguration": {
"dynamicCompression": "string",
"queryParameterStripDirective": "string"
},
"customForwardingPath": "string",
"forwardingProtocol": "string"
För #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration använder du:
"@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
"customFragment": "string",
"customHost": "string",
"customPath": "string",
"customQueryString": "string",
"redirectProtocol": "string",
"redirectType": "string"
Egenskapsvärden
frontDoors
Name | Beskrivning | Värde |
---|---|---|
typ | Resurstypen | "Microsoft.Network/frontDoors" |
apiVersion | Resurs-API-versionen | '2019-04-01' |
name | Resursnamnet | sträng (krävs) Teckengräns: 5–64 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Resursnamnet måste vara unikt i Hela Azure. |
location | Resursplats. | sträng |
tags | Resurstaggar. | Ordlista med taggnamn och värden. Se Taggar i mallar |
properties | Egenskaper för Front Door-Load Balancer | FrontDoorEgenskaper |
FrontDoorEgenskaper
Name | Beskrivning | Värde |
---|---|---|
backendPools | Serverdelspooler som är tillgängliga för routningsregler. | BackendPool[] |
backendPoolsSettings | Inställningar för alla backendPools | BackendPoolsSettings |
enabledState | Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är "aktiverade" eller "inaktiverade" | "Inaktiverad" "Aktiverad" |
friendlyName | Ett eget namn för frontDoor | sträng |
frontendEndpoints | Klientdelsslutpunkter som är tillgängliga för routningsregler. | FrontendEndpoint[] |
healthProbeSettings | Hälsoavsökningsinställningar som är associerade med den här Front Door-instansen. | HealthProbeSettingsModel[] |
loadBalancingSettings | Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen. | LoadBalancingSettingsModel[] |
routingRules | Routningsregler som är associerade med denna Front Door. | RoutingRule[] |
Serverdelspool
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för Front Door-serverdelspoolen | BackendPoolEgenskaper |
BackendPoolEgenskaper
Name | Beskrivning | Värde |
---|---|---|
Backends | Uppsättningen serverdelar för den här poolen | Serverdel[] |
healthProbeSettings | L7-hälsoavsökningsinställningar för en serverdelspool | SubResource |
loadBalancingSettings | Belastningsutjämningsinställningar för en serverdelspool | SubResource |
Serverdel
Name | Beskrivning | Värde |
---|---|---|
adress | Plats för serverdelen (IP-adress eller FQDN) | sträng |
backendHostHeader | Värdet som ska användas som värdrubrik som skickas till serverdelen. Om den är tom eller ospecificerad används den inkommande värden som standard. | sträng |
enabledState | Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "aktiverade" eller "inaktiverade" | "Inaktiverad" "Aktiverad" |
httpPort | HTTP TCP-portnumret. Måste vara mellan 1 och 65535. | int |
httpsPort | HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. | int |
prioritet | Prioritet att använda för belastningsutjämning. Högre prioriteter används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri. | int |
vikt | Den här slutpunktens vikt för belastningsutjämning. | int |
Underresurs
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
BackendPoolsSettings
Name | Beskrivning | Värde |
---|---|---|
enforceCertificateNameCheck | Om du vill framtvinga kontroll av certifikatnamn på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden. | "Inaktiverad" "Aktiverad" |
KlientdelSlutpunkt
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för klientdelsslutpunkten | FrontendEndpointProperties |
FrontendEndpointProperties
Name | Beskrivning | Värde |
---|---|---|
Värdnamn | Värdnamnet för frontendEndpoint. Måste vara ett domännamn. | sträng |
sessionAffinityEnabledState | Om sessionstillhörighet ska tillåtas på den här värden. Giltiga alternativ är "Aktiverad" eller "Inaktiverad" | "Inaktiverad" "Aktiverad" |
sessionAffinityTtlSeconds | OANVÄNDA. Det här fältet ignoreras. TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. | int |
webApplicationFirewallPolicyLink | Definierar Web Application Firewall princip för varje värd (om tillämpligt) | FrontendEndpointUpdateParametersWebApplicationFirewa... |
FrontendEndpointUpdateParametersWebApplicationFirewa...
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
HealthProbeSettingsModel
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för hälsoavsökningsinställningarna | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Name | Beskrivning | Värde |
---|---|---|
intervalInSeconds | Antalet sekunder mellan hälsoavsökningar. | int |
path | Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ | sträng |
Protokollet | Protokollschema som ska användas för den här avsökningen | "Http" "Https" |
LoadBalancingSettingsModel
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för belastningsutjämningsinställningarna | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Name | Beskrivning | Värde |
---|---|---|
additionalLatencyMilliseconds | Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med kortast svarstid | int |
sampleSize | Antalet exempel som ska övervägas för beslut om belastningsutjämning | int |
successfulSamplesRequired | Antalet prover inom exempelperioden som måste lyckas | int |
RoutingRule
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för Front Door-routningsregeln | RoutingRuleProperties |
RoutingRuleProperties
Name | Beskrivning | Värde |
---|---|---|
acceptedProtocols | Protokollscheman som ska matchas för den här regeln | Strängmatris som innehåller något av: "Http" "Https" |
enabledState | Om du vill aktivera användning av den här regeln. Tillåtna värden är Aktiverade eller Inaktiverade | "Inaktiverad" "Aktiverad" |
frontendEndpoints | Klientdelsslutpunkter som är associerade med den här regeln | SubResource[] |
patternsToMatch | Regelns vägmönster. | string[] |
routeConfiguration | En referens till routningskonfigurationen. | RouteConfiguration |
RouteConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | Ange objekttyp |
#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (krävs) |
ForwardingConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (krävs) | |
backendPool | En referens till backendPool som den här regeln dirigerar till. | Underresurs |
cacheConfiguration | Cachelagringskonfigurationen som är associerad med den här regeln. | CacheConfiguration |
customForwardingPath | En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Lämna tomt om du vill använda den inkommande sökvägen. | sträng |
forwardingProtocol | Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar. | "HttpOnly" "HttpsOnly" "MatchRequest" |
CacheConfiguration
Name | Beskrivning | Värde |
---|---|---|
dynamicCompression | Om dynamisk komprimering ska användas för cachelagrat innehåll | "Inaktiverad" "Aktiverad" |
queryParameterStripDirective | Behandling av URL-frågetermer när cachenyckeln skapas. | "StripAll" "StripNone" |
RedirectConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs) | |
customFragment | Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Ta inte med #. | sträng |
customHost | Värd för omdirigering. Lämna tomt om du vill använda den inkommande värden som målvärd. | sträng |
customPath | Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tomt om du vill använda den inkommande sökvägen som målsökväg. | sträng |
customQueryString | Uppsättningen frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tomt för att bevara den inkommande frågesträngen. Frågesträngen måste vara i {key}={value}-format. Den första? och & läggs till automatiskt, så ta inte med dem längst fram, utan avgränsa flera frågesträngar med &. | sträng |
redirectProtocol | Protokollet för målet dit trafiken omdirigeras | "HttpOnly" "HttpsOnly" "MatchRequest" |
redirectType | Omdirigeringstypen som regeln använder vid omdirigering av trafik. | "Hittades" "Flyttad" "PermanentRedirect" "TemporaryRedirect" |
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
Mall | Description |
---|---|
Skapa Azure Front Door framför Azure API Management |
Det här exemplet visar hur du använder Azure Front Door som global lastbalanserare framför Azure API Management. |
Skapa en grundläggande Front Door |
Den här mallen skapar en grundläggande Front Door-konfiguration med en enda serverdel. |
Skapa Front Door med cachelagring aktiverat för vissa vägar |
Den här mallen skapar en Front Door med cachelagring aktiverat för den definierade routningskonfigurationen och cachelagrar därmed statiska tillgångar för din arbetsbelastning. |
Skapa en Front Door med flera serverdelar och serverdelspooler |
Den här mallen skapar en Front Door med belastningsutjämning konfigurerad för flera serverdelar i en serverdelspool och även över serverdelspooler baserat på URL-sökväg. |
Skapa en Front Door med HTTP till HTTPS-omdirigering |
Den här mallen skapar en Front Door-konfiguration för HTTP till HTTPS-omdirigering. |
Lägga till anpassad domän och hanterat certifikat med Front Door |
Den här mallen registrerar och skyddar en anpassad domän med Front Door |
Lägga till anpassad domän och anpassat certifikat med Front Door |
Den här mallen registrerar och skyddar en anpassad domän med Front Door med ett kundhanterat certifikat |
Kontrollera hälsoavsökningar för dina serverdelar i Front Door |
Den här mallen uppdaterar Din Front Door för att ändra inställningarna för hälsoavsökningen genom att ange sökvägen för avsökningen och även de intervall som avsökningarna ska skickas i. |
Skapa Front Door med Active-Standby-konfiguration |
Den här mallen skapar en Front Door som visar prioritetsbaserad routning för Active-Standby programtopologi. |
Konfigurera sessionstillhörighet för dina Front Door-värdnamn |
Den här mallen uppdaterar en Front Door för att aktivera sessionstillhörighet för klientdelsvärden och skickar därmed efterföljande trafik från samma användarsession till samma serverdel. |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen frontDoors kan distribueras till:
- Resursgrupper
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Network/frontDoors-resurs lägger du till följande Terraform i mallen.
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
}
}
}
]
}
})
}
RouteConfiguration-objekt
Ange egenskapen @odata.type för att ange objekttypen.
För #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration använder du:
@odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
backendPool = {
id = "string"
}
cacheConfiguration = {
dynamicCompression = "string"
queryParameterStripDirective = "string"
}
customForwardingPath = "string"
forwardingProtocol = "string"
För #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration använder du:
@odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
customFragment = "string"
customHost = "string"
customPath = "string"
customQueryString = "string"
redirectProtocol = "string"
redirectType = "string"
Egenskapsvärden
frontDoors
Name | Beskrivning | Värde |
---|---|---|
typ | Resurstypen | "Microsoft.Network/frontDoors@2019-04-01" |
name | Resursnamnet | sträng (krävs) Teckengräns: 5–64 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja och sluta med alfanumeriskt. Resursnamnet måste vara unikt i Hela Azure. |
location | Resursplats. | sträng |
parent_id | Om du vill distribuera till en resursgrupp använder du ID:t för den resursgruppen. | sträng (krävs) |
tags | Resurstaggar. | Ordlista med taggnamn och värden. |
properties | Egenskaper för Front Door Load Balancer | FrontDoorProperties |
FrontDoorProperties
Name | Beskrivning | Värde |
---|---|---|
backendPools | Serverdelspooler som är tillgängliga för routningsregler. | BackendPool[] |
backendPoolsSettings | Inställningar för alla backendPools | BackendPoolsSettings |
enabledState | Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är Aktiverade eller Inaktiverade | "Inaktiverad" "Aktiverad" |
friendlyName | Ett eget namn för frontDoor | sträng |
frontendEndpoints | Klientdelsslutpunkter som är tillgängliga för routningsregler. | FrontendEndpoint[] |
healthProbeSettings | Inställningar för hälsoavsökning som är associerade med den här Front Door-instansen. | HealthProbeSettingsModel[] |
loadBalancingSettings | Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen. | LoadBalancingSettingsModel[] |
routingRules | Routningsregler som är associerade med denna Front Door. | RoutingRule[] |
Serverdelspool
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för Front Door-serverdelspoolen | BackendPoolProperties |
BackendPoolProperties
Name | Beskrivning | Värde |
---|---|---|
Backends | Uppsättningen serverdelar för den här poolen | Serverdel[] |
healthProbeSettings | L7-hälsoavsökningsinställningar för en serverdelspool | Underresurs |
loadBalancingSettings | Inställningar för belastningsutjämning för en serverdelspool | Underresurs |
Serverdel
Name | Beskrivning | Värde |
---|---|---|
adress | Plats för serverdelen (IP-adress eller FQDN) | sträng |
backendHostHeader | Det värde som ska användas som värdrubrik som skickas till serverdelen. Om det är tomt eller ospecificerat används den inkommande värden som standard. | sträng |
enabledState | Om du vill aktivera användning av den här serverdelen. Tillåtna värden är Aktiverade eller Inaktiverade | "Inaktiverad" "Aktiverad" |
httpPort | HTTP TCP-portnumret. Måste vara mellan 1 och 65535. | int |
httpsPort | HTTPS TCP-portnumret. Måste vara mellan 1 och 65535. | int |
prioritet | Prioritet att använda för belastningsutjämning. Högre prioriteter används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri. | int |
vikt | Den här slutpunktens vikt för belastningsutjämning. | int |
Underresurs
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
BackendPoolsSettings
Name | Beskrivning | Värde |
---|---|---|
enforceCertificateNameCheck | Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden. | "Inaktiverad" "Aktiverad" |
KlientdelSlutpunkt
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för klientdelsslutpunkten | KlientdelEndpointEgenskaper |
KlientdelEndpointEgenskaper
Name | Beskrivning | Värde |
---|---|---|
Värdnamn | Värdnamnet för frontendEndpoint. Måste vara ett domännamn. | sträng |
sessionAffinityEnabledState | Om sessionstillhörighet ska tillåtas på den här värden. Giltiga alternativ är "Aktiverad" eller "Inaktiverad" | "Inaktiverad" "Aktiverad" |
sessionAffinityTtlSeconds | OANVÄNDA. Det här fältet ignoreras. TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt. | int |
webApplicationFirewallPolicyLink | Definierar Web Application Firewall princip för varje värd (om tillämpligt) | FrontendEndpointUpdateParametersWebApplicationFirewa... |
FrontendEndpointUpdateParametersWebApplicationFirewa...
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
HealthProbeSettingsModel
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för hälsoavsökningsinställningarna | HealthProbeSettingsEgenskaper |
HealthProbeSettingsEgenskaper
Name | Beskrivning | Värde |
---|---|---|
intervalInSeconds | Antalet sekunder mellan hälsoavsökningar. | int |
path | Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/ | sträng |
Protokollet | Protokollschema som ska användas för den här avsökningen | "Http" "Https" |
LoadBalancingSettingsModel
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för belastningsutjämningsinställningarna | LoadBalancingSettingsEgenskaper |
LoadBalancingSettingsEgenskaper
Name | Beskrivning | Värde |
---|---|---|
additionalLatencyMilliseconds | Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med lägst svarstid | int |
sampleSize | Antalet exempel som ska övervägas för beslut om belastningsutjämning | int |
successfulSamplesRequired | Antalet exempel inom exempelperioden som måste lyckas | int |
RoutingRule
Name | Beskrivning | Värde |
---|---|---|
id | Resurs-ID. | sträng |
name | Resursnamn. | sträng |
properties | Egenskaper för frontdörrens routningsregel | RoutingRuleEgenskaper |
RoutingRuleEgenskaper
Name | Beskrivning | Värde |
---|---|---|
acceptedProtocols | Protokollscheman som matchar för den här regeln | Strängmatris som innehåller något av: "Http" "Https" |
enabledState | Om du vill aktivera användning av den här regeln. Tillåtna värden är "aktiverade" eller "inaktiverade" | "Inaktiverad" "Aktiverad" |
frontendEndpoints | Klientdelsslutpunkter som är associerade med den här regeln | SubResource[] |
patternsToMatch | Regelns vägmönster. | string[] |
routeConfiguration | En referens till routningskonfigurationen. | RouteConfiguration |
RouteConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | Ange objekttyp |
#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (krävs) |
VidarebefordranKonfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (krävs) | |
backendPool | En referens till backendPool som den här regeln dirigerar till. | SubResource |
cacheConfiguration | Cachelagringskonfigurationen som är associerad med den här regeln. | CacheConfiguration |
customForwardingPath | En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Lämna tomt om du vill använda inkommande sökväg. | sträng |
forwardingProtocol | Protokoll som den här regeln använder när trafik vidarebefordras till serverdelar. | "HttpOnly" "HttpsOnly" "MatchRequest" |
CacheConfiguration
Name | Beskrivning | Värde |
---|---|---|
dynamicCompression | Om dynamisk komprimering ska användas för cachelagrat innehåll | "Inaktiverad" "Aktiverad" |
queryParameterStripDirective | Behandling av URL-frågetermer när cachenyckeln skapas. | "StripAll" "StripNone" |
RedirectConfiguration
Name | Beskrivning | Värde |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (krävs) | |
customFragment | Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Inkludera inte #. | sträng |
customHost | Värd för omdirigering. Lämna tomt om du vill använda den inkommande värden som målvärd. | sträng |
customPath | Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tomt om du vill använda den inkommande sökvägen som målsökväg. | sträng |
customQueryString | Uppsättningen frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tomt för att bevara den inkommande frågesträngen. Frågesträngen måste vara i {key}={value}-format. Den första? och & läggs till automatiskt, så ta inte med dem längst fram, utan avgränsa flera frågesträngar med &. | sträng |
redirectProtocol | Protokollet för målet dit trafiken omdirigeras | "HttpOnly" "HttpsOnly" "MatchRequest" |
redirectType | Omdirigeringstypen som regeln använder vid omdirigering av trafik. | "Hittades" "Flyttad" "PermanentRedirect" "TemporaryRedirect" |