Microsoft.Network frontDoors 2019-05-01
Definicja zasobu Bicep
Typ zasobu frontDoors można wdrożyć w następujących elementach:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Network/frontDoors, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Network/frontDoors@2019-05-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'
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
}
}
}
]
}
}
Obiekty RouteConfiguration
Ustaw właściwość @odata.type , aby określić typ obiektu.
W przypadku #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration użyj:
'@odata.type': '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
backendPool: {
id: 'string'
}
cacheConfiguration: {
dynamicCompression: 'string'
queryParameterStripDirective: 'string'
}
customForwardingPath: 'string'
forwardingProtocol: 'string'
W przypadku #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration użyj:
'@odata.type': '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
customFragment: 'string'
customHost: 'string'
customPath: 'string'
customQueryString: 'string'
redirectProtocol: 'string'
redirectType: 'string'
Wartości właściwości
frontDoors
Nazwa | Opis | Wartość |
---|---|---|
name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 5–64 Prawidłowe znaki: Alfanumeryczne i łączniki. Rozpoczynanie i kończ od alfanumeryczne. Nazwa zasobu musi być unikatowa na platformie Azure. |
location | Lokalizacja zasobu. | ciąg |
tags | Tagi zasobów. | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
properties | Właściwości Load Balancer usługi Front Door | Właściwości FrontDoorProperties |
Właściwości FrontDoorProperties
Nazwa | Opis | Wartość |
---|---|---|
backendPools | Pule zaplecza dostępne dla reguł rozsyłania. | Pula zaplecza[] |
backendPoolsSettings | Ustawienia dla wszystkich puli zaplecza | BackendPoolsSettings |
enabledState | Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
Friendlyname | Przyjazna nazwa frontDoor | ciąg |
frontendEndpoints | Punkty końcowe frontonu dostępne dla reguł rozsyłania. | FrontendEndpoint[] |
healthProbeSettings | Ustawienia sondy kondycji skojarzone z tym wystąpieniem usługi Front Door. | HealthProbeSettingsModel[] |
loadBalancingSettings | Ustawienia równoważenia obciążenia skojarzone z tym wystąpieniem usługi Front Door. | LoadBalancingSettingsModel[] |
routingRules | Reguły routingu skojarzone z tą usługą Front Door. | RoutingRule[] |
Pula zaplecza
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości puli zaplecza usługi Front Door | Właściwości puli zaplecza |
Właściwości puli zaplecza
Nazwa | Opis | Wartość |
---|---|---|
zaplecza | Zestaw zapleczy dla tej puli | Zaplecze[] |
healthProbeSettings | Ustawienia sondy kondycji L7 dla puli zaplecza | Podźródło |
loadBalancingSettings | Ustawienia równoważenia obciążenia dla puli zaplecza | Podźródło |
Zaplecze
Nazwa | Opis | Wartość |
---|---|---|
adres | Lokalizacja zaplecza (adres IP lub nazwa FQDN) | ciąg |
backendHostHeader | Wartość, która ma być używana jako nagłówek hosta wysyłany do zaplecza. Jeśli wartość jest pusta lub nieokreślona, zostanie ustawiona wartość domyślna hosta przychodzącego. | ciąg |
enabledState | Czy włączyć korzystanie z tego zaplecza. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
httpPort | Numer portu TCP PROTOKOŁU HTTP. Musi zawierać się w zakresie od 1 do 65535. | int |
httpsPort | Numer portu TCP protokołu HTTPS. Musi zawierać się w zakresie od 1 do 65535. | int |
priority | Priorytet używany do równoważenia obciążenia. Wyższe priorytety nie będą używane do równoważenia obciążenia, jeśli zaplecze o niższym priorycie jest w dobrej kondycji. | int |
waga | Waga tego punktu końcowego na potrzeby równoważenia obciążenia. | int |
Podźródło
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
BackendPoolsSettings
Nazwa | Opis | Wartość |
---|---|---|
enforceCertificateNameCheck | Czy wymusić sprawdzanie nazwy certyfikatu dla żądań HTTPS do wszystkich pul zaplecza. Brak wpływu na żądania inne niż HTTPS. | "Wyłączone" "Włączone" |
sendRecvTimeoutSeconds | Wysyłanie i odbieranie limitu czasu żądania przekazywania do zaplecza. Po osiągnięciu limitu czasu żądanie kończy się niepowodzeniem i zwraca. | int |
Punkt końcowy frontonu
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości punktu końcowego frontonu | Właściwości frontonendendpoint |
Właściwości frontonendendpoint
Nazwa | Opis | Wartość |
---|---|---|
Nazwa hosta | Nazwa hosta frontonuEndpoint. Musi być nazwą domeny. | ciąg |
sessionAffinityEnabledState | Czy zezwolić na koligację sesji na tym hoście. Prawidłowe opcje to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
sessionAffinityTtlSeconds | NIEUŻYWANE. To pole zostanie zignorowane. Czas wygaśnięcia używany w sekundach dla koligacji sesji, jeśli ma to zastosowanie. | int |
webApplicationFirewallPolicyLink | Definiuje zasady Web Application Firewall dla każdego hosta (jeśli dotyczy) | FrontendEndpointUpdateParametersWebApplicationFirewa... |
FrontendEndpointUpdateParametersWebApplicationFirewa...
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
HealthProbeSettingsModel
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości ustawień sondy kondycji | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Nazwa | Opis | Wartość |
---|---|---|
enabledState | Czy włączyć sondy kondycji do tworzenia względem zaplecza zdefiniowanych w ramach puli zaplecza. Sondy kondycji można wyłączyć tylko wtedy, gdy w puli zaplecza z obsługą pojedynczego zaplecza jest włączona pojedyncza. | "Wyłączone" "Włączone" |
healthProbeMethod | Konfiguruje metodę HTTP używaną do sondowania zaplecza zdefiniowanych w obszarze backendPools. | "GET" "HEAD" |
intervalInSeconds | Liczba sekund między sondami kondycji. | int |
path | Ścieżka do użycia dla sondy kondycji. Wartość domyślna to / | ciąg |
Protokół | Schemat protokołu do użycia dla tej sondy | "Http" "Https" |
LoadBalancingSettingsModel
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości ustawień równoważenia obciążenia | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Nazwa | Opis | Wartość |
---|---|---|
additionalLatencyMilliseconds | Dodatkowe opóźnienie w milisekundach dla sond w celu uwzględnienia najniższego opóźnienia zasobnika | int |
sampleSize | Liczba przykładów, które należy wziąć pod uwagę podczas podejmowania decyzji dotyczących równoważenia obciążenia | int |
successfulSamplesRequired | Liczba próbek w okresie próbnym, które muszą zakończyć się powodzeniem | int |
RoutingRule
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości reguły routingu usługi Front Door | RoutingRuleProperties |
RoutingRuleProperties
Nazwa | Opis | Wartość |
---|---|---|
acceptedProtocols | Schematy protokołów zgodne z tą regułą | Tablica ciągów zawierająca dowolną z: "Http" "Https" |
enabledState | Czy włączyć korzystanie z tej reguły. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
frontendEndpoints | Punkty końcowe frontonu skojarzone z tą regułą | Podźródło[] |
patternsToMatch | Wzorce tras reguły. | ciąg[] |
routeConfiguration | Odwołanie do konfiguracji routingu. | RouteConfiguration |
RouteConfiguration
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | Ustawianie typu obiektu |
#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (wymagane) |
Przekazywaniekonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (wymagane) | |
pula zaplecza | Odwołanie do puli zaplecza, do której ta reguła kieruje. | Podźródło |
cacheConfiguration | Konfiguracja buforowania skojarzona z tą regułą. | CacheConfiguration |
customForwardingPath | Ścieżka niestandardowa używana do ponownego zapisywania ścieżek zasobów pasowanych przez tę regułę. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej. | ciąg |
forwardingProtocol | Protokół tej reguły będzie używany podczas przekazywania ruchu do zaplecza. | "HttpOnly" "HttpsOnly" "MatchRequest" |
CacheConfiguration
Nazwa | Opis | Wartość |
---|---|---|
dynamicCompression | Czy używać kompresji dynamicznej dla buforowanej zawartości | "Wyłączone" "Włączone" |
queryParameterStripDirective | Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej. | "StripAll" "StripNone" |
PrzekierowanieKonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (wymagane) | |
customFragment | Fragment do dodania do adresu URL przekierowania. Fragment jest częścią adresu URL, który pochodzi po pliku #. Nie dołączaj pliku #. | ciąg |
customHost | Host do przekierowania. Pozostaw wartość pustą, aby użyć hosta przychodzącego jako hosta docelowego. | ciąg |
customPath | Pełna ścieżka do przekierowania. Ścieżka nie może być pusta i musi zaczynać się od /. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej jako ścieżki docelowej. | ciąg |
customQueryString | Zestaw ciągów zapytania do umieszczenia w adresie URL przekierowania. Ustawienie tej wartości spowoduje zastąpienie wszystkich istniejących ciągów zapytania; pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania. Ciąg zapytania musi być w formacie {key}={value}. Pierwszy ? i & zostaną dodane automatycznie, więc nie dołączają ich do przodu, ale oddzielają wiele ciągów zapytania za pomocą &. | ciąg |
redirectProtocol | Protokół miejsca docelowego, do którego jest przekierowywany ruch | "HttpOnly" "HttpsOnly" "MatchRequest" |
redirectType | Typ przekierowania, który będzie używany podczas przekierowywania ruchu. | "Znaleziono" "Przeniesiono" "PermanentRedirect" "TemporaryRedirect" |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Template | Opis |
---|---|
Tworzenie usługi Azure Front Door przed usługą Azure API Management |
W tym przykładzie pokazano, jak używać usługi Azure Front Door jako globalnego modułu równoważenia obciążenia przed usługą Azure API Management. |
Tworzenie podstawowej usługi Front Door |
Ten szablon tworzy podstawową konfigurację usługi Front Door z pojedynczym zapleczem. |
Tworzenie usługi Front Door z buforowaniem włączonym dla niektórych tras |
Ten szablon tworzy usługę Front Door z włączoną buforowaniem dla zdefiniowanej konfiguracji routingu, co powoduje buforowanie wszystkich statycznych zasobów dla obciążenia. |
Tworzenie usługi Front Door z wieloma zapleczami i pulami zaplecza |
Ten szablon tworzy usługę Front Door z równoważeniem obciążenia skonfigurowanym dla wielu zapleczy w puli zaplecza, a także między pulami zaplecza na podstawie ścieżki adresu URL. |
Tworzenie usługi Front Door z przekierowaniem HTTP do https |
Ten szablon tworzy konfigurację usługi Front Door na potrzeby przekierowania PROTOKOŁU HTTP do PROTOKOŁU HTTPS. |
Dodawanie domeny niestandardowej i certyfikatu zarządzanego za pomocą usługi Front Door |
Ten szablon dołącza i zabezpiecza domenę niestandardową za pomocą usługi Front Door |
Dodawanie domeny niestandardowej i certyfikatu niestandardowego za pomocą usługi Front Door |
Ten szablon dołącza i zabezpiecza domenę niestandardową za pomocą usługi Front Door przy użyciu certyfikatu zarządzanego przez klienta |
Kontrolowanie sond kondycji zapleczy w usłudze Front Door |
Ten szablon aktualizuje usługę Front Door, aby zmienić ustawienia sondy kondycji, ustawiając ścieżkę sondy, a także interwały, w których będą wysyłane sondy. |
Tworzenie usługi Front Door przy użyciu konfiguracji Active-Standby |
Ten szablon tworzy usługę Front Door, która demonstruje routing oparty na priorytecie dla topologii aplikacji Active-Standby. |
Konfigurowanie koligacji sesji dla nazw hostów usługi Front Door |
Ten szablon aktualizuje usługę Front Door, aby umożliwić koligację sesji dla hosta frontonu, wysyłając w ten sposób kolejny ruch z tej samej sesji użytkownika do tego samego zaplecza. |
Definicja zasobu szablonu usługi ARM
Typ zasobu frontDoors można wdrożyć w następujących elementach:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Network/frontDoors, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Network/frontDoors",
"apiVersion": "2019-05-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",
"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
}
}
}
]
}
}
Obiekty RouteConfiguration
Ustaw właściwość @odata.type , aby określić typ obiektu.
W przypadku #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration użyj:
"@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
"backendPool": {
"id": "string"
},
"cacheConfiguration": {
"dynamicCompression": "string",
"queryParameterStripDirective": "string"
},
"customForwardingPath": "string",
"forwardingProtocol": "string"
W przypadku #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration użyj:
"@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
"customFragment": "string",
"customHost": "string",
"customPath": "string",
"customQueryString": "string",
"redirectProtocol": "string",
"redirectType": "string"
Wartości właściwości
frontDoors
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ zasobu | "Microsoft.Network/frontDoors" |
apiVersion | Wersja interfejsu API zasobów | '2019-05-01' |
name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 5-64 Prawidłowe znaki: Alfanumeryczne i łączniki. Rozpocznij i zakończ od alfanumeryczne. Nazwa zasobu musi być unikatowa na platformie Azure. |
location | Lokalizacja zasobu. | ciąg |
tags | Tagi zasobów. | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
properties | Właściwości Load Balancer usługi Front Door | Właściwości FrontDoorProperties |
Właściwości FrontDoorProperties
Nazwa | Opis | Wartość |
---|---|---|
puli zaplecza | Pule zaplecza dostępne dla reguł routingu. | Pula zaplecza[] |
backendPoolsSettings | Ustawienia dla wszystkich puli zaplecza | BackendPoolsSettings |
enabledState | Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
Friendlyname | Przyjazna nazwa frontDoor | ciąg |
frontendEndpoints | Punkty końcowe frontonu dostępne dla reguł routingu. | FrontendEndpoint[] |
healthProbeSettings | Ustawienia sondy kondycji skojarzone z tym wystąpieniem usługi Front Door. | HealthProbeSettingsModel[] |
loadBalancingSettings | Ustawienia równoważenia obciążenia skojarzone z tym wystąpieniem usługi Front Door. | LoadBalancingSettingsModel[] |
routingRules | Reguły routingu skojarzone z tą usługą Front Door. | RoutingRule[] |
Pula zaplecza
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości puli zaplecza usługi Front Door | BackendPoolProperties |
BackendPoolProperties
Nazwa | Opis | Wartość |
---|---|---|
zaplecza | Zestaw zapleczy dla tej puli | Zaplecze[] |
healthProbeSettings | Ustawienia sondy kondycji L7 dla puli zaplecza | Podźródło |
loadBalancingSettings | Ustawienia równoważenia obciążenia dla puli zaplecza | Podźródło |
Zaplecze
Nazwa | Opis | Wartość |
---|---|---|
adres | Lokalizacja zaplecza (adres IP lub nazwa FQDN) | ciąg |
backendHostHeader | Wartość do użycia jako nagłówek hosta wysłany do zaplecza. Jeśli jest to puste lub nieokreślone, domyślnie jest to host przychodzący. | ciąg |
enabledState | Czy włączyć korzystanie z tego zaplecza. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
httpPort | Numer portu TCP PROTOKOŁU HTTP. Musi należeć do zakresu od 1 do 65535. | int |
httpsPort | Numer portu TCP PROTOKOŁU HTTPS. Musi należeć do zakresu od 1 do 65535. | int |
priority | Priorytet używany do równoważenia obciążenia. Wyższe priorytety nie będą używane do równoważenia obciążenia, jeśli zaplecze o niższym priorytcie jest w dobrej kondycji. | int |
waga | Waga tego punktu końcowego na potrzeby równoważenia obciążenia. | int |
Podźródło
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
BackendPoolsSettings
Nazwa | Opis | Wartość |
---|---|---|
enforceCertificateNameCheck | Czy wymusić sprawdzanie nazwy certyfikatu na żądaniach HTTPS do wszystkich pul zaplecza. Brak wpływu na żądania inne niż HTTPS. | "Wyłączone" "Włączone" |
sendRecvTimeoutSeconds | Wysyłanie i odbieranie limitu czasu żądania przesyłania dalej do zaplecza. Po osiągnięciu limitu czasu żądanie kończy się niepowodzeniem i zwraca. | int |
Punkt końcowy frontonu
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości punktu końcowego frontonu | FrontendEndpointProperties |
FrontendEndpointProperties
Nazwa | Opis | Wartość |
---|---|---|
Nazwa hosta | Nazwa hosta frontonuEndpoint. Musi być nazwą domeny. | ciąg |
sessionAffinityEnabledState | Czy zezwolić na koligację sesji na tym hoście. Prawidłowe opcje to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
sessionAffinityTtlSeconds | NIEUŻYWANE. To pole zostanie zignorowane. Czas wygaśnięcia używany w sekundach dla koligacji sesji, jeśli ma to zastosowanie. | int |
webApplicationFirewallPolicyLink | Definiuje zasady Web Application Firewall dla każdego hosta (jeśli dotyczy) | FrontendEndpointUpdateParametersWebApplicationFirewa... |
FrontendEndpointUpdateParametersWebApplicationFirewa...
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
HealthProbeSettingsModel
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości ustawień sondy kondycji | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Nazwa | Opis | Wartość |
---|---|---|
enabledState | Czy włączyć sondy kondycji do tworzenia względem zaplecza zdefiniowanych w ramach puli zaplecza. Sondy kondycji można wyłączyć tylko wtedy, gdy w puli zaplecza z obsługą pojedynczego zaplecza jest włączona pojedyncza. | "Wyłączone" "Włączone" |
healthProbeMethod | Konfiguruje metodę HTTP używaną do sondowania zaplecza zdefiniowanych w obszarze backendPools. | "GET" "HEAD" |
intervalInSeconds | Liczba sekund między sondami kondycji. | int |
path | Ścieżka do użycia dla sondy kondycji. Wartość domyślna to / | ciąg |
Protokół | Schemat protokołu do użycia dla tej sondy | "Http" "Https" |
LoadBalancingSettingsModel
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości ustawień równoważenia obciążenia | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Nazwa | Opis | Wartość |
---|---|---|
additionalLatencyMilliseconds | Dodatkowe opóźnienie w milisekundach dla sond w celu uwzględnienia najniższego opóźnienia zasobnika | int |
sampleSize | Liczba przykładów, które należy wziąć pod uwagę podczas podejmowania decyzji dotyczących równoważenia obciążenia | int |
successfulSamplesRequired | Liczba próbek w okresie próbnym, które muszą zakończyć się powodzeniem | int |
RoutingRule
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości reguły routingu usługi Front Door | RoutingRuleProperties |
RoutingRuleProperties
Nazwa | Opis | Wartość |
---|---|---|
acceptedProtocols | Schematy protokołów zgodne z tą regułą | Tablica ciągów zawierająca dowolną z: "Http" "Https" |
enabledState | Czy włączyć korzystanie z tej reguły. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
frontendEndpoints | Punkty końcowe frontonu skojarzone z tą regułą | Podźródło[] |
patternsToMatch | Wzorce tras reguły. | ciąg[] |
routeConfiguration | Odwołanie do konfiguracji routingu. | RouteConfiguration |
RouteConfiguration
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | Ustawianie typu obiektu |
#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (wymagane) |
Przekazywaniekonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (wymagane) | |
pula zaplecza | Odwołanie do puli zaplecza, do której ta reguła kieruje. | Podźródło |
cacheConfiguration | Konfiguracja buforowania skojarzona z tą regułą. | CacheConfiguration |
customForwardingPath | Ścieżka niestandardowa używana do ponownego zapisywania ścieżek zasobów pasowanych przez tę regułę. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej. | ciąg |
forwardingProtocol | Protokół tej reguły będzie używany podczas przekazywania ruchu do zaplecza. | "HttpOnly" "HttpsOnly" "MatchRequest" |
CacheConfiguration
Nazwa | Opis | Wartość |
---|---|---|
dynamicCompression | Czy używać kompresji dynamicznej dla buforowanej zawartości | "Wyłączone" "Włączone" |
queryParameterStripDirective | Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej. | "StripAll" "StripNone" |
PrzekierowanieKonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (wymagane) | |
customFragment | Fragment do dodania do adresu URL przekierowania. Fragment jest częścią adresu URL, który pochodzi po pliku #. Nie dołączaj pliku #. | ciąg |
customHost | Host do przekierowania. Pozostaw wartość pustą, aby użyć hosta przychodzącego jako hosta docelowego. | ciąg |
customPath | Pełna ścieżka do przekierowania. Ścieżka nie może być pusta i musi zaczynać się od /. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej jako ścieżki docelowej. | ciąg |
customQueryString | Zestaw ciągów zapytania do umieszczenia w adresie URL przekierowania. Ustawienie tej wartości spowoduje zastąpienie wszystkich istniejących ciągów zapytania; pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania. Ciąg zapytania musi być w formacie {key}={value}. Pierwszy ? i & zostaną dodane automatycznie, więc nie dołączają ich do przodu, ale oddzielają wiele ciągów zapytania za pomocą &. | ciąg |
redirectProtocol | Protokół miejsca docelowego, do którego jest przekierowywany ruch | "HttpOnly" "HttpsOnly" "MatchRequest" |
redirectType | Typ przekierowania, który będzie używany podczas przekierowywania ruchu. | "Znaleziono" "Przeniesiono" "PermanentRedirect" "TemporaryRedirect" |
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Template | Opis |
---|---|
Tworzenie usługi Azure Front Door przed usługą Azure API Management |
W tym przykładzie pokazano, jak używać usługi Azure Front Door jako globalnego modułu równoważenia obciążenia przed usługą Azure API Management. |
Tworzenie podstawowej usługi Front Door |
Ten szablon tworzy podstawową konfigurację usługi Front Door z pojedynczym zapleczem. |
Tworzenie usługi Front Door z buforowaniem włączonym dla niektórych tras |
Ten szablon tworzy usługę Front Door z włączoną buforowaniem dla zdefiniowanej konfiguracji routingu, co powoduje buforowanie wszystkich statycznych zasobów dla obciążenia. |
Tworzenie usługi Front Door z wieloma zapleczami i pulami zaplecza |
Ten szablon tworzy usługę Front Door z równoważeniem obciążenia skonfigurowanym dla wielu zapleczy w puli zaplecza, a także między pulami zaplecza na podstawie ścieżki adresu URL. |
Tworzenie usługi Front Door z przekierowaniem HTTP do https |
Ten szablon tworzy konfigurację usługi Front Door na potrzeby przekierowania PROTOKOŁU HTTP do PROTOKOŁU HTTPS. |
Dodawanie domeny niestandardowej i certyfikatu zarządzanego za pomocą usługi Front Door |
Ten szablon dołącza i zabezpiecza domenę niestandardową za pomocą usługi Front Door |
Dodawanie domeny niestandardowej i certyfikatu niestandardowego za pomocą usługi Front Door |
Ten szablon dołącza i zabezpiecza domenę niestandardową za pomocą usługi Front Door przy użyciu certyfikatu zarządzanego przez klienta |
Kontrolowanie sond kondycji zapleczy w usłudze Front Door |
Ten szablon aktualizuje usługę Front Door, aby zmienić ustawienia sondy kondycji, ustawiając ścieżkę sondy, a także interwały, w których będą wysyłane sondy. |
Tworzenie usługi Front Door przy użyciu konfiguracji Active-Standby |
Ten szablon tworzy usługę Front Door, która demonstruje routing oparty na priorytecie dla topologii aplikacji Active-Standby. |
Konfigurowanie koligacji sesji dla nazw hostów usługi Front Door |
Ten szablon aktualizuje usługę Front Door, aby umożliwić koligację sesji dla hosta frontonu, wysyłając w ten sposób kolejny ruch z tej samej sesji użytkownika do tego samego zaplecza. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu frontDoors można wdrożyć w następujących elementach:
- Grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Network/frontDoors, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/frontDoors@2019-05-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"
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
}
}
}
]
}
})
}
Obiekty RouteConfiguration
Ustaw właściwość @odata.type , aby określić typ obiektu.
W przypadku #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration użyj:
@odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
backendPool = {
id = "string"
}
cacheConfiguration = {
dynamicCompression = "string"
queryParameterStripDirective = "string"
}
customForwardingPath = "string"
forwardingProtocol = "string"
W przypadku #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration użyj:
@odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
customFragment = "string"
customHost = "string"
customPath = "string"
customQueryString = "string"
redirectProtocol = "string"
redirectType = "string"
Wartości właściwości
frontDoors
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ zasobu | "Microsoft.Network/frontDoors@2019-05-01" |
name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 5–64 Prawidłowe znaki: Alfanumeryczne i łączniki. Rozpoczynanie i kończ od alfanumeryczne. Nazwa zasobu musi być unikatowa na platformie Azure. |
location | Lokalizacja zasobu. | ciąg |
parent_id | Aby przeprowadzić wdrożenie w grupie zasobów, użyj identyfikatora tej grupy zasobów. | ciąg (wymagany) |
tags | Tagi zasobów. | Słownik nazw tagów i wartości. |
properties | Właściwości Load Balancer usługi Front Door | Właściwości FrontDoorProperties |
Właściwości FrontDoorProperties
Nazwa | Opis | Wartość |
---|---|---|
backendPools | Pule zaplecza dostępne dla reguł rozsyłania. | Pula zaplecza[] |
backendPoolsSettings | Ustawienia dla wszystkich puli zaplecza | BackendPoolsSettings |
enabledState | Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
Friendlyname | Przyjazna nazwa frontDoor | ciąg |
frontendEndpoints | Punkty końcowe frontonu dostępne dla reguł rozsyłania. | FrontendEndpoint[] |
healthProbeSettings | Ustawienia sondy kondycji skojarzone z tym wystąpieniem usługi Front Door. | HealthProbeSettingsModel[] |
loadBalancingSettings | Ustawienia równoważenia obciążenia skojarzone z tym wystąpieniem usługi Front Door. | LoadBalancingSettingsModel[] |
routingRules | Reguły routingu skojarzone z tą usługą Front Door. | RoutingRule[] |
Pula zaplecza
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości puli zaplecza usługi Front Door | Właściwości puli zaplecza |
Właściwości puli zaplecza
Nazwa | Opis | Wartość |
---|---|---|
zaplecza | Zestaw zapleczy dla tej puli | Zaplecze[] |
healthProbeSettings | Ustawienia sondy kondycji L7 dla puli zaplecza | Podźródło |
loadBalancingSettings | Ustawienia równoważenia obciążenia dla puli zaplecza | Podźródło |
Zaplecze
Nazwa | Opis | Wartość |
---|---|---|
adres | Lokalizacja zaplecza (adres IP lub nazwa FQDN) | ciąg |
backendHostHeader | Wartość, która ma być używana jako nagłówek hosta wysyłany do zaplecza. Jeśli wartość jest pusta lub nieokreślona, zostanie ustawiona wartość domyślna hosta przychodzącego. | ciąg |
enabledState | Czy włączyć korzystanie z tego zaplecza. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
httpPort | Numer portu TCP PROTOKOŁU HTTP. Musi zawierać się w zakresie od 1 do 65535. | int |
httpsPort | Numer portu TCP protokołu HTTPS. Musi zawierać się w zakresie od 1 do 65535. | int |
priority | Priorytet używany do równoważenia obciążenia. Wyższe priorytety nie będą używane do równoważenia obciążenia, jeśli zaplecze o niższym priorycie jest w dobrej kondycji. | int |
waga | Waga tego punktu końcowego na potrzeby równoważenia obciążenia. | int |
Podźródło
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
BackendPoolsSettings
Nazwa | Opis | Wartość |
---|---|---|
enforceCertificateNameCheck | Czy wymusić sprawdzanie nazwy certyfikatu dla żądań HTTPS do wszystkich pul zaplecza. Brak wpływu na żądania inne niż HTTPS. | "Wyłączone" "Włączone" |
sendRecvTimeoutSeconds | Wysyłanie i odbieranie limitu czasu żądania przekazywania do zaplecza. Po osiągnięciu limitu czasu żądanie kończy się niepowodzeniem i zwraca. | int |
Punkt końcowy frontonu
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości punktu końcowego frontonu | Właściwości frontonendendpoint |
Właściwości frontonendendpoint
Nazwa | Opis | Wartość |
---|---|---|
Nazwa hosta | Nazwa hosta frontonuEndpoint. Musi być nazwą domeny. | ciąg |
sessionAffinityEnabledState | Czy zezwolić na koligację sesji na tym hoście. Prawidłowe opcje to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
sessionAffinityTtlSeconds | NIEUŻYWANE. To pole zostanie zignorowane. Czas wygaśnięcia używany w sekundach dla koligacji sesji, jeśli ma to zastosowanie. | int |
webApplicationFirewallPolicyLink | Definiuje zasady Web Application Firewall dla każdego hosta (jeśli dotyczy) | FrontendEndpointUpdateParametersWebApplicationFirewa... |
FrontendEndpointUpdateParametersWebApplicationFirewa...
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
HealthProbeSettingsModel
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości ustawień sondy kondycji | HealthProbeSettingsProperties |
HealthProbeSettingsProperties
Nazwa | Opis | Wartość |
---|---|---|
enabledState | Określa, czy należy włączyć sondy kondycji dla zapleczy zdefiniowanych w obszarze backendPools. Sondy kondycji można wyłączyć tylko wtedy, gdy istnieje pojedyncze włączone zaplecze w pojedynczej puli zaplecza z włączoną obsługą. | "Wyłączone" "Włączone" |
healthProbeMethod | Konfiguruje metodę HTTP używaną do sondowania zapleczy zdefiniowanych w obszarze backendPools. | "GET" "HEAD" |
intervalInSeconds | Liczba sekund między sondami kondycji. | int |
path | Ścieżka do użycia dla sondy kondycji. Wartość domyślna to / | ciąg |
Protokół | Schemat protokołu do użycia dla tej sondy | "Http" "Https" |
LoadBalancingSettingsModel
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości ustawień równoważenia obciążenia | LoadBalancingSettingsProperties |
LoadBalancingSettingsProperties
Nazwa | Opis | Wartość |
---|---|---|
additionalLatencyMilliseconds | Dodatkowe opóźnienie w milisekundach dla sond do przedziału o najmniejszym opóźnieniu | int |
sampleSize | Liczba próbek, które należy wziąć pod uwagę podczas podejmowania decyzji dotyczących równoważenia obciążenia | int |
successfulSamplesRequired | Liczba próbek w okresie próby, które muszą zakończyć się powodzeniem | int |
RoutingRule
Nazwa | Opis | Wartość |
---|---|---|
identyfikator | Identyfikator zasobu. | ciąg |
name | Nazwa zasobu. | ciąg |
properties | Właściwości reguły routingu usługi Front Door | RoutingRuleProperties |
RoutingRuleProperties
Nazwa | Opis | Wartość |
---|---|---|
acceptedProtocols | Schematy protokołów zgodne z tą regułą | Tablica ciągów zawierająca dowolną z: "Http" "Https" |
enabledState | Czy włączyć korzystanie z tej reguły. Dozwolone wartości to "Włączone" lub "Wyłączone" | "Wyłączone" "Włączone" |
frontendEndpoints | Punkty końcowe frontonu skojarzone z tą regułą | Podźródło[] |
patternsToMatch | Wzorce tras reguły. | ciąg[] |
routeConfiguration | Odwołanie do konfiguracji routingu. | RouteConfiguration |
RouteConfiguration
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | Ustawianie typu obiektu |
#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration (wymagane) |
ForwardingConfiguration
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (wymagane) | |
pula zaplecza | Odwołanie do puli zaplecza, do której kieruje ta reguła. | Podźródło |
cacheConfiguration | Konfiguracja buforowania skojarzona z tą regułą. | CacheConfiguration |
customForwardingPath | Ścieżka niestandardowa używana do ponownego zapisywania ścieżek zasobów pasowanych przez tę regułę. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej. | ciąg |
forwardingProtocol | Protokół tej reguły będzie używany podczas przekazywania ruchu do zaplecza. | "HttpOnly" "HttpsOnly" "MatchRequest" |
CacheConfiguration
Nazwa | Opis | Wartość |
---|---|---|
dynamicCompression | Czy używać kompresji dynamicznej dla buforowanej zawartości | "Wyłączone" "Włączone" |
queryParameterStripDirective | Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej. | "StripAll" "StripNone" |
PrzekierowanieKonfiguracja
Nazwa | Opis | Wartość |
---|---|---|
@odata.type | "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (wymagane) | |
customFragment | Fragment do dodania do adresu URL przekierowania. Fragment jest częścią adresu URL, który pochodzi po pliku #. Nie dołączaj pliku #. | ciąg |
customHost | Host do przekierowania. Pozostaw wartość pustą, aby użyć hosta przychodzącego jako hosta docelowego. | ciąg |
customPath | Pełna ścieżka do przekierowania. Ścieżka nie może być pusta i musi zaczynać się od /. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej jako ścieżki docelowej. | ciąg |
customQueryString | Zestaw ciągów zapytania do umieszczenia w adresie URL przekierowania. Ustawienie tej wartości spowoduje zastąpienie wszystkich istniejących ciągów zapytania; pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania. Ciąg zapytania musi być w formacie {key}={value}. Pierwszy ? i & zostaną dodane automatycznie, więc nie dołączają ich do przodu, ale oddzielają wiele ciągów zapytania za pomocą &. | ciąg |
redirectProtocol | Protokół miejsca docelowego, do którego jest przekierowywany ruch | "HttpOnly" "HttpsOnly" "MatchRequest" |
redirectType | Typ przekierowania, który będzie używany podczas przekierowywania ruchu. | "Znaleziono" "Przeniesiono" "PermanentRedirect" "TemporaryRedirect" |