Delen via

Waarde opslaan in cache

VAN TOEPASSING OP: Alle API Management-lagen

De cache-store-value cacheopslag wordt uitgevoerd op sleutel. De sleutel kan een willekeurige tekenreekswaarde hebben en wordt doorgaans opgegeven met behulp van een beleidsexpressie.

Notitie

Het opslaan van de waarde in de cache die door dit beleid wordt uitgevoerd, is asynchroon. De opgeslagen waarde kan worden opgehaald met behulp van waarde ophalen uit cachebeleid . De opgeslagen waarde is echter mogelijk niet direct beschikbaar voor het ophalen, omdat de asynchrone bewerking waarin de waarde in de cache wordt opgeslagen, nog steeds wordt uitgevoerd.

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-store-value key="cache key value" value="value to cache" duration="seconds" 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
duur De waarde wordt in de cache opgeslagen voor de opgegeven duurwaarde, opgegeven in seconden. Beleidsexpressies zijn toegestaan. Ja N.v.t.
sleutel Cachesleutel waaronder de waarde wordt opgeslagen. Beleidsexpressies zijn toegestaan. Ja N.v.t.
waarde De waarde die in de cache moet worden opgeslagen. Beleidsexpressies zijn 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.
  • 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-store-value beleid gebruikt om een gebruikersprofiel op te slaan in de cache. De sleutel voor de cachevermelding wordt samengesteld met behulp van een beleidsexpressie die een tekenreeks combineert met de waarde van de enduserid contextvariabele.

Bekijk een voorbeeld van een cachezoekwaarde om het gebruikersprofiel op te halen uit de cache.

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

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: