Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
GILT FÜR: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2 | Isoliert
APIs und Vorgänge in API Management können mit dem Zwischenspeichern von Antworten konfiguriert werden. Das Zwischenspeichern von Antworten kann die Latenzzeit für API-Aufrufer und die Back-End-Auslastung für API-Anbieter bedeutend reduzieren. In diesem Artikel wird beschrieben, wie Sie Ihren APIs Zwischenspeicherung hinzufügen.
Wichtig
Der integrierte Cache ist veränderlich und wird von allen Einheiten in derselben Region in derselben API-Verwaltungsinstanz gemeinsam genutzt. Unabhängig vom verwendeten Cachetyp (intern oder extern), wenn cachebezogene Vorgänge aufgrund der Volatilität des Caches oder aus einem anderen Grund keine Verbindung mit dem Cache herstellen können, löst der API-Aufruf, der den cachebezogenen Vorgang verwendet, keinen Fehler aus, und der Cachevorgang wird erfolgreich abgeschlossen. Bei einem Lesevorgang wird ein NULL-Wert an den aufrufenden Richtlinienausdruck zurückgegeben. Ihr Richtliniencode sollte so konzipiert sein, dass es einen Fallbackmechanismus zum Abrufen von Daten gibt, die nicht im Cache gefunden werden.
Ausführlichere Informationen zum Zwischenspeichern finden Sie unter Richtlinien für API Management-Zwischenspeichern sowie unter Benutzerdefiniertes Zwischenspeichern in Azure API Management.
In diesem Artikel führen Sie folgende Schritte aus:
- Hinzufügen des Zwischenspeicherns von Antworten für Ihre API
- Überprüfen, ob zwischenspeichern funktioniert
Hinweis
Die interne Zwischenspeicherung ist in der Nutzungsebene der Azure-API-Verwaltung nicht verfügbar. Sie können stattdessen eine externe Azure Cache for Redis-Instanz verwenden. Sie können auch einen externen Cache in anderen API Management-Dienstebenen konfigurieren.
Voraussetzungen
Hinzufügen von Zwischenspeicherungsrichtlinien
Mit den in diesem Beispiel gezeigten Zwischenspeicherungsrichtlinien gibt die erste Anforderung an einen Testvorgang eine Antwort vom Back-End-Dienst zurück. Diese Antwort wird zwischengespeichert und erhält einen Schlüssel, der auf den angegebenen Headern und Abfrageparametern basiert. Nachfolgende Aufrufe des Vorgangs mit übereinstimmenden Parametern geben die zwischengespeicherte Antwort zurück, bis das Cachedauerintervall abläuft.
Melden Sie sich beim Azure-Portal an.
Wechseln Sie zu Ihrer API-Verwaltungsinstanz.
Wählen Sie im Menü auf der linken Seite APIs>APIs aus.
Wählen Sie eine API aus, für die Sie die Zwischenspeicherung konfigurieren möchten.
Wählen Sie oben auf dem Bildschirm die Registerkarte " Entwurf " aus.
Wählen Sie im Abschnitt "Eingehende Verarbeitung " das </> -Symbol aus:
Fügen Sie im
inbound
-Element die folgende Richtlinie hinzu:<cache-lookup vary-by-developer="false" vary-by-developer-groups="false"> <vary-by-header>Accept</vary-by-header> <vary-by-header>Accept-Charset</vary-by-header> <vary-by-header>Authorization</vary-by-header> </cache-lookup>
Fügen Sie im
outbound
-Element die folgende Richtlinie hinzu:<cache-store duration="20" />
Gibt in dieser Richtlinie
duration
das Ablaufintervall der zwischengespeicherten Antworten an. Das Intervall beträgt 20 Sekunden.Wählen Sie Speichern aus.
Tipp
Wenn Sie einen externen Cache verwenden, wie unter "Verwenden eines externen Azure-Caches für Redis in Azure API Management" beschrieben, können Sie das caching-type
Attribut der Cacherichtlinien angeben. Weitere Informationen finden Sie unter API-Verwaltungszwischenspeicherungsrichtlinien .
Aufrufen eines Vorgangs zum Testen der Zwischenspeicherung
Rufen Sie zum Testen der Zwischenspeicherung einen Vorgang im Portal auf.
- Wechseln Sie im Azure-Portal zu Ihrer API-Verwaltungsinstanz.
- Wählen Sie im Menü auf der linken Seite APIs>APIs aus.
- Wählen Sie die API aus, der Sie Zwischenspeicherungsrichtlinien hinzugefügt haben.
- Wählen Sie einen Vorgang aus, den Sie testen möchten.
- Wählen Sie oben im Fenster die Registerkarte "Test " aus.
- Wählen Sie zwei- oder dreimal hintereinander Ablaufverfolgung aus.
- Wählen Sie unter HTTP-Antwort die Registerkarte Ablaufverfolgung aus.
- Wechseln Sie zum Abschnitt Eingehend, und scrollen Sie zur Richtlinie
cache-lookup
. Es sollte eine Meldung ähnlich der im folgenden Screenshot angezeigt werden, die einen Cachetreffer anzeigt:
Zugehöriger Inhalt
- Weitere Informationen zu Richtlinien für die Zwischenspeicherung finden Sie unter Richtlinien für die Zwischenspeicherung in der Richtlinienreferenz für API Management.
- Informationen zum Zwischenspeichern von Elementen nach Schlüssel mithilfe von Richtlinienausdrücken finden Sie unter "Benutzerdefiniertes Zwischenspeichern in Azure API Management".
- Weitere Informationen zur Verwendung einer externen Azure Cache for Redis- oder Azure Managed Redis-Instanz finden Sie unter Verwenden einer externen Azure Cache for Redis-Instanz in Azure API Management.