Szabálykészlet-műveletek

Az Azure Front Door-szabálykészletek egyezési feltételek és műveletek kombinációját tartalmazó szabályokból állnak. Ez a cikk részletesen ismerteti a szabálykészletekben használható műveleteket. A művelet meghatározza, hogy a rendszer milyen viselkedést alkalmaz egy olyan kérelemtípusra, amelyet egy feltétel(ek) azonosít. Egy szabálykészletben egy szabály legfeljebb öt művelettel rendelkezhet. A Front Door egy szabálykészlet-műveletben is támogatja a kiszolgálóváltozót .

A következő műveletek használhatók egy szabálykészletben:

Útvonalkonfiguráció felülbírálása

Az útvonalkonfiguráció felülbírálási művelete a kérés forráscsoportjának vagy gyorsítótárazási konfigurációjának felülbírálására szolgál. Dönthet úgy, hogy felülbírálja vagy tiszteletben tartja az útvonalban megadott forráscsoport-konfigurációkat. Ha azonban felülbírálja az útvonalkonfigurációt, konfigurálnia kell a gyorsítótárazást. Ellenkező esetben a gyorsítótárazás le lesz tiltva a kéréshez.

Felülbírálhatja azt is, hogy a fájlok hogyan lesznek gyorsítótárazva adott kérésekhez, például:

  • Bírálja felül a forrás által megadott gyorsítótárazási viselkedést.
  • A lekérdezési sztringparaméterek használata a kérelem gyorsítótárkulcsának létrehozásához.
  • Az élettartam (TTL) értéke annak szabályozására, hogy a tartalom mennyi ideig maradjon a gyorsítótárban.

Tulajdonságok

Tulajdonság Támogatott értékek
Forráscsoport felülbírálása
  • Igen: Felülbírálja a kéréshez használt forráscsoportot.
  • Nem: Használja az útvonalban megadott forráscsoportot.
Gyorsítótárazás
  • Engedélyezve: A gyorsítótárazás engedélyezésének kényszerítése a kéréshez.
  • Letiltva: Tiltsa le a gyorsítótárazást a kéréshez.

Ha a felülbírálás forráscsoportja Igen értékre van állítva, állítsa be a következő tulajdonságokat:

Tulajdonság Támogatott értékek
Forráscsoport Az a forráscsoport, amelybe a kérést átirányítani kell. Ez a beállítás felülírja a Front Door végpontútvonalában megadott konfigurációt.
Továbbítási protokoll A Front Door protokollja, amelyet a kérés forráshoz való továbbításakor használnak. A támogatott értékek csak HTTP, CSAK HTTPS, Egyezés a bejövő kéréssel. Ez a beállítás felülírja a Front Door végpontútvonalában megadott konfigurációt.

Ha a gyorsítótárazás engedélyezve van, állítsa be a következő tulajdonságokat:

Tulajdonság Támogatott értékek
Lekérdezési sztringek gyorsítótárazásának működése
  • Lekérdezési sztring figyelmen kívül hagyása: A gyorsítótárkulcs létrehozásakor a rendszer nem veszi figyelembe a lekérdezési sztringeket. ARM-sablonokban állítsa a tulajdonságot a queryStringCachingBehavior következőre IgnoreQueryString: .
  • Lekérdezési sztring használata: Minden egyedi URL-címnek saját gyorsítótárkulcsa van. ARM-sablonokban használja a queryStringCachingBehavior következőt UseQueryString: .
  • A megadott lekérdezési sztring figyelmen kívül hagyása: A paraméterekben megadott lekérdezési sztringek ki lesznek zárva a gyorsítótárkulcs létrehozásakor. ARM-sablonokban állítsa a tulajdonságot a queryStringCachingBehavior következőre IgnoreSpecifiedQueryStrings: .
  • Adja meg a megadott lekérdezési sztringet: A paraméterekben megadott lekérdezési sztringek bekerülnek a gyorsítótárkulcs létrehozásakor. ARM-sablonokban állítsa a tulajdonságot a queryStringCachingBehavior következőre IncludeSpecifiedQueryStrings: .
Paraméterek lekérdezése A lekérdezési sztring paraméterneveinek listája vesszővel elválasztva. Ez a tulajdonság csak akkor van beállítva, ha a lekérdezési sztring gyorsítótárazási viselkedése a megadott lekérdezési sztringek figyelmen kívül hagyása vagy a megadott lekérdezési sztringek belefoglalása beállításra van beállítva.
Tömörítés
  • Engedélyezve: A Front Door dinamikusan tömöríti a tartalmat a peremhálózaton, ami kisebb és gyorsabb választ eredményez. További információ: Fájltömörítés. ARM-sablonokban állítsa a tulajdonságot a isCompressionEnabled következőre Enabled: .
  • Letiltva. A Front Door nem végez tömörítést. ARM-sablonokban állítsa a tulajdonságot a isCompressionEnabled következőre Disabled: .
Gyorsítótár viselkedése
  • Tisztelet forrása: A Front Door mindig tiszteletben tartja az eredetválasz fejlécének irányelvét. Ha a származási irányelv hiányzik, a Front Door 1–3 napig bárhol gyorsítótárazza a tartalmat. ARM-sablonokban állítsa a tulajdonságot a cacheBehavior következőre HonorOrigin: .
  • Mindig felülbírálás: A forrásból visszaadott TTL-érték felülíródik a műveletben megadott értékkel. Ezt a viselkedést csak akkor alkalmazza a rendszer, ha a válasz gyorsítótárazható. ARM-sablonokban állítsa a tulajdonságot a cacheBehavior következőre OverrideAlways: .
  • Felülbírálás, ha hiányzik a forrás: Ha nem kap TTL-értéket a forrásból, a szabály a TTL-t a műveletben megadott értékre állítja. Ezt a viselkedést csak akkor alkalmazza a rendszer, ha a válasz gyorsítótárazható. ARM-sablonokban állítsa a tulajdonságot a cacheBehavior következőre OverrideIfOriginMissing: .
Gyorsítótár időtartama Ha a gyorsítótár viselkedése a következőre Override always van állítva vagy Override if origin missing, ezeknek a mezőknek meg kell adniuk a használni kívánt gyorsítótár-időtartamot. A maximális időtartam 366 nap. 0 másodpercig a CDN gyorsítótárazza a tartalmat, de minden kérést újra kell értékelnie a forráskiszolgálóval. Ez a tulajdonság csak akkor van beállítva, ha a gyorsítótár viselkedése mindig felülbírálásra vagy felülbírálásra van állítva, ha hiányzik a forrás.
  • Az Azure Portalon adja meg a napokat, órákat, perceket és másodperceket.
  • ARM-sablonokban: a cacheDuration formátumban d.hh:mm:ssadja meg az időtartamot.

Példák

Ebben a példában az összes megfeleltethető kérést egy névvel ellátott MyOriginGroupforráscsoporthoz irányítjuk, függetlenül a Front Door végpontútvonal konfigurációjától.

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

Ebben a példában úgy állítjuk be a gyorsítótárkulcsot, hogy tartalmazzon egy lekérdezési sztring paramétert.customerId A tömörítés engedélyezve van, és a forrás gyorsítótárazási szabályzatai teljesülnek.

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

Ebben a példában felülbíráljuk a gyorsítótár lejárati időtartamát 6 órára olyan egyeztetett kérések esetén, amelyek még nem határoznak meg gyorsítótár-időtartamot. A Front Door figyelmen kívül hagyja a lekérdezési sztringet, amikor meghatározza a gyorsítótárkulcsot, és a tömörítés engedélyezve van.

A portál képernyőképe a gyorsítótár lejárati műveletével.

Kérelem fejlécének módosítása

A kérelem fejlécének módosítása művelet használatával módosíthatja a kérelem fejléceit, amikor az a forrásnak küldi.

Tulajdonságok

Tulajdonság Támogatott értékek
Operátor
  • Hozzáfűzés: A megadott fejléc hozzáadódik a kéréshez a megadott értékkel. Ha a fejléc már jelen van, az érték sztringösszefűzéssel lesz hozzáfűzve a meglévő fejlécértékhez. A rendszer nem ad hozzá elválasztójeleket. ARM-sablonokban használja a headerAction következőt Append: .
  • Felülírás: A megadott fejléc a megadott értékkel lesz hozzáadva a kéréshez. Ha a fejléc már létezik, a megadott érték felülírja a meglévő értéket. ARM-sablonokban használja a headerAction következőt Overwrite: .
  • Törlés: Ha a szabályban megadott fejléc jelen van, a rendszer törli a fejlécet a kérelemből. ARM-sablonokban használja a headerAction következőt Delete: .
Fejléc neve A módosítani kívánt fejléc neve.
Fejléc értéke A hozzáfűzni vagy felülírni kívánt érték.

Példa

Ebben a példában az értéket AdditionalValue hozzáfűzzük a MyRequestHeader kérelem fejlécéhez. Ha a forrás a válaszfejlécet a következő értékre állítja ValueSetByClient, akkor a művelet alkalmazása után a kérelem fejlécének ValueSetByClientAdditionalValueértéke a következő lesz: .

A portál képernyőképe a kérelem fejlécének módosításáról.

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

A válaszfejléc módosítása művelet használatával módosíthatja a válaszokban szereplő fejléceket, mielőtt visszakerülnének az ügyfelekhez.

Tulajdonságok

Tulajdonság Támogatott értékek
Operátor
  • Hozzáfűzés: A megadott fejléc hozzáadódik a válaszhoz a megadott értékkel. Ha a fejléc már jelen van, az érték sztringösszefűzéssel lesz hozzáfűzve a meglévő fejlécértékhez. A rendszer nem ad hozzá elválasztójeleket. ARM-sablonokban használja a headerAction következőt Append: .
  • Felülírás: A megadott fejléc a megadott értékkel lesz hozzáadva a válaszhoz. Ha a fejléc már létezik, a megadott érték felülírja a meglévő értéket. ARM-sablonokban használja a headerAction következőt Overwrite: .
  • Törlés: Ha a szabályban megadott fejléc jelen van, a rendszer törli a fejlécet a válaszból. ARM-sablonokban használja a headerAction következőt Delete: .
Fejléc neve A módosítani kívánt fejléc neve.
Fejléc értéke A hozzáfűzni vagy felülírni kívánt érték.

Példa

Ebben a példában a válaszokból a névvel X-Powered-By ellátott fejlécet töröljük, mielőtt visszakerülnének az ügyfélhez.

A portál képernyőképe a válaszfejléc módosításáró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 kapnak a Front Doortól.

Tulajdonságok

Tulajdonság Támogatott értékek
Átirányítás típusa A kérelmezőnek visszaadandó választípus.
  • Az Azure Portalon: Found (302), Moved (301), Ideiglenes átirányítás (307), Állandó átirányítás (308).
  • ARM-sablonokban: Found, Moved, , TemporaryRedirectPermanentRedirect
Átirányítási protokoll
  • Az Azure Portalon: Match Request, , HTTPHTTPS
  • ARM-sablonokban: MatchRequest, , HttpHttps
Cél gazdagép Annak a gazdagépnek a neve, amelyhez a kérést át szeretné irányítani. Hagyja üresen a bejövő gazdagép megőrzéséhez.
Cél elérési útja Az átirányításban használni kívánt elérési út. Adja meg a bevezetőt /. Hagyja üresen a bejövő elérési utat.
Lekérdezési sztring Az átirányításban használt lekérdezési sztring. Ne tartalmazza a bevezetőt ?. Hagyja üresen a bejövő lekérdezési sztring megőrzéséhez.
Céltöredék Az átirányításban használni kívánt töredék. Hagyja üresen a bejövő töredék megőrzéséhez.

Példa

Ebben a példában átirányítjuk a kérést 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 ügyfél IP-címét a rendszer az {client_ip} URL-cím jogkivonata helyett használja a client_ipkiszolgá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űvelettel átírhatja a forráshoz vezető kérés útvonalát.

Tulajdonságok

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

Példa

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

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

Fontos

Az Azure Front Door (klasszikus) 2027. március 31-én megszűnik. A szolgáltatáskimaradás elkerülése érdekében fontos, hogy az Azure Front Door (klasszikus) profiljait 2027 márciusára migrálja az Azure Front Door Standard vagy Prémium szintre. További információkért lásd az Azure Front Door (klasszikus) kivonását.

Az Azure Front Doorban (klasszikus) a szabályok motorja legfeljebb 25 szabályból állhat, amelyek egyező feltételeket és a kapcsolódó műveleteket tartalmaznak. Ez a cikk részletesen ismerteti a szabályban definiálható összes műveletet.

Egy művelet határozza meg a kérelemtípusra alkalmazott viselkedést, amely megfelel a feltételnek vagy az egyezési feltételek halmazának. A Szabálymotor konfigurációjában egy szabály legfeljebb 10 egyező feltételt és 5 műveletet tartalmazhat. Egyetlen szabályban csak egy felülbírálási útválasztási konfigurációs művelet lehet.

A szabályok motorkonfigurációjában az alábbi műveletek használhatók.

Kérelem fejlécének módosítása

Ezekkel a műveletekkel módosíthatja a háttérrendszernek küldött kérésekben szereplő fejléceket.

Kötelező mezők

Művelet HTTP-fejléc neve Érték
Hozzáfűzés Ha ez a beállítás ki van jelölve, és a szabály egyezik, a fejlécnévben megadott fejléc hozzáadódik a kéréshez a megadott értékkel. Ha a fejléc már létezik, az érték hozzá lesz fűzve a meglévő értékhez. Sztring
Felülírja Ha ez a beállítás be van jelölve, és a szabály egyezik, a fejlécnévben megadott fejléc hozzáadódik a kéréshez a megadott értékkel. Ha a fejléc már létezik, a megadott érték felülírja a meglévő értéket. Sztring
Törlés Ha ezt a beállítást egyező szabályokkal választja ki, és a szabályban megadott fejléc jelen van, a fejléc törlődik a kérelemből. Sztring

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

Ezekkel a műveletekkel módosíthatja az ügyfeleknek visszaadott válaszokban szereplő fejléceket.

Kötelező mezők

Művelet HTTP-fejléc neve Érték
Hozzáfűzés Ha ez a beállítás ki van jelölve, és a szabály egyezik, a fejlécnévben megadott fejléc a megadott érték használatával lesz hozzáadva a válaszhoz. Ha a fejléc már jelen van, az Érték hozzá lesz fűzve a meglévő értékhez. Sztring
Felülírja Ha ez a beállítás be van jelölve, és a szabály egyezik, a fejlécnévben megadott fejléc a megadott érték használatával lesz hozzáadva a válaszhoz. Ha a fejléc már jelen van, az Érték felülírja a meglévő értéket. Sztring
Törlés Ha ezt a beállítást egyező szabályokkal választja ki, és a szabályban megadott fejléc jelen van, a fejléc törlődik a válaszból. Sztring

Útválasztó-konfigurációk felülírása

Útvonal típusa: Átirányítás

Ezekkel a műveletekkel átirányíthatja az ügyfeleket egy új URL-címre.

Kötelező mezők

Mező Leírás
Átirányítás típusa Az átirányítással felhasználókat/ügyfeleket küldhet az egyik URL-címről a másikra. Az átirányítási típus beállítja az ügyfelek által az átirányítás céljának megértéséhez használt állapotkódot.

A következő átirányítási állapotkódokat választhatja ki: Found (302), Moved (301), Ideiglenes átirányítás (307) és Állandó átirányítás (308).
Átirányítási protokoll Tartsa meg a protokollt a bejövő kérésnek megfelelően, vagy adjon meg egy új protokollt az átirányításhoz. Válassza például a HTTPS lehetőséget a HTTP-ről HTTPS-átirányításra.
Cél gazdagép Állítsa be ezt az értéket úgy, hogy módosítsa az átirányítás URL-címében lévő állomásnevet, vagy más módon tartsa meg a gazdagépnevet a bejövő kérésből.
Cél elérési útja Őrizze meg az elérési utat a bejövő kérésnek megfelelően, vagy frissítse az átirányítás URL-címében lévő elérési utat.
Lekérdezési sztring Állítsa be ezt az értéket úgy, hogy lecserélje a bejövő kérelem URL-címéről származó meglévő lekérdezési sztringeket, vagy egyéb módon megtartsa a lekérdezési sztringek eredeti készletét.
Céltöredék A céltöredék az URL-cím "#" utáni része, amelyet általában a böngészők használnak a lap egy adott szakaszára való leszálláshoz. Állítsa be ezt az értéket úgy, hogy egy részletet adjon hozzá az átirányítási URL-címhez.

Útvonal típusa: Továbbítás

Ezekkel a műveletekkel továbbíthatja az ügyfeleket egy új URL-címre. Ezek a műveletek alműveleteket is tartalmaznak az URL-átírásokhoz és a gyorsítótárazáshoz.

Mező Leírás
Háttérkészlet Válassza ki a háttérkészletet a kérések felülbírálásához és kiszolgálásához. Az előre konfigurált háttérkészletek jelenleg a Front Door-profilban jelennek meg.
Továbbítási protokoll A kérések háttérrendszerbe történő továbbításához vagy a bejövő kérések protokolljának megfelelő protokollhoz használandó protokoll.
URL-átírás Az URL-átírási kérelem létrehozásakor használandó elérési út a háttérrendszernek való továbbításhoz.
Gyorsítótárazás Engedélyezze a gyorsítótárazást ehhez az útválasztási szabályhoz. Ha engedélyezve van, az Azure Front Door gyorsítótárazza a statikus tartalmat.

URL-átírás

Ezzel a beállítással konfigurálhat egy opcionális egyéni továbbítási útvonalat , amelyet a háttérrendszer felé továbbítandó kérés létrehozásakor használhat.

Mező Leírás
Egyéni továbbítási útvonal Adjon meg egy elérési utat, amelyre a kérések továbbítva lesznek.

Gyorsítótárazás

Ezekkel a beállításokkal szabályozhatja a fájlok gyorsítótárazási módját a lekérdezési sztringeket tartalmazó kérésekhez. A tartalom gyorsítótárazása az összes paraméter vagy a kiválasztott paraméterek alapján. Ezekkel a beállításokkal felülírhatja az élettartam (TTL) értékét annak szabályozásához, hogy a tartalom mennyi ideig maradjon a gyorsítótárban. Ha műveletként szeretné kényszeríteni a gyorsítótárazást, állítsa a gyorsítótárazási mezőt "Engedélyezve" értékre. A gyorsítótárazás kényszerítésekor a következő beállítások jelennek meg:

Gyorsítótár viselkedése Leírás
Lekérdezési sztring figyelmen kívül hagyása Az objektum gyorsítótárazása után az összes ezt követő kérés figyelmen kívül hagyja a lekérdezési sztringeket, amíg a gyorsítótárazott objektum le nem jár.
Lekérdezési sztring használata Minden egyedi URL-címmel rendelkező kérést, beleértve a lekérdezési sztringet is, a saját gyorsítótárral rendelkező egyedi objektumként lesz kezelve.
Megadott lekérdezési sztringek figyelmen kívül hagyása A "Lekérdezési paraméterek" beállításban felsorolt kérelem URL-lekérdezési sztringek gyorsítótárazása figyelmen kívül lesz hagyva.
Megadott lekérdezési sztringek belefoglalása A kérelem URL-lekérdezési sztringjei a "Lekérdezési paraméterek" beállításban szerepelnek a gyorsítótárazáshoz.
Egyéb mezők Leírás
Dinamikus tömörítés A Front Door dinamikusan tömöríti a tartalmat a peremhálózaton, ami kisebb és gyorsabb választ eredményez.
Paraméterek lekérdezése A gyorsítótárazás alapjául szolgáló engedélyezett vagy nem engedélyezett paraméterek vesszővel tagolt listája.
A gyorsítótár alapértelmezett időtartamának használata Állítsa be az Azure Front Door alapértelmezett gyorsítótárazási időtartamát, vagy adjon meg egy gyorsítótárazási időtartamot, amely figyelmen kívül hagyja a forrásválaszról szóló irányelvet.

Következő lépések

  • Megtudhatja, hogyan konfigurálhatja az első szabálykészletet.
  • További információ a szabálykészletek egyeztetési feltételeiről.
  • További információ az Azure Front Door-szabálykészletekről.