Azure Front Door standard/prémium (előzetes verzió) szabálykészlet-műveletek

Megjegyzés

Ez a dokumentáció a Azure Front Door Standard/Prémium (előzetes verzió) verzióhoz érhető el. Információt keres a Azure Front Door? Tekintse meg itt:.

A Azure Front Door standard/prémium szabálykészlet egy egyeztetési feltételek és műveletek kombinációjából álló szabályokból áll. Ez a cikk részletesen beleírást nyújt a standard/Azure Front Door szabálykészletben használható műveletekről. A művelet határozza meg a kérelemtípusra alkalmazott viselkedést, amit egy egyeztetési feltétel(ök) azonosít. Egy Azure Front Door (Standard/Prémium) szabálykészletben egy szabály legfeljebb öt műveletet tartalmazhat.

Fontos

Azure Front Door Standard/Prémium (előzetes verzió) jelenleg nyilvános előzetes verzióban érhető el. Erre az előzetes verzióra nem vonatkozik szolgáltatói szerződés, és a használata nem javasolt éles számítási feladatok esetén. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.

A következő műveletek használhatók Azure Front Door szabálykészletben.

Gyorsítótár lejárata

A gyorsítótár elévülési műveletével írja felül a végpont azon lekérési ideje (TTL) értékét, amelyekre a szabályok megfelelnek a feltételeknek.

Megjegyzés

Az eredetekkel megadható, hogy ne gyorsítótárazzanak adott válaszokat a , vagy értékű fejléc Cache-Control no-cache private no-store használatával. Ilyen körülmények között a Front Door soha nem gyorsítótárazza a tartalmat, és ennek a műveletnek nincs hatása.

Tulajdonságok

Tulajdonság Támogatott értékek
Gyorsítótár viselkedése
  • Gyorsítótár megkerülése: A tartalmat nem szabad gyorsítótárazza. Az ARM-sablonokban állítsa a cacheBehavior tulajdonságot a BypassCache következőre: .
  • Felülbírálás: A forrásból visszaadott TTL-érték felül lesz írva a műveletben megadott értékkel. Ez a viselkedés csak akkor lesz alkalmazva, ha a válasz gyorsítótárazható. Az ARM-sablonokban állítsa a cacheBehavior tulajdonságot a Override következőre: .
  • Ha hiányzik, állítsa be a következőt: Ha a forrás nem ad vissza TTL-értéket, a szabály a műveletben megadott értékre állítja az TTL-t. Ez a viselkedés csak akkor lesz alkalmazva, ha a válasz gyorsítótárazható. Az ARM-sablonokban állítsa a cacheBehavior tulajdonságot a SetIfMissing következőre: .
Gyorsítótár időtartama Ha a Gyorsítótár viselkedése vagy értékre van állítva, ezeknek a mezőknek meg kell Override Set if missing adniuk a használni kívánt gyorsítótár időtartamát. A maximális időtartam 366 nap.
  • A Azure Portal adja meg a napokat, órákat, perceket és másodperceket.
  • Az ARM-sablonokban adja meg az időtartamot d.hh:mm:ss formátumban.

Példa

Ebben a példában 6 órára bíráljuk felül a gyorsítótár lejáratát olyan megfeleltethető kérések esetén, amelyek még nem határoznak meg gyorsítótár-időtartamot.

A portál képernyőképe a gyorsítótár elévülési műveletről.

Gyorsítótár-kulcs lekérdezési sztring

A gyorsítótárkulcs lekérdezési sztring műveletének használatával módosíthatja a gyorsítótárkulcsot a lekérdezési sztringek alapján. A gyorsítótárkulcs az a módszer, Front Door azonosítja a gyorsítótárazási egyedi kéréseket.

Tulajdonságok

Tulajdonság Támogatott értékek
Működés
  • Foglalja bele a következőket: A paraméterekben megadott lekérdezési sztringek a gyorsítótárkulcs generálásakor szerepelnek. Az ARM-sablonokban állítsa a queryStringBehavior tulajdonságot a Include következőre: .
  • Gyorsítótáraz minden egyedi URL-címet: Minden egyedi URL-cím saját gyorsítótárk kulccsal rendelkezik. Az ARM-sablonokban használja a queryStringBehavior IncludeAll et.
  • Exclude (Kizárás): A paraméterekben megadott lekérdezési sztringek ki vannak zárva a gyorsítótárkulcs generálásakor. Az ARM-sablonokban állítsa a queryStringBehavior tulajdonságot a Exclude következőre: .
  • Lekérdezési sztringek figyelmen kívül hagyása: A lekérdezési sztringek nem számítanak a gyorsítótárkulcs generálásakor. Az ARM-sablonokban állítsa a queryStringBehavior tulajdonságot a ExcludeAll következőre: .
Paraméterek A lekérdezési sztring paraméternevének listája vesszővel elválasztva.

Példa

Ebben a példában úgy módosítjuk a gyorsítótárkulcsot, hogy tartalmazza a nevű lekérdezési sztring customerId paramétert.

A portál képernyőképe a gyorsítótárkulcs lekérdezési sztringje műveletről.

Kérelemfejléc módosítása

A kérés fejlécének módosítása művelet használatával módosíthatja a kérés fejlécét, amikor az a forráshoz lesz elküldve.

Tulajdonságok

Tulajdonság Támogatott értékek
Operátor
  • Hozzáfűzés: A megadott fejléc hozzáadódik a kérelemhez a megadott értékkel. Ha a fejléc már jelen van, a rendszer sztring-összefűzött szöveg használatával hozzáfűzi az értéket a meglévő fejlécértékhez. Elválasztó karaktert nem ad hozzá. Az ARM-sablonokban használja a headerAction Append et.
  • Felülírás: A megadott fejléc hozzáadódik a kérelemhez a megadott értékkel. Ha a fejléc már jelen van, a megadott érték felülírja a meglévő értéket. Az ARM-sablonokban használja a headerAction Overwrite et.
  • Törlés: Ha a szabályban megadott fejléc jelen van, a fejléc törlődik a kérésből. Az ARM-sablonokban használja a headerAction Delete et.
Fejléc neve A módosítani szükséges fejléc neve.
Fejléc értéke A hozzáfűzni vagy felülírni való érték.

Példa

Ebben a példában a kérés fejlécéhez fűzi hozzá AdditionalValue MyRequestHeader az értéket. Ha a forrás a válaszfejlécet értékre állítsa, akkor a művelet alkalmazása után a kérelemfejléc értéke ValueSetByClient ValueSetByClientAdditionalValue lesz.

Képernyőkép a portálról a kérés fejlécének módosítása műveletről.

Válaszfejléc módosítása

A válaszfejléc módosítása művelettel módosíthatja a válaszokban található fejléceket, mielőtt azok visszakerülnek az ügyfelekhez.

Tulajdonságok

Tulajdonság Támogatott értékek
Operátor
  • Hozzáfűzés: A megadott fejléc bekerül a válaszba a megadott értékkel. Ha a fejléc már jelen van, a rendszer sztring-összefűzött szöveg használatával hozzáfűzi az értéket a meglévő fejlécértékhez. Nem ad hozzá elválasztó karaktert. Az ARM-sablonokban használja a headerAction Append et.
  • Felülírás: A megadott fejléc bekerül a válaszba a megadott értékkel. Ha a fejléc már jelen van, a megadott érték felülírja a meglévő értéket. Az ARM-sablonokban használja a headerAction Overwrite et.
  • Törlés: Ha a szabályban megadott fejléc jelen van, a fejléc törlődik a válaszból. Az ARM-sablonokban használja a headerAction Delete et.
Fejléc neve A módosítania kell a fejléc nevét.
Fejléc értéke A hozzáfűzni vagy felülírni való érték.

Példa

Ebben a példában töröljük a fejlécet a válaszokból, mielőtt X-Powered-By visszaadjuk őket az ügyfélnek.

Képernyőkép a portálról a válaszfejléc módosítása műveletről.

URL-átirányítás

Az URL-átirányítási művelet használatával átirányíthatja az ügyfeleket egy új URL-címre. Az ügyfelek átirányítási választ küldnek a Front Door.

Tulajdonságok

Tulajdonság Támogatott értékek
Átirányítás típusa A válasz típusa, hogy visszatérjen a kérelmezőnek.
  • A következő Azure Portal található (302), áthelyezve (301), ideiglenes átirányítás (307), állandó átirányítás (308).
  • AZ ARM-sablonokban: Found Moved , , TemporaryRedirect , PermanentRedirect
Átirányítási protokoll
  • A következő Azure Portal: Match Request HTTP , , HTTPS
  • AZ ARM-sablonokban: MatchRequest Http , , Https
Cél gazdagép A gazdanév, amelybe át szeretné irányítani a kérést. A bejövő gazdagép megőrzése érdekében hagyja üresen.
Cél elérési útja Az átirányításban használni használt elérési út. Foglalja bele a / kezdőt. Hagyja üresen a bejövő útvonal megőrzéséhez.
Lekérdezési sztring Az átirányításban használt lekérdezési sztring. Ne tartalmazza a ? kezdőt. Hagyja üresen a bejövő lekérdezési sztring megőrzéséhez.
Céltöredék Az átirányításban használt töredék. A bejövő töredék megőrzéséhez hagyja üresen.

Példa

Ebben a példában a kérést a következőre irányítjuk át, https://contoso.com/exampleredirection?clientIp={client_ip} a töredék megőrzése mellett. A rendszer http ideiglenes átirányítást (307) használ. Az URL-címben található jogkivonat helyére az ügyfél IP-címét kell használni {client_ip} a client_ip kiszolgálóváltozó használatával.

A portál képernyőképe az URL-átirányítási műveletről.

URL-átírás

Az URL-átírási művelet használatával írja át a forráshoz úton található kérés elérési útját.

Tulajdonságok

Tulajdonság Támogatott értékek
Forrásminta Határozza meg a forrásmintát a lecserélni kívánt URL-útvonalon. A forrásminta jelenleg előtagalapú egyezést használ. Az összes URL-útvonal egyeztetéséhez használjon perjelet / () a forrásminta értékeként.
Cél Adja meg az átírásban használni használt célútvonalat. A cél elérési útja felülírja a forrásmintát.
Nem egyező elérési út megőrzése Ha a beállítás igen, a forrásminta utáni fennmaradó elérési út az új célútvonalhoz lesz hozzáfűzve.

Példa

Ebben a példában átírjuk az összes kérést a elérési útra, és nem őrizzük meg az elérési út /redirection többi részét.

A portál képernyőképe az URL-átírási műveletről.

Forráscsoport felülbírálása

A Forráscsoport felülbírálása művelet használatával módosíthatja azt a forráscsoportot, amelybe a kérést át szeretné irányítva.

Tulajdonságok

Tulajdonság Támogatott értékek
Forráscsoport Az a forráscsoport, amelybe a kérést át kell irányítanunk. Ez felülírja a végpont útvonalán Front Door konfigurációt.

Példa

Ebben a példában az összes megfelelt kérést egy nevű forráscsoporthoz irányítjuk, függetlenül attól, hogy milyen konfiguráció van Front Door SecondOriginGroup végpont útvonalán.

A portál képernyőképe a forráscsoport felülbírálási műveletével.

Kiszolgálóváltozók

A Szabálykészlet kiszolgálóváltozói hozzáférést biztosítanak a kérés strukturált információihoz. A kiszolgálóváltozók használatával dinamikusan módosíthatja a kérés-/válaszfejléceket vagy az URL-átírási útvonalakat/lekérdezési sztringeket, például új oldal betöltésekor vagy űrlap közzétettekor.

Támogatott változók

Változó neve Description
socket_ip A peremhálózathoz való közvetlen Azure Front Door IP-címe. Ha az ügyfél HTTP-proxyt vagy terheléselosztást használt a kérés elküldését, a értéke a proxy vagy a socket_ip terheléselosztás IP-címe.
client_ip Annak az ügyfélnek az IP-címe, amely az eredeti kérést tette. Ha a kérelemben fejléc található, akkor az ügyfél X-Forwarded-For IP-címe lesz kiveve a fejlécből.
client_port A kérést érvénybe kötő ügyfél IP-portja.
hostname Az ügyféltől származó kérésben az állomásnév.
geo_country A kérelmező származási országát/régióját jelzi az ország/régió kódon keresztül.
http_method Az URL-kérelem igényléséhez használt metódus, például GET vagy POST .
http_version A kérelem protokollja. Általában HTTP/1.0 , HTTP/1.1 vagy HTTP/2.0 .
query_string A kért URL-címben a "?" után következő változó/érték párok listája.
A kérésben például http://contoso.com:8080/article.aspx?id=123&title=fabrikam a értéke query_string id=123&title=fabrikam lesz.
request_scheme A kérelemséma: http vagy https .
request_uri Az eredeti kérelem teljes URI-ja (argumentumokkal).
A kérésben például http://contoso.com:8080/article.aspx?id=123&title=fabrikam a értéke request_uri /article.aspx?id=123&title=fabrikam lesz.
ssl_protocol A létrehozott TLS-kapcsolat protokollja.
server_port A kérést elfogadó kiszolgáló portja.
url_path Azonosítja a gazdagépnek azt az erőforrását, amelyhez a webes ügyfél hozzá szeretne férni. Ez a kérés URI-nak az argumentumok nélküli része.
A kérésben például http://contoso.com:8080/article.aspx?id=123&title=fabrikam a értéke uri_path /article.aspx lesz.

Kiszolgálóváltozó formátuma

A kiszolgálói változók a következő formátumokkal állíthatók be:

  • {variable}: A teljes kiszolgálóváltozót foglalja bele. Ha például az ügyfél IP-címe, a 111.222.333.444 {client_ip} jogkivonat kiértékelése a következő lesz: 111.222.333.444 .
  • {variable:offset}: A kiszolgálóváltozót egy adott eltolás után a változó végéig kell tartalmaznia. Az eltolás nullaalapú. Ha például az ügyfél IP-címe , akkor a 111.222.333.444 {client_ip:3} jogkivonat kiértékelése a következő lesz: .222.333.444 .
  • {variable:offset:length}: Adja meg a kiszolgálóváltozót egy adott eltolás után, a megadott hosszúságig. Az eltolás nulla alapú. Ha például az ügyfél IP-címe, a 111.222.333.444 {client_ip:4:3} jogkivonat kiértékelése a következő lesz: 222 .

Támogatott műveletek

A kiszolgálói változókat a következő műveletek támogatják:

  • Gyorsítótár-kulcs lekérdezési sztring
  • Kérelemfejléc módosítása
  • Válaszfejléc módosítása
  • URL-átirányítás
  • URL-átírás

Következő lépések