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ının geçersiz kılınması

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ın varsayılan ayarları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: İstekte önbelleğe almanın zorunlu olarak etkinleştirilmesini sağlar.
  • Devre dışı: İstek için önbelleğe almayı devre dışı bırakılmaya zorlar.

Kaynak grubunu geçersiz kılEvet 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ç nokta rotasında belirtilen yapılandırmayı geçersiz kılar.
İletme protokolü İsteği varış noktasına iletirken Front Door'un kullanacağı protokol. Desteklenen değerler yalnızca HTTP, yalnızca HTTPS, Gelen isteği eşleştir'dir. Bu ayar, Front Door uç nokta rotasında 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 queryStringCachingBehavior öğesini UseQueryString kullanın.
  • Belirtilen sorgu dizesini yoksay: Parametrelerde belirtilen sorgu dizeleri, önbellek anahtarı üretilirken 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 Ekle veya Belirtilen Sorgu Dizelerini Yoksay 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 işlemi gerçekleştirmez. ARM şablonlarında isCompressionEnabled özelliğini olarak Disabledayarlayın.
Önbellek davranışı
  • Kaynak önceliği: Front Door her zaman kaynak yanıt üst bilgisi yönergesine öncelik verir. 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 alwaysolarak ayarlandığındaOverride if origin missing, 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, süreyi cacheDuration kullanarak d.hh:mm:ss biçiminde belirtin.

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

Kaynak 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. Başlık zaten varsa, değer mevcut başlık değerine dize ekleme kullanılarak eklenir. Sınırlayıcı eklenmez. ARM şablonlarında headerAction öğesini Append kullanın.
  • Üzerine yaz: Belirtilen üst bilgi, belirtilen değerle isteğe eklenir. Üst bilgi zaten varsa, belirtilen değer var olan değerin yerine yazar. ARM şablonlarında headerAction öğesini Overwrite kullanın.
  • Sil: Kuralda belirtilen üst bilgi varsa, üst bilgi istekten silinir. ARM şablonlarında headerAction öğesini Delete kullanın.
Başlık adı Değiştireceğiniz başlığın adı.
Header değeri Eklenecek veya üstüne yazılacak değer.

Örnek

Bu örnekte, AdditionalValue değerini MyRequestHeader istek üst bilgisine ekliyoruz. 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

Azure Front Door’un bazı ayrılmış üst bilgileri, kurallar altyapısı eylemleriyle, istek ve yanıt üst bilgilerini değiştirme eylemleri de dahil olmak üzere, değiştirilemez. Aşağıdaki ayrılmış üst bilgiler listesi ve x-ec ve x-fd ile ön ekli herhangi bir üst bilgi 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. Başlık zaten varsa, değer mevcut başlık değerine dize ekleme kullanılarak eklenir. Sınırlayıcı eklenmez. ARM şablonlarında headerAction öğesini Append kullanın.
  • Üzerine Yazma: Belirtilen üst bilgi, belirtilen değerle cevaba eklenir. Üst bilgi zaten varsa, belirtilen değer var olan değerin yerine yazar. ARM şablonlarında headerAction öğesini Overwrite kullanın.
  • Sil: Kuralda belirtilen üst bilgi varsa, üst bilgi yanıttan silinir. ARM şablonlarında headerAction öğesini Delete kullanın.
Başlık adı Değiştireceğiniz başlığın adı.
Header değeri Eklenecek veya üstüne yazılacak değer.

Örnek

Bu örnekte, istemciye döndürülmeden önce yanıtlardan adı X-Powered-By olan üst bilgiyi sileriz.

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

Not

Azure Front Door’un bazı ayrılmış üst bilgileri, kurallar altyapısı eylemleriyle, istek ve yanıt üst bilgilerini değiştirme eylemleri de dahil olmak üzere, değiştirilemez. Aşağıdaki ayrılmış üst bilgiler listesi ve x-ec ve x-fd ile ön ekli herhangi bir üst bilgi 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 yakalamasını destekler ve URL yolunu {url_path.tolower} veya {url_path.toupper} ile küçük harfe 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ü İstekte bulunana 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 sunucu İ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 alanı 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çayı koruyarak isteği https://contoso.com/exampleredirection?clientIp={client_ip} öğesine yönlendiriyoruz. HTTP Geçici Yeniden Yönlendirme (307) kullanılır. İstemcinin IP adresi, URL içindeki belirtecin yerine {client_ip}client_ip kullanılarak konur.

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

URL yeniden yazma

Kaynağınıza yönlendirilmekte olan 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 yakalamasını destekler ve URL yolunu {url_path.tolower} veya {url_path.toupper} ile küçük harfe 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 URL yolunda değiştirilecek kaynak desenini tanımlayın. Şu anda kaynak deseni ön ek tabanlı bir eşleme kullanmaktadır. Tüm URL yollarını eşleştirmek için kaynak desen değeri olarak eğik çizgi (/) kullanın. Kaynak desen için yalnızca yol yapılandırmasında eşleşmesi gereken desenlerin ardından gelen yolun dikkate alındığını unutmayın. Daha fazla bilgi için bkz . kaynak deseni.
Hedef Yeniden yazmada kullanılacak hedef yolu tanımlayın. Hedef yol, kaynak desenin üzerine yazar.
Eşleşmeyen yolu sakla 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 emekliliğe ayrılıyor. Hizmet kullanımdan kaldırıldığı için artık profil oluşturmayı, yeni etki alanlarının sisteme alınmasını veya yönetilen sertifikaları desteklemiyor. Hizmet kesintisini önlemek için Azure Front Door Standard veya Premium'a taşının. 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
Ekle Bu seçenek belirlendiğinde ve kural eşleştiğinde, Header name'de belirtilen üst bilgi, belirtilen değerle isteğe eklenir. Başlık zaten varsa, değer mevcut değere eklenir. Dize
Üzerine yaz Bu seçenek belirlendiğinde ve kural eşleştiğinde, Üst bilgi adı kısmında belirtilen üst bilgi, belirtilen değerle isteğe eklenir. Üst bilgi zaten varsa, belirtilen değer var olan değerin yerine yazar. Dize
Sil Bu seçenek eşleşen kurallarla seçildiğinde ve kuralda belirtilen üst bilgi mevcut olduğunda, üst bilgi istekten silinir. Dize

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 Başlık Adı Değer
Ekle Bu seçenek belirlendiğinde ve kural eşleştiğinde, Başlık adında belirtilen başlık, belirtilen Değer kullanılarak yanıta eklenir. Üst bilgi zaten varsa, mevcut değere Değer eklenir. Dize
Ü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. Dize
Sil Bu seçenek eşleşen kurallarla belirlendiğinde ve kuralda belirtilen üst bilgi mevcut olduğunda, üst bilgi yanıttan silinir. Dize

Rota yapılandırması geçersiz kılma ayarları

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 sunucu 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ü: Yönlendirme

İ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 uca iletmek üzere istek oluştururken kullanılacak isteğe bağlı Özel İletme Yolu'nu 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 Yoksaymak 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 sorgu dizelerine sahip istek URL'leri önbellekleme 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, uç noktadaki 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.