Kural kümesi eylemleri
Azure Front Door kural kümesi , eşleştirme koşulları ve eylemlerinin birleşimiyle kurallardan oluşur. Bu makalede, bir kural kümesinde kullanabileceğiniz eylemlerin ayrıntılı bir açıklaması sağlanır. Eylem, eşleşen koşulların tanımladığı bir istek türüne uygulanan davranışı tanımlar. Bir kural kümesinde, bir kuralın en fazla beş eylemi olabilir. Front Door, bir kural kümesi eyleminde sunucu değişkenini de destekler.
Aşağıdaki eylemler bir kural kümesinde kullanılabilir:
Yol yapılandırması geçersiz kılma
Rota yapılandırması geçersiz kılma eylemi, isteğin kaynak grubunu veya önbelleğe alma yapılandırmasını geçersiz kılmak için kullanılır. Rotada belirtilen kaynak grubu yapılandırmalarını geçersiz kılmayı veya kabul etmeyi seçebilirsiniz. Ancak, yol yapılandırmasını geçersiz kıldığınızda önbelleğe almayı yapılandırmanız gerekir. Aksi takdirde, istek için önbelleğe alma devre dışı bırakılır.
Ayrıca, dosyaların belirli istekler için önbelleğe alınma şeklini geçersiz kılabilirsiniz, örneğin:
- Kaynak tarafından belirtilen önbelleğe alma davranışını geçersiz kılın.
- İsteğin önbellek anahtarını oluşturmak için sorgu dizesi parametrelerinin nasıl kullanıldığı.
- İçeriğin önbellekte ne kadar süre kaldığını denetlemek için yaşam süresi (TTL) değeri.
Özellikler
Özellik | Desteklenen değerler |
---|---|
Kaynak grubunu geçersiz kıl |
|
Önbelleğe Alma |
|
Kaynağı geçersiz kıl grubu Evet olarak ayarlandığında, aşağıdaki özellikleri ayarlayın:
Özellik | Desteklenen değerler |
---|---|
Kaynak grubu | İsteğin yönlendirilmesi gereken kaynak grubu. Bu ayar, Front Door uç noktası yolunda belirtilen yapılandırmayı geçersiz kılar. |
İletme protokolü | Front Door'un isteği çıkış noktasıyla iletirken kullanması için protokol. Desteklenen değerler yalnızca HTTP, yalnızca HTTPS, Gelen isteği eşleştir'dir. Bu ayar, Front Door uç noktası yolunda belirtilen yapılandırmayı geçersiz kılar. |
Önbelleğe Alma Etkin olarak ayarlandığında aşağıdaki özellikleri ayarlayın:
Özellik | Desteklenen değerler |
---|---|
Sorgu dizesini önbelleğe alma davranışı |
|
Sorgu parametreleri | Sorgu dizesi parametre adlarının virgülle ayrılmış listesi. Bu özellik yalnızca Sorgu dizesi önbelleğe alma davranışı Belirtilen Sorgu Dizelerini Yoksay veya Belirtilen Sorgu Dizelerini Ekle olarak ayarlandığında ayarlanır. |
Sıkıştırma |
|
Önbellek davranışı |
|
Önbellek süresi | Önbellek davranışı veya Override if origin missing olarak ayarlandığındaOverride always , bu alanların kullanılacak önbellek süresini belirtmesi gerekir. Maksimum süre 366 gündür. Bu özellik yalnızca Önbellek davranışı Her zaman geçersiz kıl veya kaynak eksikse Geçersiz Kıl olarak ayarlandığında ayarlanır.
|
Örnekler
Bu örnekte, Front Door uç noktası yolundaki yapılandırmadan bağımsız olarak, eşleşen tüm istekleri adlı MyOriginGroup
bir kaynak grubuna yönlendiririz.
Bu örnekte, önbellek anahtarını adlı customerId
bir sorgu dizesi parametresi içerecek şekilde ayarlayacağız. Sıkıştırma etkinleştirilir ve kaynağın önbelleğe alma ilkeleri kabul edilir.
Bu örnekte, önbellek süresi belirtmeyen eşleşen istekler için önbellek süre sonunu 6 saat olarak geçersiz kılacağız. Front Door, önbellek anahtarını belirlediğinde sorgu dizesini yoksayar ve sıkıştırma etkinleştirilir.
İstek üst bilgisini değiştirme
İsteğin kaynağınıza gönderildiğinde istekteki üst bilgileri değiştirmek için istek üst bilgisini değiştir eylemini kullanın.
Özellikler
Özellik | Desteklenen değerler |
---|---|
Operatör |
|
Üst bilgi adı | Değiştireceğiniz üst bilginin adı. |
Üst bilgi değeri | Eklenecek veya üzerine yazacak değer. |
Örnek
Bu örnekte, değeri AdditionalValue
istek üst bilgisine MyRequestHeader
ekleyeceğiz. Kaynak, yanıt üst bilgisini değerine ValueSetByClient
ayarlarsa, bu eylem uygulandıktan sonra istek üst bilgisinin ValueSetByClientAdditionalValue
değeri olur.
Not
Bazı Azure Front Door ayrılmış üst bilgileri, istek üst bilgilerini ve yanıt üst bilgilerini değiştirme eylemleri de dahil olmak üzere kural altyapısı eylemleri kullanılarak değiştirilemez. Ve ön ekli x-ec
x-fd
üst bilgilerle birlikte aşağıdaki ayrılmış üst bilgiler listesi değiştirilemez.
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
Yanıt üst bilgisini değiştirme
Yanıtlarda bulunan üst bilgileri istemcilerinize döndürülmeden önce değiştirmek için yanıt üst bilgisini değiştir eylemini kullanın.
Özellikler
Özellik | Desteklenen değerler |
---|---|
Operatör |
|
Üst bilgi adı | Değiştireceğiniz üst bilginin adı. |
Üst bilgi değeri | Eklenecek veya üzerine yazacak değer. |
Örnek
Bu örnekte, istemciye döndürülmeden önce yanıtlardan adla X-Powered-By
üst bilgiyi sileriz.
Not
Bazı Azure Front Door ayrılmış üst bilgileri, istek üst bilgilerini ve yanıt üst bilgilerini değiştirme eylemleri de dahil olmak üzere kural altyapısı eylemleri kullanılarak değiştirilemez. Ve ön ekli x-ec
x-fd
üst bilgilerle birlikte aşağıdaki ayrılmış üst bilgiler listesi değiştirilemez.
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
URL yeniden yönlendirme
İstemcileri yeni bir URL'ye yeniden yönlendirmek için URL yeniden yönlendirme eylemini kullanın. İstemcilere Front Door'dan bir yeniden yönlendirme yanıtı gönderilir. Azure Front Door, sunucu değişkeniyle {url_path:seg#}
URL yolunun dinamik olarak yakalanmasını destekler ve VEYA ile {url_path.tolower}
{url_path.toupper}
URL yolunu küçük veya büyük harfe dönüştürür. Daha fazla bilgi için bkz . Sunucu değişkenleri.
Özellikler
Özellik | Desteklenen değerler |
---|---|
Yeniden yönlendirme türü | İstek sahibine döndürülecek yanıt türü.
|
Yeniden yönlendirme protokolü |
|
Hedef konak | İsteğin yeniden yönlendirilmesini istediğiniz ana bilgisayar adı. Gelen konağı korumak için boş bırakın. |
Hedef yol | Yeniden yönlendirmede kullanılacak yol. Baştaki / öğesini ekleyin. Gelen yolu korumak için boş bırakın. |
Sorgu dizesi | Yeniden yönlendirmede kullanılan sorgu dizesi. Baştaki ? öğesini eklemeyin. Gelen sorgu dizesini korumak için boş bırakın. |
Hedef parça | Yeniden yönlendirmede kullanılacak parça. Gelen parçayı korumak için boş bırakın. |
Örnek
Bu örnekte, parça korunarak isteği öğesine https://contoso.com/exampleredirection?clientIp={client_ip}
yönlendireceğiz. HTTP Geçici Yeniden Yönlendirme (307) kullanılır. İstemcinin IP adresi, sunucu değişkeni kullanılarak client_ip
URL içindeki belirtecin yerine {client_ip}
kullanılır.
URL yeniden yazma
Kaynağınıza yönlendiren bir isteğin yolunu yeniden yazmak için URL yeniden yazma eylemini kullanın. Azure Front Door, sunucu değişkeniyle {url_path:seg#}
URL yolunun dinamik olarak yakalanmasını destekler ve VEYA ile {url_path.tolower}
{url_path.toupper}
URL yolunu küçük veya büyük harfe dönüştürür. Daha fazla bilgi için bkz . Sunucu değişkenleri.
Özellikler
Özellik | Desteklenen değerler |
---|---|
Kaynak deseni | Değiştirecek URL yolunda kaynak deseni tanımlayın. Şu anda kaynak deseni ön ek tabanlı bir eşleşme kullanmaktadır. Tüm URL yollarını eşleştirmek için kaynak desen değeri olarak eğik çizgi (/ ) kullanın. |
Hedef | Yeniden yazmada kullanılacak hedef yolu tanımlayın. Hedef yol, kaynak desenin üzerine yazar. |
Eşleşmeyen yolu koru | Evet olarak ayarlanırsa, kaynak desenden sonraki kalan yol yeni hedef yola eklenir. |
Örnek
Bu örnekte, yoluna yönelik tüm istekleri yeniden yazacağız ve yolun /redirection
geri kalanını korumayacağız.
Önemli
Azure Front Door (klasik) 31 Mart 2027'de kullanımdan kaldırılacaktır. Hizmet kesintisini önlemek için Azure Front Door (klasik) profillerinizi Mart 2027'ye kadar Azure Front Door Standard veya Premium katmanına geçirmeniz önemlidir. Daha fazla bilgi için bkz . Azure Front Door (klasik) kullanımdan kaldırma.
Azure Front Door'da (klasik) Kurallar altyapısı , eşleşen koşulları ve ilişkili eylemleri içeren en fazla 25 kuraldan oluşabilir. Bu makalede, bir kuralda tanımlayabileceğiniz her eylemin ayrıntılı bir açıklaması sağlanır.
Eylem, koşul veya eşleşme koşulları kümesiyle eşleşen istek türüne uygulanan davranışı tanımlar. Kural altyapısı yapılandırmasında, bir kuralın en fazla 10 eşleşen koşulu ve 5 eylemi olabilir. Tek bir kuralda yalnızca bir Yönlendirme Yapılandırmasını Geçersiz Kıl eyleminiz olabilir.
Kurallar altyapısı yapılandırmasında aşağıdaki eylemler kullanılabilir.
İstek üst bilgisini değiştirme
Arka ucunuza gönderilen isteklerde bulunan üst bilgileri değiştirmek için bu eylemleri kullanın.
Gerekli alanlar
Eylem | HTTP üst bilgi adı | Değer |
---|---|---|
Arkasına Ekle | Bu seçenek belirlendiğinde ve kural eşleştiğinde, Üst bilgi adı'nda belirtilen üst bilgi belirtilen değerle isteğe eklenir. Üst bilgi zaten varsa, değer var olan değere eklenir. | String |
Üzerine yaz | Bu seçenek belirlendiğinde ve kural eşleştiğinde, Üst bilgi adı'nda belirtilen üst bilgi belirtilen değerle isteğe eklenir. Üst bilgi zaten varsa, belirtilen değer var olan değerin üzerine yazar. | String |
Sil | Bu seçenek eşleşen kurallarla seçildiğinde ve kuralda belirtilen üst bilgi mevcut olduğunda, üst bilgi istekten silinir. | String |
Yanıt üst bilgisini değiştirme
İstemcilerinize döndürülen yanıtlarda bulunan üst bilgileri değiştirmek için bu eylemleri kullanın.
Gerekli alanlar
Eylem | HTTP Üst Bilgi adı | Değer |
---|---|---|
Arkasına Ekle | Bu seçenek belirlendiğinde ve kural eşleştiğinde, Üst bilgi adı'nda belirtilen üst bilgi belirtilen Değer kullanılarak yanıta eklenir. Üst bilgi zaten varsa, var olan değere Değer eklenir. | String |
Üzerine yaz | Bu seçenek belirlendiğinde ve kural eşleştiğinde , Üst bilgi adında belirtilen üst bilgi belirtilen Değer kullanılarak yanıta eklenir. Üst bilgi zaten varsa, Değer varolan değerin üzerine yazar. | String |
Sil | Bu seçenek eşleşen kurallarla belirlendiğinde ve kuralda belirtilen üst bilgi mevcut olduğunda, üst bilgi yanıttan silinir. | String |
Yol yapılandırması geçersiz kılmaları
Yol Türü: Yeniden Yönlendirme
İstemcileri yeni bir URL'ye yeniden yönlendirmek için bu eylemleri kullanın.
Gerekli alanlar
Alan | Açıklama |
---|---|
Yeniden yönlendirme türü | Yeniden yönlendirme, kullanıcıları/istemcileri bir URL'den diğerine göndermenin bir yoludur. Yeniden yönlendirme türü, yeniden yönlendirmenin amacını anlamak için istemciler tarafından kullanılan durum kodunu ayarlar. Şu yeniden yönlendirme durum kodlarını seçebilirsiniz: Bulundu (302), Taşındı (301), Geçici yeniden yönlendirme (307) ve Kalıcı yeniden yönlendirme (308). |
Yeniden yönlendirme protokolü | Gelen istekte olduğu gibi protokolü koruyun veya yeniden yönlendirme için yeni bir protokol tanımlayın. Örneğin, HTTP'den HTTPS'ye yeniden yönlendirme için 'HTTPS' öğesini seçin. |
Hedef konak | Yeniden yönlendirme url'sindeki ana bilgisayar adını değiştirmek veya gelen istekteki ana bilgisayar adını başka bir şekilde korumak için bu değeri ayarlayın. |
Hedef yol | Gelen istekte olduğu gibi yolu koruyun veya yeniden yönlendirmenin URL'sindeki yolu güncelleştirin. |
Sorgu dizesi | Bu değeri, gelen istek URL'sindeki mevcut sorgu dizelerini değiştirmek veya özgün sorgu dizeleri kümesini korumak için ayarlayın. |
Hedef parça | Hedef parça, URL'nin '#' sonrasındaki bölümüdür ve normalde tarayıcılar tarafından sayfadaki belirli bir bölüme inmek için kullanılır. Yeniden yönlendirme URL'sine bir parça eklemek için bu değeri ayarlayın. |
Yol Türü: İletme
İstemcileri yeni bir URL'ye iletmek için bu eylemleri kullanın. Bu eylemler, URL yeniden yazma ve önbelleğe alma için alt eylemler de içerir.
Alan | Açıklama |
---|---|
Arka uç havuzu | İstekleri geçersiz kılmak ve sunmak için arka uç havuzunu seçin, önceden yapılandırılmış tüm arka uç havuzlarınızı şu anda Front Door profilinizde görürsünüz. |
İletme protokolü | İsteği arka uçtan iletmek veya gelen istekten gelen protokolle eşleştirmek için kullanılacak protokol. |
URL yeniden yazma | URL yeniden yazma isteğini oluştururken arka uçtan iletilmesi için kullanılacak yol. |
Önbelleğe Alma | Bu yönlendirme kuralı için önbelleğe almayı etkinleştirin. Azure Front Door etkinleştirildiğinde statik içeriğinizi önbelleğe alır. |
URL yeniden yazma
Arka uçtan iletmek üzere istek oluştururken kullanılacak isteğe bağlı bir Özel İletme Yolu yapılandırmak için bu ayarı kullanın.
Alan | Açıklama |
---|---|
Özel iletme yolu | İsteklerin iletildiği bir yol tanımlayın. |
Önbelleğe Alma
Sorgu dizeleri içeren istekler için dosyaların nasıl önbelleğe alındığını denetlemek için bu ayarları kullanın. İçeriğinizin tüm parametrelere göre mi yoksa seçili parametrelere göre mi önbelleğe alınıp alınmayacağı. İçeriğin önbellekte ne kadar süre kaldığını denetlemek üzere yaşam süresi (TTL) değerinin üzerine yazmak için bu ayarları kullanabilirsiniz. Önbelleğe almayı eylem olarak zorlamak için, önbelleğe alma alanını "Etkin" olarak ayarlayın. Önbelleğe almaya zorladığınızda aşağıdaki seçenekler görüntülenir:
Önbellek davranışı | Açıklama |
---|---|
Sorgu Dizesini Yoksay | Varlık önbelleğe alındıktan sonra, tüm istekler önbelleğe alınan varlığın süresi dolana kadar sorgu dizelerini yoksayar. |
Sorgu Dizesini Kullanma | Sorgu dizesi de dahil olmak üzere benzersiz bir URL'ye sahip her istek, kendi önbelleğine sahip benzersiz bir varlık olarak kabul edilir. |
Belirtilen Sorgu Dizelerini Yoksay | "Sorgu parametreleri" ayarında listelenen istek URL'si sorgu dizeleri önbelleğe alma için yoksayılır. |
Belirtilen Sorgu Dizelerini Ekle | Önbelleğe alma için "Sorgu parametreleri" ayarında listelenen istek URL'si sorgu dizeleri kullanılır. |
Diğer alanlar | Açıklama |
---|---|
Dinamik sıkıştırma | Front Door, kenardaki içeriği dinamik olarak sıkıştırarak daha küçük ve daha hızlı yanıt verebilir. |
Sorgu parametreleri | Önbelleğe alma için temel olarak kullanılacak izin verilen veya izin verilmeyen parametrelerin virgülle ayrılmış listesi. |
Varsayılan önbellek süresini kullan | Azure Front Door varsayılan önbelleğe alma süresini kullanacak şekilde ayarlayın veya kaynak yanıt yönergesini yoksayan bir önbelleğe alma süresi tanımlayın. |
Sonraki adımlar
- İlk Kural kümenizi yapılandırmayı öğrenin.
- Kural kümesi eşleştirme koşulları hakkında daha fazla bilgi edinin.
- Azure Front Door Kural kümeleri hakkında daha fazla bilgi edinin.