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

Opmerking

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />

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

Zie voor meer informatie over het werken met beleid: