Wert in Cache ablegen
GILT FÜR: Alle API Management-Ebenen
cache-store-value
führt die Cachespeicherung nach Schlüssel durch. Der Schlüssel kann einen beliebigen Zeichenfolgenwert aufweisen und wird in der Regel über einen Richtlinienausdruck angegeben.
Hinweis
Der von dieser Richtlinie ausgeführte Vorgang zum Speichern des Werts im Cache ist asynchron. Der gespeicherte Wert kann mithilfe der Richtlinie Wert aus Cache abrufen abgerufen werden. Der gespeicherte Wert ist jedoch möglicherweise nicht sofort für den Abruf verfügbar, da der asynchrone Vorgang, mit dem der Wert im Cache gespeichert wird, möglicherweise noch ausgeführt wird.
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-store-value key="cache key value" value="value to cache" duration="seconds" 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 |
duration | Der Wert wird für die in Sekunden angegebene Dauer zwischengespeichert. Richtlinienausdrücke sind zulässig. | Ja | – |
Schlüssel | Der Cacheschlüssel, unter dem der Wert gespeichert wird. Richtlinienausdrücke sind zulässig. | Ja | – |
value | Der Wert, der zwischengespeichert werden soll. Richtlinienausdrücke sind zulässig. | Ja | – |
Verwendung
- Richtlinienabschnitte: inbound, outbound, backend, on-error
- Richtlinienbereiche: global, Arbeitsbereich, Produkt, API, Vorgang
- Gateways: klassisch, v2, Verbrauch, selbstgehostet, Arbeitsbereich
Beispiel
<cache-store-value
key="@("userprofile-" + context.Variables["enduserid"])"
value="@((string)context.Variables["userprofile"])" duration="100000" />
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