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,- external om 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
- Beleidssecties: inkomende, uitgaande, back-end, on-error
- Beleidsbereik: globaal, werkruimte, product, API, bewerking
- Gateways: klassiek, v2, verbruik, zelf-hostend, werkruimte
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.
Gerelateerd beleid
Gerelateerde inhoud
Zie voor meer informatie over het werken met beleid:
- Zelfstudie: Uw API transformeren en beveiligen
- Beleidsreferentie voor een volledige lijst met beleidsinstructies en hun instellingen
- Beleidsexpressies
- Beleid instellen of bewerken
- Beleidsconfiguraties opnieuw gebruiken
- Beleidsfragmentenopslagplaats
- Beleid ontwerpen met Behulp van Microsoft Copilot in Azure