Een externe Redis-compatibele cache gebruiken in Azure API Management

VAN TOEPASSING OP: Alle API Management-lagen

Naast het gebruik van de ingebouwde cache kunt u met Azure API Management antwoorden opslaan in een externe redis-compatibele cache, zoals Azure Cache voor Redis of Azure Managed Redis.

Met behulp van een externe cache kunt u enkele beperkingen van de ingebouwde cache overwinnen:

• Als u wilt vermijden dat uw cache periodiek wordt gewist tijdens het bijwerken van API Management
• Als u meer controle wilt over de configuratie van uw cache
• Meer gegevens opslaan in de cache dan uw API Management-laag toestaat
• Als u opslag in de cache wilt gebruiken met de laag Verbruik van API Management
• Caching inschakelen in de zelf-hostende gateway van API Management

Zie de beleidsregels voor API Management-caching en Aangepaste caching in Azure API Management voor meer informatie over caching.

Notitie

Deze functie is momenteel niet beschikbaar in werkruimten.

Wat u leert:

• Een externe cache toevoegen in API Management

Vereisten

Voor het voltooien van deze zelfstudie hebt u het volgende nodig:

• Een Azure API Management-exemplaar maken

• Inzicht in Aangepast opslaan in cache in Azure API Management

• Er is een Azure Cache voor Redis, Azure Managed Redis of een andere met Redis compatibele cache beschikbaar.

  Belangrijk

  Azure API Management maakt gebruik van een Redis-verbindingsreeks om verbinding te maken met de cache. Als u Azure Cache voor Redis of Azure Managed Redis gebruikt, schakelt u verificatie van de toegangssleutel in uw cache in om een verbindingsreeks te gebruiken. Momenteel kunt u Microsoft Entra-verificatie niet gebruiken om Azure API Management te verbinden met Azure Cache voor Redis of Azure Managed Redis.

Redis-cache voor Kubernetes

Voor een zelf-hostende gateway van API Management is voor caching een externe cache vereist. Om caching effectief te maken, moet een zelf-hostende gateway en de cache waarop deze is gebaseerd zich dicht bij elkaar bevinden om opzoek- en opslaglatenties te minimaliseren. Het implementeren van een Redis-cache in hetzelfde Kubernetes-cluster of in een afzonderlijk cluster in de buurt zijn de beste opties. Meer informatie over het implementeren van Redis-cache in een Kubernetes-cluster.

Een externe cache toevoegen

Volg de onderstaande stappen om een externe redis-compatibele cache toe te voegen in Azure API Management. U kunt de cache beperken tot een specifieke gateway in uw API Management-exemplaar.

Gebruiken vanuit instelling

Met de instelling Gebruiken in de configuratie geeft u de locatie op van uw API Management-exemplaar dat de cache gebruikt. Selecteer een van de volgende opties:

• De Azure-regio waar het API Management-exemplaar wordt gehost (of een van de geconfigureerde locaties, als u een implementatie met meerdere regio's hebt)

• Een zelf-hostende gatewaylocatie

• Standaard: als u de cache wilt configureren als de standaardinstelling voor alle gatewaylocaties in het API Management-exemplaar

  Een cache die wordt gebruikt voor Standaard , wordt overschreven door een cache die wordt gebruikt voor een specifieke overeenkomende regio of locatie.

  Denk bijvoorbeeld aan een API Management-exemplaar dat wordt gehost in de regio's VS - oost, Azië - zuidoost en Europa - west. Er zijn twee caches geconfigureerd, één voor Standaard en één voor Azië - zuidoost. In dit voorbeeld gebruikt API Management in Zuidoost-Azië een eigen cache, terwijl in de andere twee regio's de standaardcachevermelding wordt gebruikt.

Notitie

U kunt dezelfde externe cache configureren voor meer dan één API Management-exemplaar. De API Management-exemplaren kunnen zich in dezelfde of verschillende regio's bevinden. Wanneer u de cache voor meer dan één exemplaar deelt, moet u Standaard selecteren in de instelling Gebruiken.

Een Azure Cache voor Redis- of Azure Managed Redis-exemplaar toevoegen vanuit hetzelfde abonnement

1. Blader naar uw API Management-exemplaar in de Azure-portal.
2. Selecteer in het linkermenu onder Implementatie en infrastructuur externe cache.
3. Selecteer + Toevoegen.
4. Selecteer uw cache in de vervolgkeuzelijst Cache-exemplaar .
5. Selecteer in de vervolgkeuzelijst Gebruiken de optie Standaard of geef de gewenste regio op. De verbindingsreeks wordt automatisch ingevuld.
6. Selecteer Opslaan.

Een redis-compatibele cache toevoegen die buiten het huidige Azure-abonnement of Azure in het algemeen wordt gehost

1. Blader naar uw API Management-exemplaar in de Azure-portal.
2. Selecteer in het linkermenu onder Implementatie en infrastructuur externe cache.
3. Selecteer + Toevoegen.
4. Selecteer Aangepast in de vervolgkeuzelijst Cache-exemplaar.
5. Selecteer in de vervolgkeuzelijst Gebruiken de optie Standaard of geef de gewenste regio op.
6. Voer uw Azure Cache voor Redis, Azure Managed Redis of Redis-compatibele cache in verbindingsreeks in het veld Verbindingsreeks.
7. Selecteer Opslaan.

Een Redis-cache toevoegen aan een zelf-hostende gateway

1. Selecteer in het linkermenu onder Implementatie en infrastructuur externe cache.
2. Selecteer + Toevoegen.
3. Selecteer Aangepast in de vervolgkeuzelijst Cache-exemplaar.
4. Selecteer in de vervolgkeuzelijst Gebruiken de optie Standaard of geef de gewenste regio op.
5. Voer uw Redis-cache in verbindingsreeks in het veld Verbindingsreeks.
6. Selecteer Opslaan.

De externe cache gebruiken

Nadat u een redis-compatibele cache hebt toegevoegd, configureert u cachebeleid voor het inschakelen van reactiecaching of het opslaan van waarden per sleutel in de externe cache.

Zie Caching toevoegen voor een gedetailleerd voorbeeld om de prestaties in Azure API Management te verbeteren.

Gerelateerde inhoud

• Zie Cachebeleidsregels in Naslaginformatie over beleid voor API Management voor meer informatie over cachebeleidsregels.
• Zie Aangepaste cache in Azure API Management om items op te cachen met behulp van beleidsexpressies.
• Meer informatie over het inschakelen van semantische caching voor Azure OpenAI-API's.