Wert aus Cache abrufen
GILT FÜR: Alle API Management-Ebenen
Verwenden Sie die cache-lookup-value
-Richtlinie zum Durchführen einer Cachesuche nach Schlüssel und zum Zurückgeben eines zwischengespeicherten Werts. Der Schlüssel kann einen beliebigen Zeichenfolgenwert aufweisen und wird in der Regel über einen Richtlinienausdruck angegeben.
Hinweis
Diese Richtlinie setzt das Vorhandensein einer entsprechenden Richtlinie Wert in Cache ablegen voraus.
Wichtig
Der integrierte Cache ist flüchtig und wird von allen Einheiten in derselben Region desselben API Management-Diensts gemeinsam genutzt.
Hinweis
Legen Sie die Elemente und untergeordneten Elemente einer Richtlinie in der Reihenfolge fest, die in der Richtlinienanweisung angegeben ist. Erfahren Sie mehr darüber, wie Sie API Management-Richtlinien festlegen oder bearbeiten.
Richtlinienanweisung
<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" />
Attribute
Attribut | BESCHREIBUNG | Erforderlich | Standard |
---|---|---|---|
caching-type | Wählen Sie aus den folgenden Attributwerten: - internal zur Verwendung des integrierten API Management-Caches- external zur Verwendung des externen Caches (siehe - ),- prefer-external zur Verwendung des externen Caches (sofern konfiguriert); andernfalls wird der interne Cache verwendet.Richtlinienausdrücke sind nicht zulässig. |
Nein | prefer-external |
default-value | Ein Wert, der der Variablen zugewiesen wird, wenn die Cacheschlüsselsuche zu keinem Ergebnis führt. Wenn dieses Attribut nicht angegeben wird, wird null zugewiesen. Richtlinienausdrücke sind zulässig. |
Nein | null |
Schlüssel | In der Suche zu verwendender Cacheschlüsselwert. Richtlinienausdrücke sind zulässig. | Ja | – |
variable-name | Der Name der Kontextvariablen, der der gesuchte Wert zugewiesen wird, wenn die Suche erfolgreich ist. Wenn die Suche keinen Treffer liefert, wird die Variable nicht festgelegt. Richtlinienausdrücke sind nicht zulässig. | Ja | – |
Verwendung
- Richtlinienabschnitte: inbound, outbound, backend, on-error
- Richtlinienbereiche: global, Arbeitsbereich, Produkt, API, Vorgang
- Gateways: klassisch, v2, Verbrauch, selbstgehostet, Arbeitsbereich
Beispiel
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
Weitere Informationen und Beispiele zu dieser Richtlinie finden Sie unter Benutzerdefiniertes Caching in Azure API Management.
Verwandte Richtlinien
Zugehöriger Inhalt
Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier:
- Tutorial: Transformieren und Schützen Ihrer API
- Unter Richtlinien für die API-Verwaltung finden Sie eine komplette Liste der Richtlinienanweisungen und der zugehörigen Einstellungen.
- Richtlinienausdrücke
- Festlegen oder Bearbeiten von Richtlinien
- Wiederverwenden von Richtlinienkonfigurationen
- Repository für Richtliniencodeausschnitte
- Erstellen von Richtlinien mit Microsoft Copilot in Azure