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ł |
|
Buforowanie |
|
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. |
Gdy buforowanie jest ustawione na Włączone, ustaw następujące właściwości:
Właściwości | Obsługiwane wartości |
---|---|
Buforowanie łańcuchów zapytań |
|
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 |
|
Zachowanie pamięci podręcznej |
|
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. 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.
|
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.
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.
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.
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 |
|
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
.
Uwaga
Niektórych nagłówków zarezerwowanych usługi Azure Front Door nie można modyfikować przy użyciu akcji aparatu reguł, w tym akcji modyfikowania nagłówków żądań i nagłówków odpowiedzi. Nie można modyfikować poniższej listy nagłówków zarezerwowanych wraz z prefiksami x-ec
i x-fd
.
Accept-Ranges
Host
Connection
Content-Length
Transfer-Encoding
TE
Last-Modified
Keep-Alive
Expect
Upgrade
If-Modified-Since
If-Unmodified-Since
If-None-Match
If-Match
Range
If-Range
X-Ms-Via
X-Ms-Force-Refresh
X-MSEdge-Ref
Warning
Forwarded
Via
X-Forwarded-For
X-Forwarded-Proto
X-Forwarded-Host
X-Azure-RequestChain
X-Azure-FDID
X-Azure-RequestChainv2
X-Azure-Ref
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 |
|
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.
Uwaga
Niektórych nagłówków zarezerwowanych usługi Azure Front Door nie można modyfikować przy użyciu akcji aparatu reguł, w tym akcji modyfikowania nagłówków żądań i nagłówków odpowiedzi. Nie można modyfikować poniższej listy nagłówków zarezerwowanych wraz z prefiksami x-ec
i x-fd
.
Accept-Ranges
Host
Connection
Content-Length
Transfer-Encoding
TE
Last-Modified
Keep-Alive
Expect
Upgrade
If-Modified-Since
If-Unmodified-Since
If-None-Match
If-Match
Range
If-Range
X-Ms-Via
X-Ms-Force-Refresh
X-MSEdge-Ref
Warning
Forwarded
Via
X-Forwarded-For
X-Forwarded-Proto
X-Forwarded-Host
X-Azure-RequestChain
X-Azure-FDID
X-Azure-RequestChainv2
X-Azure-Ref
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. Usługa Azure Front Door obsługuje dynamiczne przechwytywanie ścieżki adresu URL ze zmienną {url_path:seg#}
serwera i konwertuje ścieżkę adresu URL na małe litery lub wielkie litery za pomocą {url_path.tolower}
polecenia lub {url_path.toupper}
. Aby uzyskać więcej informacji, zobacz Zmienne serwera.
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.
|
Protokół przekierowania |
|
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_ip
serwera.
Regenerowanie adresów URL
Użyj akcji ponownego zapisywania adresu URL, aby przepisać ścieżkę żądania, które jest kierowane do źródła. Usługa Azure Front Door obsługuje dynamiczne przechwytywanie ścieżki adresu URL ze zmienną {url_path:seg#}
serwera i konwertuje ścieżkę adresu URL na małe litery lub wielkie litery za pomocą {url_path.tolower}
polecenia lub {url_path.toupper}
. Aby uzyskać więcej informacji, zobacz Zmienne serwera.
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 /redirection
i nie zachowujemy pozostałej części ścieżki.
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. |