Érték tárolása a gyorsítótárban

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

A cache-store-value gyorsítótár-tárolást kulcs szerint végzi el. A kulcs tetszőleges sztringértékkel rendelkezhet, és általában egy szabályzatkifejezéssel adható meg.

Feljegyzés

Az értéknek a szabályzat által végrehajtott gyorsítótárban való tárolásának művelete aszinkron. A tárolt érték lekérhető a gyorsítótárszabályzat értékének lekérésével. Előfordulhat azonban, hogy a tárolt érték nem érhető el azonnal lekérésre, mivel az értéket gyorsítótárban tároló aszinkron művelet továbbra is folyamatban lehet.

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-store-value key="cache key value" value="value to cache" duration="seconds" 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
időtartam Az érték a megadott időtartamértékhez lesz gyorsítótárazva, másodpercben megadva. A szabályzatkifejezések engedélyezettek. Igen n/a
kulcs Gyorsítótárkulcs, amely alatt az érték lesz tárolva. A szabályzatkifejezések engedélyezettek. Igen n/a
Érték A gyorsítótárazandó érték. A szabályzatkifejezések 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.
  • 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 használhatja a cache-store-value szabályzatot egy felhasználói profil gyorsítótárban való tárolására. A gyorsítótár-bejegyzé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.

A felhasználói profil gyorsítótárból való lekéréséhez tekintse meg a gyorsítótár-keresési érték példáját.

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

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