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

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

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

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.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "originGroupOverride": {
      "originGroup": {
        "id": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup"
      },
      "forwardingProtocol": "MatchRequest"
    },
    "cacheConfiguration": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    originGroupOverride: {
      originGroup: {
        id: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup'
      }
      forwardingProtocol: 'MatchRequest'
    }
    cacheConfiguration: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IncludeSpecifiedQueryStrings",
      "queryParameters": "customerId",
      "isCompressionEnabled": "Enabled",
      "cacheBehavior": "HonorOrigin",
      "cacheDuration": null
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IncludeSpecifiedQueryStrings'
      queryParameters: 'customerId'
      isCompressionEnabled: 'Enabled'
      cacheBehavior: 'HonorOrigin'
      cacheDuration: null
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IgnoreQueryString",
      "cacheBehavior": "OverrideIfOriginMissing",
      "cacheDuration": "0.06:00:00",
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IgnoreQueryString'
      cacheBehavior: 'OverrideIfOriginMissing'
      cacheDuration: '0.06:00:00'
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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

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

{
  "name": "ModifyRequestHeader",
  "parameters": {
    "headerAction": "Append",
    "headerName": "MyRequestHeader",
    "value": "AdditionalValue",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyRequestHeader'
  parameters: {
    headerAction: 'Append'
    headerName: 'MyRequestHeader'
    value: 'AdditionalValue'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

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

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.

{
  "name": "ModifyResponseHeader",
  "parameters": {
    "headerAction": "Delete",
    "headerName": "X-Powered-By",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyResponseHeader'
  parameters: {
    headerAction: 'Delete'
    headerName: 'X-Powered-By'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

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. Az Azure Front Door támogatja az URL-elérési út dinamikus rögzítését kiszolgálóváltozóval {url_path:seg#} , és az URL-elérési utat kisbetűssé vagy nagybetűssé {url_path.tolower}{url_path.toupper}alakítja. További információ: Kiszolgálóváltozók.

Tulajdonságok

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.

{
  "name": "UrlRedirect",
  "parameters": {
    "redirectType": "TemporaryRedirect",
    "destinationProtocol": "Https",
    "customHostname": "contoso.com",
    "customPath": "/exampleredirection",
    "customQueryString": "clientIp={client_ip}",
    "typeName": "DeliveryRuleUrlRedirectActionParameters"
  }
}

{
  name: 'UrlRedirect'
  parameters: {
    redirectType: 'TemporaryRedirect'
    destinationProtocol: 'Https'
    customHostname: 'contoso.com'
    customPath: '/exampleredirection'
    customQueryString: 'clientIp={client_ip}'
    typeName: 'DeliveryRuleUrlRedirectActionParameters'
  }
}

URL-átírás

Az URL-átírási művelettel átírhatja a forráshoz vezető kérés útvonalát. Az Azure Front Door támogatja az URL-elérési út dinamikus rögzítését kiszolgálóváltozóval {url_path:seg#} , és az URL-elérési utat kisbetűssé vagy nagybetűssé {url_path.tolower}{url_path.toupper}alakítja. További információ: Kiszolgálóváltozók.

Tulajdonságok

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.

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": false,
    "typeName": "DeliveryRuleUrlRewriteActionParameters"
  }
}

{
  name: 'UrlRewrite'
  parameters: {
    sourcePattern: '/'
    destination: '/redirection'
    preserveUnmatchedPath: false
    typeName: 'DeliveryRuleUrlRewriteActionParameters'
  }
}

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

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

Ú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

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

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.

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: