Érték lekérése a gyorsítótárból

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

cache-lookup-value A szabályzat használatával kulccsal végezhet gyorsítótárkeresést, és visszaadhat egy gyorsítótárazott értéket. A kulcs tetszőleges sztringértékkel rendelkezhet, és általában egy szabályzatkifejezéssel adható meg.

Feljegyzés

Ennek a szabályzatnak megfelelő Tárolási értékkel kell rendelkeznie a gyorsítótár-házirendben .

Fontos

A beépített gyorsítótár változékony, és az ugyanabban a régióban lévő összes egység megosztja ugyanabban az API Management szolgáltatásban.

Feljegyzés

Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.

Szabályzatutasítás

<cache-lookup-value key="cache key value"
    default-value="value to use if cache lookup resulted in a miss"
    variable-name="name of a variable looked up value is assigned to"
    caching-type="prefer-external | external | internal" />

Attribútumok

Attribútum Leírás Kötelező Alapértelmezett
gyorsítótárazás típusa Válasszon az attribútum alábbi értékei közül:
- internal a beépített API Management-gyorsítótár használatához,
- external a külső gyorsítótár használata a külső Redis-kompatibilis gyorsítótár használata az Azure API Managementben című cikkben leírtak szerint,
- prefer-external külső gyorsítótár használata, ha konfigurálva van, vagy ha a belső gyorsítótár másként van beállítva.

A szabályzatkifejezések nem engedélyezettek.		 Nem prefer-external
alapértelmezett érték Olyan érték, amely akkor lesz hozzárendelve a változóhoz, ha a gyorsítótárkulcs-keresés hibás eredményt eredményezett. Ha ez az attribútum nincs megadva, null a rendszer hozzárendeli. A szabályzatkifejezések engedélyezettek. Nem null
kulcs A keresésben használandó gyorsítótárkulcs-érték. A szabályzatkifejezések engedélyezettek. Igen n/a
változónév Annak a környezeti változónak a neve, amelyhez a keresett érték hozzá lesz rendelve, ha a keresés sikeres. Ha a keresés nem jelenik meg, a változó nem lesz beállítva. A szabályzatkifejezések nem engedélyezettek. Igen n/a

Használat

Használati megjegyzések

  • Az API Management csak a HTTP GET-kérelmekre adott válaszokat gyorsítótárazza.
  • Ez a szabályzat csak egyszer használható egy szabályzatszakaszban.
  • Ez a szabályzat nem támogatott egy szabályzattöredékben.
  • Javasoljuk, hogy a gyorsítótár-keresés után azonnal konfiguráljon egy sebességkorlátozó szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot). Ez segít abban, hogy a háttérszolgáltatás túlterhelt legyen, ha a gyorsítótár nem érhető el.

Példa

Ez a példa bemutatja, hogyan lehet a cache-lookup-value szabályzat használatával lekérni egy felhasználói profilt a gyorsítótárból. A gyorsítótár-keresés kulcsa egy olyan szabályzatkifejezéssel jön létre, amely egy sztringet kombinál a enduserid környezeti változó értékével.

Feljegyzés

Adjon hozzá egy sebességkorlát-szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot) a gyorsítótár-keresés után, hogy korlátozza a hívások számát, és megakadályozza a háttérszolgáltatás túlterhelését abban az esetben, ha a gyorsítótár nem érhető el.

A felhasználói profil gyorsítótárban való tárolásához tekintse meg a gyorsítótár-tároló érték példáját.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

A szabályzatra vonatkozó további információkért és példákért lásd : Egyéni gyorsítótárazás az Azure API Managementben.

Kapcsolódó tartalom

A szabályzatok használatával kapcsolatos további információkért lásd:

  • Last updated on