Microsoft.Network frontDoors 2019-05-01

• Najnowsza
• 2021-06-01
• 2020-05-01
• 2020-04-01
• 2020-01-01
• 2019-05-01
• 2019-04-01
• 2018-08-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"