Använda en extern Redis-kompatibel cache i Azure API Management
GÄLLER FÖR: Alla API Management-nivåer
Förutom att använda den inbyggda cachen tillåter Azure API Management cachelagring av svar i en extern Redis-kompatibel cache, till exempel Azure Cache for Redis eller Azure Managed Redis.
Med hjälp av en extern cache kan du övervinna några begränsningar i den inbyggda cachen:
- Undvika att ditt cacheminne rensas med jämna mellanrum API Management-uppdateringar
- Få mer kontroll över din cache-konfiguration
- Cachelagrade mer data än vad api Management-nivån tillåter
- Använda cachelagring med förbrukningsnivån för API Management
- Aktivera cachelagring i den lokala API Management-gatewayen
Mer detaljerad information om cachelagring finns i Principer för cachelagring för API Management och Anpassad cachelagring i Azure API Management.
Kommentar
För närvarande är den här funktionen inte tillgänglig på arbetsytor.
Detta får du får lära dig:
- Lägga till en extern cache i API Management
Förutsättningar
För att slutföra den här kursen behöver du:
Ha en Azure Cache for Redis, Azure Managed Redis eller en annan Redis-kompatibel cache tillgänglig.
Viktigt!
Azure API Management använder en Redis-anslutningssträng för att ansluta till cachen. Om du använder Azure Cache for Redis eller Azure Managed Redis aktiverar du åtkomstnyckelautentisering i cacheminnet för att använda en anslutningssträng. För närvarande kan du inte använda Microsoft Entra-autentisering för att ansluta Azure API Management till Azure Cache for Redis eller Azure Managed Redis.
Redis-cache för Kubernetes
För en lokalt installerad API Management-gateway kräver cachelagring en extern cache. För att cachelagring ska vara effektiv måste en gateway med egen värd och cachen som den förlitar sig på finnas nära varandra för att minimera svarstiderna för sökning och lagring. Att distribuera en Redis-cache till samma Kubernetes-kluster eller i ett separat kluster i närheten är de bästa alternativen. Lär dig hur du distribuerar Redis Cache till ett Kubernetes-kluster.
Lägga till en extern cache
Följ stegen nedan för att lägga till en extern Redis-kompatibel cache i Azure API Management. Du kan begränsa cachen till en specifik gateway i DIN API Management-instans.
Använd från inställning
Inställningen Använd från i konfigurationen anger platsen för din API Management-instans som ska använda cachen. Välj något av följande:
Den Azure-region där API Management-instansen finns (eller någon av de konfigurerade platserna, om du har en distribution i flera regioner )
En gatewayplats med egen värd
Standardinställningen är att konfigurera cachen som standard för alla gatewayplatser i API Management-instansen
En cache som används för Standard åsidosättas av en cache som används för en specifik matchande region eller plats.
Tänk dig till exempel en API Management-instans som finns i regionerna USA, östra, Sydostasien och Europa, västra. Det finns två konfigurerade cacheminnen, en för Standard och en för Sydostasien. I det här exemplet använder API Management i Sydostasien sin egen cache, medan de andra två regionerna använder posten Standardcache .
Kommentar
Du kan konfigurera samma externa cache för mer än en API Management-instans. API Management-instanserna kan finnas i samma eller olika regioner. När du delar cacheminnet för mer än en instans måste du välja Standard i inställningen Använd från .
Lägga till en Azure Cache for Redis- eller Azure Managed Redis-instans från samma prenumeration
- Bläddra till API Management-instansen i Azure-portalen.
- I den vänstra menyn går du till Distribution + infrastruktur och väljer Extern cache.
- Markera + Lägg till.
- I listrutan Cacheinstans väljer du din cache.
- I listrutan Använd från väljer du Standard eller anger önskad region. Anslutningssträngen fylls i automatiskt.
- Välj Spara.
Lägg till en Redis-kompatibel cache som finns utanför den aktuella Azure-prenumerationen eller Azure i allmänhet
- Bläddra till API Management-instansen i Azure-portalen.
- I den vänstra menyn går du till Distribution + infrastruktur och väljer Extern cache.
- Markera + Lägg till.
- I listrutan Cacheinstans väljer du Anpassad.
- I listrutan Använd från väljer du Standard eller anger önskad region.
- Ange din Azure Cache for Redis, Azure Managed Redis eller Redis-kompatibla cache anslutningssträng i fältet Anslutningssträng.
- Välj Spara.
Lägga till en Redis-cache i en gateway med egen värd
- I den vänstra menyn går du till Distribution + infrastruktur och väljer Extern cache.
- Markera + Lägg till.
- I listrutan Cacheinstans väljer du Anpassad.
- I listrutan Använd från väljer du Standard eller anger önskad region.
- Ange redis-cachen anslutningssträng i fältet Anslutningssträng.
- Välj Spara.
Använda den externa cachen
När du har lagt till en Redis-kompatibel cache konfigurerar du cachelagringsprinciper för att aktivera cachelagring av svar eller cachelagring av värden efter nyckel i den externa cachen.
Ett detaljerat exempel finns i Lägga till cachelagring för att förbättra prestanda i Azure API Management.
Relaterat innehåll
- Mer information om cachelagringsprinciper finns i Cachelagringsprinciper i Principreferens för API Management.
- Information om hur du cachelagrar objekt efter nyckel med hjälp av principuttryck finns i Anpassad cachelagring i Azure API Management.
- Lär dig hur du aktiverar semantisk cachelagring för Azure OpenAI-API:er.