Teilen ü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
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
Standardwert 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 –
Variablenname 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

Verwendungshinweise

  • Die API-Verwaltung speichert nur Antworten auf HTTP GET-Anforderungen zwischen.
  • Diese Richtlinie kann nur einmal in einem Richtlinienabschnitt verwendet werden.
  • Diese Richtlinie wird in einem Richtlinienfragment nicht unterstützt.
  • 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 mithilfe der cache-lookup-value Richtlinie ein Benutzerprofil aus dem Cache abrufen. Der Schlüssel für die Cachesuche wird mithilfe eines Richtlinienausdrucks erstellt, der eine Zeichenfolge mit dem Wert der enduserid Kontextvariable kombiniert.

Hinweis

Fügen Sie nach der Cache-Suche eine Rate-Limit-Policy (oder Rate-Limit-by-Key-Policy ) hinzu, um die Anzahl der Anrufe zu begrenzen und Überlastung des Backend-Services zu vermeiden, falls der Cache nicht verfügbar ist.

Sehen Sie sich ein Beispiel für einen Cachespeicherwert an, um das Benutzerprofil im Cache zu speichern.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

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