Akcje zestawu reguł

Zestaw reguł usługi Azure Front Door składa się z reguł z kombinacją warunków dopasowania i akcji. Ten artykuł zawiera szczegółowy opis akcji, których można używać w zestawie reguł. Akcja definiuje zachowanie, które jest stosowane do typu żądania, który identyfikuje warunki dopasowania. W zestawie reguł reguł reguł może mieć maksymalnie pięć akcji. Usługa Front Door obsługuje również zmienną serwera w akcji zestawu reguł.

Następujące akcje są dostępne do użycia w zestawie reguł:

Przesłonięcia konfiguracji trasy

Akcja przesłonięcia konfiguracji trasy służy do zastępowania grupy pochodzenia lub konfiguracji buforowania dla żądania. Możesz zastąpić lub wyróżnić konfiguracje grup pochodzenia określone w trasie. Jednak po zastąpieniu konfiguracji trasy należy skonfigurować buforowanie. W przeciwnym razie buforowanie jest wyłączone dla żądania.

Możesz również zastąpić sposób buforowania plików dla określonych żądań, w tym:

  • Zastąpi zachowanie buforowania określone przez źródło.
  • Sposób użycia parametrów ciągu zapytania do wygenerowania klucza pamięci podręcznej żądania.
  • Wartość czasu wygaśnięcia (TTL) w celu kontrolowania czasu przechowywania zawartości w pamięci podręcznej.

Właściwości

Właściwości Obsługiwane wartości
Zastąpij grupę źródeł
  • Tak: przesłoń grupę pochodzenia używaną dla żądania.
  • Nie: użyj grupy pochodzenia określonej w trasie.
Buforowanie
  • Włączone: Wymuś włączenie buforowania dla żądania.
  • Wyłączone: Wymuś wyłączenie buforowania dla żądania.

Po ustawieniu opcji Przesłoń grupę źródeł na Wartość Tak ustaw następujące właściwości:

Właściwości Obsługiwane wartości
Grupa pochodzenia Grupa pochodzenia, do którego powinno zostać skierowane żądanie. To ustawienie zastępuje konfigurację określoną w trasie punktu końcowego usługi Front Door.
Protokół przesyłania dalej Protokół usługi Front Door do użycia podczas przekazywania żądania do źródła. Obsługiwane wartości to tylko HTTP, TYLKO HTTPS, Dopasuj żądanie przychodzące. To ustawienie zastępuje konfigurację określoną w trasie punktu końcowego usługi Front Door.

Po ustawieniu Buforowanie na wartość Włączone ustaw następujące właściwości:

Właściwości Obsługiwane wartości
Buforowanie łańcuchów zapytań
  • Ignoruj ciąg zapytania: ciągi zapytania nie są brane pod uwagę podczas generowania klucza pamięci podręcznej. W szablonach usługi ARM ustaw queryStringCachingBehavior właściwość na IgnoreQueryString.
  • Użyj ciągu zapytania: każdy unikatowy adres URL ma własny klucz pamięci podręcznej. W szablonach usługi ARM użyj elementu queryStringCachingBehaviorUseQueryString.
  • Ignoruj określony ciąg zapytania: ciągi zapytania określone w parametrach są wykluczane po wygenerowaniu klucza pamięci podręcznej. W szablonach usługi ARM ustaw queryStringCachingBehavior właściwość na IgnoreSpecifiedQueryStrings.
  • Uwzględnij określony ciąg zapytania: ciągi zapytania określone w parametrach są uwzględniane podczas generowania klucza pamięci podręcznej. W szablonach usługi ARM ustaw queryStringCachingBehavior właściwość na IncludeSpecifiedQueryStrings.
Parametry zapytań Lista nazw parametrów ciągu zapytania oddzielona przecinkami. Ta właściwość jest ustawiana tylko wtedy, gdy zachowanie buforowania ciągów zapytania ma wartość Ignoruj określone ciągi zapytania lub Uwzględnij określone ciągi zapytania.
Kompresja
  • Włączone: usługa Front Door dynamicznie kompresuje zawartość na krawędzi, co powoduje mniejszą i szybszą odpowiedź. Aby uzyskać więcej informacji, zobacz Kompresja plików. W szablonach usługi ARM ustaw isCompressionEnabled właściwość na Enabled.
  • Wyłączone. Usługa Front Door nie wykonuje kompresji. W szablonach usługi ARM ustaw isCompressionEnabled właściwość na Disabled.
Zachowanie pamięci podręcznej
  • Pochodzenie honoru: usługa Front Door zawsze honoruje dyrektywę nagłówka odpowiedzi pochodzenia. Jeśli brakuje dyrektywy pochodzenia, usługa Front Door buforuje zawartość w dowolnym miejscu od 1 do 3 dni. W szablonach usługi ARM ustaw cacheBehavior właściwość na HonorOrigin.
  • Przesłonięcia zawsze: wartość czasu wygaśnięcia zwrócona ze źródła jest zastępowana wartością określoną w akcji. To zachowanie jest stosowane tylko wtedy, gdy odpowiedź jest zapisywana w pamięci podręcznej. W szablonach usługi ARM ustaw cacheBehavior właściwość na OverrideAlways.
  • Zastąpij, jeśli brakuje źródła: jeśli żadna wartość czasu wygaśnięcia nie zostanie zwrócona z źródła, reguła ustawia czas wygaśnięcia na wartość określoną w akcji. To zachowanie jest stosowane tylko wtedy, gdy odpowiedź jest zapisywana w pamięci podręcznej. W szablonach usługi ARM ustaw cacheBehavior właściwość na OverrideIfOriginMissing.
Czas trwania pamięci podręcznej Gdy zachowanie pamięci podręcznej jest ustawione na Override always lub Override if origin missing, te pola muszą określać czas trwania pamięci podręcznej do użycia. Maksymalny czas trwania to 366 dni. W ciągu 0 sekund usługa CDN buforuje zawartość, ale musi ponownie poznać każde żądanie z serwerem pochodzenia. Ta właściwość jest ustawiana tylko wtedy, gdy zachowanie pamięci podręcznej jest ustawione na Wartość Zastąpić zawsze lub Zastąpić, jeśli brakuje źródła.
  • W witrynie Azure Portal określ dni, godziny, minuty i sekundy.
  • W szablonach usługi ARM: użyj elementu , cacheDuration aby określić czas trwania w formacie d.hh:mm:ss.

Przykłady

W tym przykładzie kierujemy wszystkie dopasowane żądania do grupy pochodzenia o nazwie MyOriginGroup, niezależnie od konfiguracji na trasie punktu końcowego usługi Front Door.

Zrzut ekranu portalu przedstawiający akcję zastąpienia grupy pochodzenia.

W tym przykładzie ustawiliśmy klucz pamięci podręcznej tak, aby zawierał parametr ciągu zapytania o nazwie customerId. Kompresja jest włączona, a zasady buforowania źródła są uznawane.

Zrzut ekranu portalu przedstawiający akcję ciągu zapytania klucza pamięci podręcznej.

W tym przykładzie zastąpimy wygaśnięcie pamięci podręcznej do 6 godzin dla dopasowanych żądań, które nie określają już czasu trwania pamięci podręcznej. Usługa Front Door ignoruje ciąg zapytania, gdy określa klucz pamięci podręcznej, a kompresja jest włączona.

Zrzut ekranu portalu przedstawiający akcję wygaśnięcia pamięci podręcznej.

Modyfikowanie nagłówka żądania

Użyj akcji modyfikowania nagłówka żądania, aby zmodyfikować nagłówki w żądaniu po wysłaniu go do źródła.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • Dołącz: określony nagłówek zostanie dodany do żądania z określoną wartością. Jeśli nagłówek jest już obecny, wartość jest dołączana do istniejącej wartości nagłówka przy użyciu łączenia ciągów. Nie są dodawane ograniczniki. W szablonach usługi ARM użyj elementu headerActionAppend.
  • Zastąp: określony nagłówek zostanie dodany do żądania z określoną wartością. Jeśli nagłówek jest już obecny, określona wartość zastępuje istniejącą wartość. W szablonach usługi ARM użyj elementu headerActionOverwrite.
  • Usuń: jeśli nagłówek określony w regule jest obecny, nagłówek zostanie usunięty z żądania. W szablonach usługi ARM użyj elementu headerActionDelete.
Nazwa nagłówka Nazwa nagłówka do zmodyfikowania.
Wartość nagłówka Wartość do dołączania lub zastępowania.

Przykład

W tym przykładzie dołączamy wartość AdditionalValue do nagłówka MyRequestHeader żądania. Jeśli źródło ustawi nagłówek odpowiedzi na wartość ValueSetByClient, po zastosowaniu tej akcji nagłówek żądania będzie miał wartość ValueSetByClientAdditionalValue.

Zrzut ekranu portalu przedstawiający akcję modyfikowania nagłówka żądania.

Modyfikowanie nagłówka odpowiedzi

Użyj akcji modyfikowania nagłówka odpowiedzi, aby zmodyfikować nagłówki, które znajdują się w odpowiedziach przed ich zwróceniem do klientów.

Właściwości

Właściwości Obsługiwane wartości
Operator
  • Dołącz: określony nagłówek jest dodawany do odpowiedzi z określoną wartością. Jeśli nagłówek jest już obecny, wartość jest dołączana do istniejącej wartości nagłówka przy użyciu łączenia ciągów. Nie są dodawane ograniczniki. W szablonach usługi ARM użyj elementu headerActionAppend.
  • Zastąp: określony nagłówek jest dodawany do odpowiedzi z określoną wartością. Jeśli nagłówek jest już obecny, określona wartość zastępuje istniejącą wartość. W szablonach usługi ARM użyj elementu headerActionOverwrite.
  • Usuń: jeśli nagłówek określony w regule jest obecny, nagłówek zostanie usunięty z odpowiedzi. W szablonach usługi ARM użyj elementu headerActionDelete.
Nazwa nagłówka Nazwa nagłówka do zmodyfikowania.
Wartość nagłówka Wartość do dołączania lub zastępowania.

Przykład

W tym przykładzie usuniemy nagłówek o nazwie X-Powered-By z odpowiedzi, zanim zostaną zwrócone do klienta.

Zrzut ekranu portalu przedstawiający akcję modyfikowania nagłówka odpowiedzi.

Przekierowywanie adresów URL

Użyj akcji przekierowania adresu URL, aby przekierować klientów do nowego adresu URL. Klienci są wysyłani odpowiedzi przekierowania z usługi Front Door.

Właściwości

Właściwości Obsługiwane wartości
Typ przekierowania Typ odpowiedzi, który ma wrócić do osoby żądającej.
  • W witrynie Azure Portal: znaleziono (302), przeniesiono (301), przekierowanie tymczasowe (307), trwałe przekierowanie (308).
  • W szablonach usługi ARM: Found, Moved, TemporaryRedirectPermanentRedirect
Protokół przekierowania
  • W witrynie Azure Portal: Match Request, , HTTPHTTPS
  • W szablonach usługi ARM: MatchRequest, HttpHttps
Host docelowy Nazwa hosta, do którego ma zostać przekierowane żądanie. Pozostaw wartość pustą, aby zachować hosta przychodzącego.
Ścieżka docelowa Ścieżka do użycia w przekierowaniu. Uwzględnij wiodący element /. Pozostaw wartość pustą, aby zachować ścieżkę przychodzącą.
Ciąg zapytania Ciąg zapytania używany w przekierowaniu. Nie uwzględniaj wiodącego ?ciągu . Pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania.
Fragment docelowy Fragment do użycia w przekierowaniu. Pozostaw wartość pustą, aby zachować fragment przychodzący.

Przykład

W tym przykładzie przekierowujemy żądanie do https://contoso.com/exampleredirection?clientIp={client_ip}elementu , zachowując fragment. Używane jest tymczasowe przekierowanie HTTP (307). Adres IP klienta jest używany zamiast tokenu {client_ip} w adresie URL przy użyciu zmiennej client_ipserwera.

Zrzut ekranu portalu przedstawiający akcję przekierowania adresu URL.

Regenerowanie adresów URL

Użyj akcji ponownego zapisywania adresu URL, aby przepisać ścieżkę żądania, które jest kierowane do źródła.

Właściwości

Właściwości Obsługiwane wartości
Wzorzec źródła Zdefiniuj wzorzec źródłowy w ścieżce adresu URL, aby zastąpić. Obecnie wzorzec źródłowy używa dopasowania opartego na prefiksach. Aby dopasować wszystkie ścieżki adresu URL, użyj ukośnika () jako/ wartości wzorca źródłowego.
Element docelowy Zdefiniuj ścieżkę docelową do użycia w ponownym zapisie. Ścieżka docelowa zastępuje wzorzec źródłowy.
Zachowaj niezgodną ścieżkę Jeśli ustawiono wartość Tak, pozostała ścieżka po dołączeniu wzorca źródłowego do nowej ścieżki docelowej.

Przykład

W tym przykładzie ponownie zapisujemy wszystkie żądania do ścieżki /redirectioni nie zachowujemy pozostałej części ścieżki.

Zrzut ekranu portalu przedstawiający akcję ponownego zapisywania adresu URL.

Ważne

Usługa Azure Front Door (klasyczna) zostanie wycofana 31 marca 2027 r. Aby uniknąć zakłóceń w działaniu usługi, należy przeprowadzić migrację profilów usługi Azure Front Door (wersja klasyczna) do warstwy Azure Front Door Standard lub Premium do marca 2027 r. Aby uzyskać więcej informacji, zobacz Wycofywanie usługi Azure Front Door (wersja klasyczna).

W usłudze Azure Front Door (wersja klasyczna) aparat reguł może składać się z maksymalnie 25 reguł zawierających zgodne warunki i skojarzone akcje. Ten artykuł zawiera szczegółowy opis każdej akcji, którą można zdefiniować w regule.

Akcja definiuje zachowanie, które jest stosowane do typu żądania zgodnego z warunkiem lub zestawem warunków dopasowania. W konfiguracji aparatu reguł reguł reguł może mieć maksymalnie 10 pasujących warunków i 5 akcji. W jednej regule można mieć tylko jedną akcję Przesłoń konfigurację routingu .

Poniższe akcje są dostępne do użycia w konfiguracji aparatu reguł.

Modyfikowanie nagłówka żądania

Użyj tych akcji, aby zmodyfikować nagłówki, które znajdują się w żądaniach wysyłanych do zaplecza.

Pola wymagane

Akcja Nazwa nagłówka HTTP Wartość
Dołączanie Po wybraniu tej opcji i dopasowaniu reguły nagłówek określony w nazwie nagłówka zostanie dodany do żądania z określoną wartością. Jeśli nagłówek jest już obecny, wartość jest dołączana do istniejącej wartości. String
Zastąp Po wybraniu tej opcji i dopasowaniu reguły nagłówek określony w nazwie nagłówka zostanie dodany do żądania z określoną wartością. Jeśli nagłówek jest już obecny, określona wartość zastępuje istniejącą wartość. String
Delete Gdy ta opcja zostanie wybrana z pasującymi regułami i nagłówek określony w regule jest obecny, nagłówek zostanie usunięty z żądania. String

Modyfikowanie nagłówka odpowiedzi

Użyj tych akcji, aby zmodyfikować nagłówki, które znajdują się w odpowiedziach zwróconych do klientów.

Pola wymagane

Akcja Nazwa nagłówka HTTP Wartość
Dołączanie Po wybraniu tej opcji i dopasowaniu reguły nagłówek określony w nazwie nagłówka zostanie dodany do odpowiedzi przy użyciu określonej wartości. Jeśli nagłówek jest już obecny, wartość jest dołączana do istniejącej wartości. String
Zastąp Po wybraniu tej opcji i dopasowaniu reguły nagłówek określony w nazwie nagłówka jest dodawany do odpowiedzi przy użyciu określonej wartości. Jeśli nagłówek jest już obecny, wartość zastępuje istniejącą wartość. String
Delete Gdy ta opcja zostanie wybrana z regułami dopasowania i nagłówek określony w regule jest obecny, nagłówek zostanie usunięty z odpowiedzi. String

Przesłonięcia konfiguracji trasy

Typ trasy: przekierowanie

Użyj tych akcji, aby przekierować klientów do nowego adresu URL.

Pola wymagane

Pole opis
Typ przekierowania Przekierowanie to sposób wysyłania użytkowników/klientów z jednego adresu URL do innego. Typ przekierowania ustawia kod stanu używany przez klientów, aby zrozumieć przeznaczenie przekierowania.

Możesz wybrać następujące kody stanu przekierowania: Znaleziono (302), Przeniesiono (301), Przekierowanie tymczasowe (307) i Przekierowanie trwałe (308).
Protokół przekierowania Zachowaj protokół zgodnie z żądaniem przychodzącym lub zdefiniuj nowy protokół dla przekierowania. Na przykład wybierz pozycję "HTTPS" dla przekierowania HTTP do HTTPS.
Host docelowy Ustaw tę wartość, aby zmienić nazwę hosta w adresie URL przekierowania lub zachować nazwę hosta z żądania przychodzącego.
Ścieżka docelowa Zachowaj ścieżkę zgodnie z żądaniem przychodzącym lub zaktualizuj ścieżkę w adresie URL przekierowania.
Ciąg zapytania Ustaw tę wartość, aby zastąpić dowolny istniejący ciąg zapytania z adresu URL żądania przychodzącego lub zachować oryginalny zestaw ciągów zapytania.
Fragment docelowy Fragment docelowy to część adresu URL po '#', zwykle używana przez przeglądarki do lądowania w określonej sekcji na stronie. Ustaw tę wartość, aby dodać fragment do adresu URL przekierowania.

Typ trasy: Prześlij dalej

Użyj tych akcji, aby przekazać klientom dalej do nowego adresu URL. Te akcje zawierają również akcje podrzędne dla ponownego zapisywania adresów URL i buforowania.

Pole opis
Pula zaplecza Wybierz pulę zaplecza, aby zastąpić i obsłużyć żądania. Wszystkie wstępnie skonfigurowane pule zaplecza znajdują się obecnie w profilu usługi Front Door.
Protokół przesyłania dalej Protokół używany do przekazywania żądania do zaplecza lub dopasuj protokół z przychodzącego żądania.
Regenerowanie adresów URL Ścieżka do użycia podczas konstruowania żądania ponownego zapisywania adresu URL w celu przekazania do zaplecza.
Buforowanie Włącz buforowanie dla tej reguły routingu. Po włączeniu usługa Azure Front Door buforuje zawartość statyczną.

Regenerowanie adresów URL

Użyj tego ustawienia, aby skonfigurować opcjonalną niestandardową ścieżkę przekazywania do użycia podczas konstruowania żądania do przekazywania dalej do zaplecza.

Pole opis
Niestandardowa ścieżka przesyłania dalej Zdefiniuj ścieżkę, do której żądania są przekazywane.

Buforowanie

Użyj tych ustawień, aby kontrolować sposób buforowania plików dla żądań zawierających ciągi zapytania. Czy buforować zawartość na podstawie wszystkich parametrów, czy na wybranych parametrach. Możesz użyć tych ustawień, aby zastąpić wartość czasu wygaśnięcia (TTL), aby kontrolować, jak długo zawartość pozostanie w pamięci podręcznej. Aby wymusić buforowanie jako akcję, ustaw pole buforowania na wartość "Włączone". Wymusisz buforowanie, pojawią się następujące opcje:

Zachowanie pamięci podręcznej opis
Ignoruj ciąg zapytania Gdy zasób jest buforowany, wszystkie żądania, które następują, ignorują ciągi zapytania do momentu wygaśnięcia buforowanego zasobu.
Używanie ciągu zapytania Każde żądanie z unikatowym adresem URL, w tym ciągiem zapytania, jest traktowane jako unikatowy zasób z własną pamięcią podręczną.
Ignoruj określone ciągi zapytania Ciągi zapytania adresu URL żądania wymienione w ustawieniu "Parametry zapytania" są ignorowane na potrzeby buforowania.
Uwzględnij określone ciągi zapytania Ciągi zapytania żądania adresu URL wymienione w ustawieniu "Parametry zapytania" są używane do buforowania.
Inne pola opis
Kompresja dynamiczna Usługa Front Door może dynamicznie kompresować zawartość na krawędzi, co powoduje mniejszą i szybszą odpowiedź.
Parametry zapytań Rozdzielona przecinkami lista dozwolonych lub niedozwolonych parametrów do użycia jako podstawa buforowania.
Użyj domyślnego czasu trwania pamięci podręcznej Ustaw opcję używania domyślnego czasu trwania buforowania usługi Azure Front Door lub zdefiniuj czas trwania buforowania, który ignoruje dyrektywę odpowiedzi źródła.

Następne kroki

  • Dowiedz się, jak skonfigurować pierwszy zestaw reguł.
  • Dowiedz się więcej o warunkach dopasowania zestawu reguł.
  • Dowiedz się więcej o zestawach reguł usługi Azure Front Door.