Hämta värde från cache
GÄLLER FÖR: Alla API Management-nivåer
cache-lookup-value
Använd principen för att utföra cachesökning efter nyckel och returnera ett cachelagrat värde. Nyckeln kan ha ett godtyckligt strängvärde och tillhandahålls vanligtvis med hjälp av ett principuttryck.
Kommentar
Den här principen måste ha ett motsvarande Store-värde i cacheprincipen .
Viktigt!
Den inbyggda cachen är instabil och delas av alla enheter i samma region i samma API Management-tjänst.
Kommentar
Ange principens element och underordnade element i den ordning som anges i principbeskrivningen. Läs mer om hur du anger eller redigerar API Management-principer.
Principuttryck
<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" />
Attribut
Attribut | beskrivning | Obligatoriskt | Standardvärde |
---|---|---|---|
cachelagringstyp | Välj mellan följande värden för attributet: - internal för att använda den inbyggda API Management-cachen,- external för att använda den externa cachen enligt beskrivningen i Använda en extern Azure Cache for Redis i Azure API Management,- prefer-external för att använda extern cache om det är konfigurerat eller internt cacheminne på annat sätt.Principuttryck tillåts inte. |
Nej | prefer-external |
standardvärde | Ett värde som tilldelas variabeln om cachenyckelsökningen resulterade i en miss. Om det här attributet inte har angetts null tilldelas. Principuttryck tillåts. |
Nej | null |
key | Cachenyckelvärde som ska användas i sökningen. Principuttryck tillåts. | Ja | Ej tillämpligt |
variabelnamn | Namnet på kontextvariabeln som uppslagsvärdet tilldelas till, om sökningen lyckas. Om sökningen resulterar i en miss anges inte variabeln. Principuttryck tillåts inte. | Ja | Ej tillämpligt |
Användning
- Principavsnitt: inkommande, utgående, serverdel, on-error
- Principomfattningar: global, arbetsyta, produkt, API, åtgärd
- Gatewayer: klassisk, v2, förbrukning, lokalt installerad, arbetsyta
Exempel
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
Mer information och exempel på den här principen finns i Anpassad cachelagring i Azure API Management.
Relaterade principer
Relaterat innehåll
Mer information om hur du arbetar med principer finns i:
- Självstudie: Transformera och skydda ditt API
- Principreferens för en fullständig lista över principinstruktioner och deras inställningar
- Principuttryck
- Ange eller redigera principer
- Återanvända principkonfigurationer
- Lagringsplats för principfragment
- Skapa principer med Microsoft Copilot i Azure