Share via

Waarde ophalen uit cache

VAN TOEPASSING OP: Alle API Management-lagen

Gebruik het cache-lookup-value beleid om cachezoekacties op sleutel uit te voeren en een waarde in de cache te retourneren. De sleutel kan een willekeurige tekenreekswaarde hebben en wordt doorgaans opgegeven met behulp van een beleidsexpressie.

Notitie

Dit beleid moet een overeenkomende Store-waarde hebben in cachebeleid .

Belangrijk

De ingebouwde cache is vluchtig en wordt gedeeld door alle eenheden in dezelfde regio in dezelfde API Management-service.

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

<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" />

Kenmerken

Kenmerk Beschrijving Vereist Standaardinstelling
caching-type Kies tussen de volgende waarden van het kenmerk:
- internal om de ingebouwde API Management-cache te gebruiken,
- externalom de externe cache te gebruiken zoals beschreven in Een externe Azure Cache voor Redis gebruiken in Azure API Management,
- prefer-external om externe cache te gebruiken als deze anders is geconfigureerd of interne cache.

Beleidsexpressies zijn niet toegestaan.		 Nee prefer-external
standaardwaarde Een waarde die wordt toegewezen aan de variabele als het opzoeken van de cachesleutel een misser heeft opgeleverd. Als dit kenmerk niet is opgegeven, null wordt deze toegewezen. Beleidsexpressies zijn toegestaan. Nee null
sleutel Cachesleutelwaarde die moet worden gebruikt in de zoekactie. Beleidsexpressies zijn toegestaan. Ja N.v.t.
naam van variabele De naam van de contextvariabele waaraan de opgezoekwaarde wordt toegewezen, als de zoekactie is geslaagd. Als het opzoeken resulteert in een misser, wordt de variabele niet ingesteld. Beleidsexpressies zijn niet toegestaan. Ja N.v.t.

Gebruik

Gebruiksnotities

  • API Management slaat alleen reacties op HTTP GET-aanvragen in de cache op.
  • Dit beleid kan slechts eenmaal worden gebruikt in een beleidssectie.
  • Dit beleid wordt niet ondersteund in een beleidsfragment.
  • U wordt aangeraden een beleid voor frequentielimiet (of beleid voor frequentielimiet per sleutel ) onmiddellijk na een cachezoekactie te configureren. Dit helpt ervoor te zorgen dat uw back-endservice overbelast raakt als de cache niet beschikbaar is.

Opmerking

In dit voorbeeld ziet u hoe u het cache-lookup-value beleid gebruikt om een gebruikersprofiel op te halen uit de cache. De sleutel voor het opzoeken van de cache wordt samengesteld met behulp van een beleidsexpressie die een tekenreeks combineert met de waarde van de enduserid contextvariabele.

Notitie

Het beleid voor frequentielimiet dat is toegevoegd nadat de cachezoekactie heeft toegevoegd, helpt het aantal aanroepen te beperken om te voorkomen dat de back-endservice overbelast raakt als de cache niet beschikbaar is.

Bekijk een voorbeeld van een cache-store-waarde om het gebruikersprofiel in de cache op te slaan.

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

Zie Aangepaste caching in Azure API Management voor meer informatie en voorbeelden van dit beleid.

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: