Freigeben über


Hinzufügen der Zwischenspeicherung zum Verbessern der Leistung in Azure API Management

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.

Screenshot, der Cacherichtlinien in der API-Verwaltung zeigt.

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.

  1. Melden Sie sich beim Azure-Portal an.

  2. Wechseln Sie zu Ihrer API-Verwaltungsinstanz.

  3. Wählen Sie im Menü auf der linken Seite APIs>APIs aus.

  4. Wählen Sie eine API aus, für die Sie die Zwischenspeicherung konfigurieren möchten.

  5. Wählen Sie oben auf dem Bildschirm die Registerkarte " Entwurf " aus.

  6. Wählen Sie im Abschnitt "Eingehende Verarbeitung " das </> -Symbol aus:

    Screenshot der API-Verwaltungs-APIs im Portal.

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

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

  1. Wechseln Sie im Azure-Portal zu Ihrer API-Verwaltungsinstanz.
  2. Wählen Sie im Menü auf der linken Seite APIs>APIs aus.
  3. Wählen Sie die API aus, der Sie Zwischenspeicherungsrichtlinien hinzugefügt haben.
  4. Wählen Sie einen Vorgang aus, den Sie testen möchten.
  5. Wählen Sie oben im Fenster die Registerkarte "Test " aus.
  6. Wählen Sie zwei- oder dreimal hintereinander Ablaufverfolgung aus.
  7. Wählen Sie unter HTTP-Antwort die Registerkarte Ablaufverfolgung aus.
  8. 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: Screenshot einer Cachesuche beim Testen einer API im Portal