Waarde ophalen uit cache

  • Artikel
  • 2 minuten om te lezen

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 meestal opgegeven met behulp van een beleidsexpressie.

Notitie

Dit beleid moet een overeenkomstige waarde voor Opslaan in cache hebben.

Belangrijk

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

Notitie

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

Beleidsverklaring

<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 Standaard
caching-type Kies tussen de volgende waarden van het kenmerk:
- internalom 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 is geconfigureerd of interne cache anders.

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

Gebruik

Voorbeeld

<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.

Volgende stappen

Zie voor meer informatie over het werken met beleid: