Freigeben über


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

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.

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier: