Aracılığıyla paylaş


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
  • Evet: İstek için kullanılan kaynak grubunu geçersiz kılın.
  • Hayır: Rotada belirtilen kaynak grubunu kullanın.
Önbelleğe Alma
  • Etkin: İstek için önbelleğe almayı etkinleştirmeye zorlar.
  • Devre dışı: İstek için önbelleğe almayı devre dışı bırakılmaya zorlar.

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 Dizesini Yoksay: Önbellek anahtarı oluşturulduğunda sorgu dizeleri dikkate alınmaz. ARM şablonlarında queryStringCachingBehavior özelliğini olarak IgnoreQueryStringayarlayın.
  • Sorgu dizesini kullan: Her benzersiz URL'nin kendi önbellek anahtarı vardır. ARM şablonlarında öğesini queryStringCachingBehavior UseQueryStringkullanın.
  • Belirtilen sorgu dizesini yoksay: Önbellek anahtarı oluşturulduğunda parametrelerde belirtilen sorgu dizeleri dışlanır. ARM şablonlarında queryStringCachingBehavior özelliğini olarak IgnoreSpecifiedQueryStringsayarlayın.
  • Belirtilen sorgu dizesini ekle: Önbellek anahtarı oluşturulduğunda parametrelerde belirtilen sorgu dizeleri eklenir. ARM şablonlarında queryStringCachingBehavior özelliğini olarak IncludeSpecifiedQueryStringsayarlayın.
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
  • Etkin: Front Door, kenardaki içeriği dinamik olarak sıkıştırarak daha küçük ve daha hızlı yanıt sağlar. Daha fazla bilgi için bkz . Dosya sıkıştırma. ARM şablonlarında isCompressionEnabled özelliğini olarak Enabledayarlayın.
  • Devre dışı. Front Door sıkıştırma gerçekleştirmez. ARM şablonlarında isCompressionEnabled özelliğini olarak Disabledayarlayın.
Önbellek davranışı
  • Onur kaynağı: Front Door her zaman kaynak yanıt üst bilgisi yönergesi kabul eder. Kaynak yönergesi eksikse, Front Door içeriği 1 ila 3 gün arasında herhangi bir yerde önbelleğe alır. ARM şablonlarında cacheBehavior özelliğini olarak HonorOriginayarlayın.
  • Her zaman geçersiz kıl: Kaynağınızdan döndürülen TTL değerinin üzerine eylemde belirtilen değer yazılır. Bu davranış yalnızca yanıt önbelleğe alınıyorsa uygulanır. ARM şablonlarında cacheBehavior özelliğini olarak OverrideAlwaysayarlayın.
  • Kaynak eksikse geçersiz kıl: Kaynağınızdan hiçbir TTL değeri döndürülmezse, kural TTL'yi eylemde belirtilen değere ayarlar. Bu davranış yalnızca yanıt önbelleğe alınıyorsa uygulanır. ARM şablonlarında cacheBehavior özelliğini olarak OverrideIfOriginMissingayarlayın.
Önbellek süresi Önbellek davranışı veya Override if origin missingolarak 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.
  • Azure portalında: Günleri, saatleri, dakikaları ve saniyeleri belirtin.
  • ARM şablonlarında: biçiminde d.hh:mm:sssüreyi belirtmek için kullanıncacheDuration.

Örnekler

Bu örnekte, Front Door uç noktası yolundaki yapılandırmadan bağımsız olarak, eşleşen tüm istekleri adlı MyOriginGroupbir kaynak grubuna yönlendiririz.

Çıkış noktası grubu geçersiz kılma eylemini gösteren portal ekran görüntüsü.

Bu örnekte, önbellek anahtarını adlı customerIdbir sorgu dizesi parametresi içerecek şekilde ayarlayacağız. Sıkıştırma etkinleştirilir ve kaynağın önbelleğe alma ilkeleri kabul edilir.

Önbellek anahtarı sorgu dizesi eylemini gösteren portal ekran görüntüsü.

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.

Önbellek süre sonu eylemini gösteren portal ekran görüntüsü.

İ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
  • Ekleme: Belirtilen üst bilgi, belirtilen değerle isteğe eklenir. Üst bilgi zaten varsa, değer dize birleştirme kullanılarak var olan üst bilgi değerine eklenir. Sınırlayıcı eklenmez. ARM şablonlarında öğesini headerAction Appendkullanın.
  • Üzerine yaz: Belirtilen üst bilgi, belirtilen değerle isteğe eklenir. Üst bilgi zaten varsa, belirtilen değer var olan değerin üzerine yazar. ARM şablonlarında öğesini headerAction Overwritekullanın.
  • Sil: Kuralda belirtilen üst bilgi varsa, üst bilgi istekten silinir. ARM şablonlarında öğesini headerAction Deletekullanın.
Ü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 ValueSetByClientayarlarsa, bu eylem uygulandıktan sonra istek üst bilgisinin ValueSetByClientAdditionalValuedeğeri olur.

İstek üst bilgisini değiştirme eylemini gösteren portal ekran görüntüsü.

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
  • Ekleme: Belirtilen üst bilgi, belirtilen değerle yanıta eklenir. Üst bilgi zaten varsa, değer dize birleştirme kullanılarak var olan üst bilgi değerine eklenir. Sınırlayıcı eklenmez. ARM şablonlarında öğesini headerAction Appendkullanın.
  • Üzerine yaz: Belirtilen üst bilgi, belirtilen değerle yanıta eklenir. Üst bilgi zaten varsa, belirtilen değer var olan değerin üzerine yazar. ARM şablonlarında öğesini headerAction Overwritekullanın.
  • Sil: Kuralda belirtilen üst bilgi varsa, üst bilgi yanıttan silinir. ARM şablonlarında öğesini headerAction Deletekullanın.
Ü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.

Yanıt üst bilgisini değiştirme eylemini gösteren portal ekran görüntüsü.

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ü.
  • Azure portalında: Bulundu (302), Taşındı (301), Geçici Yeniden Yönlendirme (307), Kalıcı Yeniden Yönlendirme (308).
  • ARM şablonlarında: Found, Moved, TemporaryRedirect, PermanentRedirect
Yeniden yönlendirme protokolü
  • Azure portalında: Match Request, HTTP, HTTPS
  • ARM şablonlarında: MatchRequest, Http, Https
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 yönlendirme eylemini gösteren portal ekran görüntüsü.

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 /redirectiongeri kalanını korumayacağız.

URL yeniden yazma eylemini gösteren portal ekran görüntüsü.

Ö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.