Azure Front Door/Premium (Önizleme) Kural Kümesi eylemlerini ayarlama

Not

Bu belge Standart/Premium Azure Front Door (Önizleme) için hazırlanmıştır. Bilgi mi Azure Front Door? Burada görünümüne bakabilirsiniz.

Standart Azure Front Door Premium Kural Kümesi, eşleşme koşulları ve eylemlerinin birleşimiyle kurallardan oluşur. Bu makale, Standart/Premium Kural Kümesi'Azure Front Door kullanabileceğiniz eylemlerin ayrıntılı bir açıklamasını sağlar. eylemi, eşleşme koşullarının tanımladığı bir istek türüne uygulanan davranışı tanımlar. Bir Azure Front Door (Standart/Premium) Kural Kümesinde, bir kural en fazla beş eylem içerebilir.

Önemli

Azure Front Door Standart/Premium (Önizleme) şu anda genel önizlemededir. Önizleme sürümü bir hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yüklerinde kullanılması önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Aşağıdaki eylemler, kural kümesinde Azure Front Door kullanılabilir.

Önbellek süre sonu

Kuralların belirtilen koşullarla eş değere sahip istekler için uç noktanın yaşam süresi (TTL) değerinin üzerine yazmak için önbellek süre sonu eylemlerini kullanın.

Not

Çıkış noktası, , veya değerine sahip üst bilgisi kullanılarak Cache-Control belirli yanıtları önbelleğe no-cache private alınmamalarını no-store belirtebilirsiniz. Bu durumlarda, Front Door hiçbir zaman önbelleğe alınmaz ve bu eylemin hiçbir etkisi olmaz.

Özellikler

Özellik Desteklenen değerler
Önbellek davranışı
  • Önbelleği atla: İçerik önbelleğe alınmamalı. ARM şablonlarında özelliğini cacheBehavior olarak BypassCache ayarlayın.
  • Geçersiz Kılma: Kaynağınız tarafından döndürülen TTL değerinin üzerine eylemde belirtilen değer yazılır. Bu davranış yalnızca yanıtın önbelleklenebilir olması durumunda uygulanır. ARM şablonlarında, cacheBehavior özelliğini olarak ayarlayın Override .
  • Eksikse ayarla: Kaynağından bir TTL değeri döndürülmezse, kural TTL 'yi eylemde belirtilen değere ayarlar. Bu davranış yalnızca yanıtın önbelleklenebilir olması durumunda uygulanır. ARM şablonlarında, cacheBehavior özelliğini olarak ayarlayın SetIfMissing .
Önbellek süresi Önbellek davranışı veya olarak ayarlandığında Override Set if missing , bu alanların kullanılacak önbellek süresini belirtmesi gerekir. En uzun süre 366 gündür.
  • Azure portal: gün, saat, dakika ve saniye sayısını belirtin.
  • ARM şablonlarında: süreyi biçimde belirtin d.hh:mm:ss .

Örnek

Bu örnekte, zaten bir önbellek süresi belirtmeyen eşleşen istekler için önbellek süre sonunu 6 saat olarak geçersiz kılıyoruz.

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

Önbellek anahtarı sorgu dizesi

Sorgu dizelerine göre önbellek anahtarını değiştirmek için önbellek anahtarı sorgu dizesi eylemini kullanın. Önbellek anahtarı, ön kapısının önbelleğe yönelik benzersiz istekleri tanımladığı yoldur.

Özellikler

Özellik Desteklenen değerler
Davranış
  • Şunları içerir: Parametrelerde belirtilen sorgu dizeleri, önbellek anahtarı oluşturulduğunda dahil edilir. ARM şablonlarında, queryStringBehavior özelliğini olarak ayarlayın Include .
  • Her benzersiz URL 'Yi önbelleğe al: Her benzersiz URL 'nin kendi önbellek anahtarı vardır. ARM şablonlarında, ' nı kullanın queryStringBehavior IncludeAll .
  • Hariç tut: Parametrelerde belirtilen sorgu dizeleri, önbellek anahtarı oluşturulduğunda hariç tutulur. ARM şablonlarında özelliğini queryStringBehavior olarak Exclude ayarlayın.
  • Sorgu dizelerini yoksay: Önbellek anahtarı oluşturulurken sorgu dizeleri dikkate alınmaz. ARM şablonlarında özelliğini queryStringBehavior olarak ExcludeAll ayarlayın.
Parametreler Virgülle ayrılmış sorgu dizesi parametre adlarının listesi.

Örnek

Bu örnekte, önbellek anahtarını adlı bir sorgu dizesi parametresi içerecek şekilde customerId değiştiririz.

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

İstek üst bilgisini değiştirme

İstek kaynağınıza gönderilirken istekteki üst bilgileri değiştirmek için İstek üst bilgisini değiştir eylemini kullanın.

Özellikler

Özellik Desteklenen değerler
Operatör
  • Ekleme: Belirtilen üst bilgi, belirtilen değerle i isteğine eklenir. Üst bilgi zaten varsa, değer dize birlemleme kullanılarak mevcut üst bilgi değerine eklenir. Sınırlayıcı eklenmez. ARM şablonlarında headerAction Append kullanın.
  • Üzerine yaz: Belirtilen üst bilgi, belirtilen değerle i isteğine eklenir. Üst bilgi zaten varsa, belirtilen değer mevcut değerin üzerine yazmıştır. ARM şablonlarında headerAction Overwrite kullanın.
  • Sil: Kuralda belirtilen üst bilgi varsa üst bilgi istekten silinir. ARM şablonlarında headerAction Delete kullanın.
Üst bilgi adı Değiştirilen üst bilginin adı.
Üst bilgi değeri Eklenecek veya üzerine yaz eklenecek değer.

Örnek

Bu örnekte, değeri istek üst AdditionalValue bilgisinde MyRequestHeader ekleriz. Kaynak, yanıt üst bilgisini bir değerine ayarlarsanız ValueSetByClient , bu eylem uygulandıktan sonra, istek üstbilgisinin değeri olur ValueSetByClientAdditionalValue .

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

Yanıt üst bilgisini Değiştir

Yanıtlarınızda bulunan üst bilgileri, istemcilerinize döndürülmeden önce değiştirmek için yanıt başlığını Değiştir eylemini kullanın.

Özellikler

Özellik Desteklenen değerler
Operatör
  • Ekle: Belirtilen üst bilgi, belirtilen değere sahip yanıta eklenmiş. Üst bilgi zaten mevcutsa, bu değer dize birleştirme kullanılarak mevcut üst bilgi değerine eklenir. Sınırlayıcı eklenmez. ARM şablonlarında, ' nı kullanın headerAction Append .
  • Üzerine yaz: Belirtilen üst bilgi, belirtilen değere sahip yanıta eklenmiş. Üst bilgi zaten mevcutsa, belirtilen değer varolan değerin üzerine yazar. ARM şablonlarında, ' nı kullanın headerAction Overwrite .
  • Sil: Kuralda belirtilen üst bilgi varsa, üst bilgi yanıttan silinir. ARM şablonlarında, ' nı kullanın headerAction Delete .
Üst bilgi adı Değiştirilecek üstbilginin adı.
Üst bilgi değeri Eklenecek veya üzerine yazılacak değer.

Örnek

Bu örnekte, X-Powered-By istemciye döndürülmeden önce yanıtlardan adı ile üst bilgi silinir.

Yanıt başlığını değiştir eylemini gösteren Portal ekran görüntüsü.

URL yeniden yönlendirme

İstemcileri yeni bir URL 'ye yönlendirmek için URL yeniden yönlendirme eylemini kullanın. İstemciler, ön kapıdan bir yeniden yönlendirme yanıtı gönderilir.

Özellikler

Özellik Desteklenen değerler
Yeniden yönlendirme türü İstekteora geri dönmek için yanıt türü.
  • Aşağıdaki Azure portal: 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ü
  • Şu Azure portal: , Match Request HTTP , HTTPS
  • ARM şablonlarında: MatchRequest , Http , Https
Hedef konak İsteğin yeniden yönlendirilmesi için istediğiniz ana bilgisayar adı. Gelen ana bilgisayarı korumak için boş bırakın.
Hedef yol Yeniden yönlendirmede kullanmak için yol. Öndeki 'i dahil / etmek. Gelen yolu korumak için boş bırakın.
Sorgu dizesi Yeniden yönlendirmede kullanılan sorgu dizesi. Baştaki 'i dahil ? etme. Gelen sorgu dizesini korumak için boş bırakın.
Hedef parça Yeniden yönlendirmede kullanmak üzere parça. Gelen parçayı korumak için boş bırakın.

Örnek

Bu örnekte, parçayı korurken isteği https://contoso.com/exampleredirection?clientIp={client_ip} 'ye yeniden yönlendirin. HTTP geçici yeniden yönlendirme (307) kullanılır. İstemcinin IP adresi, {client_ip} client_ip sunucu değişkenikullanılarak URL içindeki belirtecin yerine kullanılır.

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

URL yeniden yazma

URL yeniden yazma eylemini kullanarak, kaynağına en çok yönlendiren bir isteğin yolunu yazın.

Özellikler

Özellik Desteklenen değerler
Kaynak stili Değiştirilecek URL yolundaki kaynak modelini tanımlayın. Şu anda, kaynak stili önek tabanlı eşleşme kullanıyor. Tüm URL yollarını eşleştirmek için, / kaynak model değeri olarak bir eğik çizgi () kullanın.
Hedef Yeniden yazma sırasında kullanılacak hedef yolu tanımlayın. Hedef yol, kaynak deseninin üzerine yazar.
Eşleşmeyen yolu koru Evet olarak ayarlanırsa, kaynak örüntüden sonraki kalan yol yeni hedef yoluna eklenir.

Örnek

Bu örnekte, tüm istekleri yola yeniden yazdık /redirection ve yolun geri kalanını korumuyoruz.

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

Kaynak grubu geçersiz kılma

İsteğin yönlendirileceği kaynak grubunu değiştirmek için kaynak grubu geçersiz kılma eylemini kullanın.

Özellikler

Özellik Desteklenen değerler
Kaynak grubu İsteğin yönlendirileceği kaynak grubu. Bu, ön kapı uç noktası rotasında belirtilen yapılandırmayı geçersiz kılar.

Örnek

Bu örnekte, tüm eşleşen istekleri SecondOriginGroup , ön kapı uç noktası rotasındaki yapılandırmadan bağımsız olarak adlı bir kaynak grubuna yönlendiririz.

Kaynak grubu geçersiz kılma eylemini gösteren Portal ekran görüntüsü.

Sunucu değişkenleri

Kural kümesi sunucu değişkenleri, istek hakkındaki yapılandırılmış bilgilere erişim sağlar. İstek/yanıt üstbilgilerini veya URL yeniden yazma yollarını/Sorgu dizelerini dinamik olarak değiştirmek için sunucu değişkenlerini kullanabilirsiniz; Örneğin, yeni bir sayfa yüklenirken veya bir form gönderildiğinde.

Desteklenen değişkenler

Değişken adı Description
socket_ip Azure ön kapısının doğrudan bağlantısının IP adresi. İstemci, isteği göndermek için bir HTTP proxy veya bir yük dengeleyici kullandıysanız değeri, socket_ip proxy 'nin veya yük DENGELEYICININ IP adresidir.
client_ip Özgün isteği yapan istemcinin IP adresi. X-Forwarded-Forİstekte bir üst bilgi varsa, bu durumda ISTEMCI IP adresi başlığından çekilir.
client_port İsteği yapan istemcinin IP bağlantı noktası.
hostname İstemciden gelen istekteki ana bilgisayar adı.
geo_country İstek sahibinin ülke/bölge kodu üzerinden kaynak ülkesini/bölgesini gösterir.
http_method Veya gibi URL isteğini yapmak için kullanılan yöntem GET POST .
http_version İstek Protokolü. Genellikle HTTP/1.0 , HTTP/1.1 veya HTTP/2.0 .
query_string İstenen URL 'de "?" öğesini izleyen değişken/değer çiftleri listesi.
Örneğin, istekte, değer olacaktır http://contoso.com:8080/article.aspx?id=123&title=fabrikam query_string id=123&title=fabrikam .
request_scheme İstek düzeni: http veya https .
request_uri Tüm özgün istek URI 'SI (bağımsız değişkenlerle).
Örneğin, isteğinde http://contoso.com:8080/article.aspx?id=123&title=fabrikam değeri request_uri /article.aspx?id=123&title=fabrikam olur.
ssl_protocol Kurulmuş bir TLS bağlantısının protokolü.
server_port İsteği kabul eden sunucunun bağlantı noktası.
url_path Konakta web istemcisinin erişmek istediği kaynağı tanımlar. Bu, bağımsız değişkenler olmadan istek URI'sinde yer alan bölüm.
Örneğin, isteğinde http://contoso.com:8080/article.aspx?id=123&title=fabrikam değeri uri_path /article.aspx olur.

Sunucu değişkeni biçimi

Sunucu değişkenleri aşağıdaki biçimler kullanılarak belirtilebilir:

  • {variable}: Sunucu değişkeninin tamamını içerir. Örneğin, istemci IP adresi ise 111.222.333.444 belirteç {client_ip} olarak 111.222.333.444 değerlendirilir.
  • {variable:offset}: Sunucu değişkenlerini belirli bir uzaklığın sonuna kadar dahil etmek. Uzaklık sıfır tabanlıdır. Örneğin, istemci IP adresi ise 111.222.333.444 belirteç {client_ip:3} olarak .222.333.444 değerlendirilir.
  • {variable:offset:length}: Belirtilen uzunluktaki belirli bir uzaklığın ardından sunucu değişkenlerini dahil etmek. Uzaklık sıfır tabanlıdır. Örneğin, istemci IP adresi ise 111.222.333.444 belirteç {client_ip:4:3} olarak 222 değerlendirilir.

Desteklenen işlemler

Sunucu değişkenleri aşağıdaki eylemlerde de kullanılabilir:

  • Önbellek anahtarı sorgu dizesi
  • İstek üst bilgisini değiştirme
  • Yanıt üst bilgisini değiştirme
  • URL yeniden yönlendirme
  • URL yeniden yazma

Sonraki adımlar