Teilen über

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
Cachetyp 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
Dauer 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 –
Wert Der Wert, der zwischengespeichert werden soll. Richtlinienausdrücke sind zulässig. Ja –

Verwendung

Verwendungshinweise

  • Die API-Verwaltung speichert nur Antworten auf HTTP GET-Anforderungen zwischen.
  • Diese Richtlinie kann nur einmal in einem Richtlinienabschnitt verwendet werden.
  • Es wird empfohlen, eine Richtlinie für Die Rate-Limit -Richtlinie (oder eine Richtlinie mit einem Satzgrenzwert nach Schlüsseln ) unmittelbar nach jeder Cachesuche zu konfigurieren. Dadurch wird verhindert, dass Ihr Back-End-Dienst überlastet wird, wenn der Cache nicht verfügbar ist.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie die cache-store-value Richtlinie verwenden, um ein Benutzerprofil im Cache zu speichern. Der Schlüssel für den Cacheeintrag wird mithilfe eines Richtlinienausdrucks erstellt, der eine Zeichenfolge mit dem Wert der enduserid Kontextvariable kombiniert.

Sehen Sie sich ein Beispiel für einen Cache-Nachschlagewert an, um das Benutzerprofil aus dem Cache abzurufen.

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

Zugehöriger Inhalt

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier:

  • Last updated on