Dela via


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:

  • Skapa en Azure API Management-instans

  • Förstå cachelagring i Azure API Management

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

Skärmbild som visar hur du lägger till en extern Azure Cache for Redis i Azure API Management.

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

  1. Bläddra till API Management-instansen i Azure-portalen.
  2. I den vänstra menyn går du till Distribution + infrastruktur och väljer Extern cache.
  3. Markera + Lägg till.
  4. I listrutan Cacheinstans väljer du din cache.
  5. I listrutan Använd från väljer du Standard eller anger önskad region. Anslutningssträngen fylls i automatiskt.
  6. Välj Spara.

Lägg till en Redis-kompatibel cache som finns utanför den aktuella Azure-prenumerationen eller Azure i allmänhet

  1. Bläddra till API Management-instansen i Azure-portalen.
  2. I den vänstra menyn går du till Distribution + infrastruktur och väljer Extern cache.
  3. Markera + Lägg till.
  4. I listrutan Cacheinstans väljer du Anpassad.
  5. I listrutan Använd från väljer du Standard eller anger önskad region.
  6. Ange din Azure Cache for Redis, Azure Managed Redis eller Redis-kompatibla cache anslutningssträng i fältet Anslutningssträng.
  7. Välj Spara.

Lägga till en Redis-cache i en gateway med egen värd

  1. I den vänstra menyn går du till Distribution + infrastruktur och väljer Extern cache.
  2. Markera + Lägg till.
  3. I listrutan Cacheinstans väljer du Anpassad.
  4. I listrutan Använd från väljer du Standard eller anger önskad region.
  5. Ange redis-cachen anslutningssträng i fältet Anslutningssträng.
  6. 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.