Gyorsítótárazás hozzáadása az Azure API Management teljesítményének javításához

A Következőkre Vonatkozik: Fejlesztő | Alapszintű | Alapszintű v2 | Standard | Standard v2 | Prémium | Prémium v2 | Elkülönített

Az API Management API-jait és műveleteit a válasz gyorsítótárazásával lehet konfigurálni. A válasz-gyorsítótárazás jelentősen csökkentheti az API-hívók késését és az API-szolgáltatók háttérbeli terhelését. Ez a cikk azt ismerteti, hogyan adhat hozzá gyorsítótárazást az API-khoz.

• A gyorsítótárazás hátterével és forgatókönyveivel kapcsolatban lásd a gyorsítótárazás áttekintése című részt.
• További információ a külső gyorsítótár használatáról: Külső Redis-kompatibilis gyorsítótár használata az Azure API Managementben.
• A gyorsítótárazással kapcsolatos részletes információk: Az API Management gyorsítótárazási szabályzatai és Egyéni gyorsítótárazás az Azure API Managementben.

Fontos

A beépített gyorsítótár illékony, és az ugyanabban az API Management-példányban lévő összes egység közösen használja ugyanabban a régióban. Függetlenül a használt gyorsítótár típusától (belső vagy külső), ha a gyorsítótárral kapcsolatos műveletek nem csatlakoznak a gyorsítótárhoz a gyorsítótár ingadozása vagy más okból, a gyorsítótárhoz kapcsolódó műveletet használó API-hívás nem okoz hibát, és a gyorsítótár-művelet sikeresen befejeződik. Olvasási művelet esetén a rendszer null értéket ad vissza a hívószabályzat kifejezésének. A szabályzatkódot úgy kell megtervezni, hogy legyen tartalék mechanizmus a gyorsítótárban nem található adatok lekérésére.

Ebben a cikkben a következőt találja:

• Válaszok gyorsítótárazásának hozzáadása az API esetében
• Ellenőrizze, hogy működik-e a gyorsítótárazás

Feljegyzés

A belső gyorsítótárazás nem érhető el az Azure API Management használati szintjén. Ehelyett használhat külső Azure Cache for Redist. Külső gyorsítótárat más API Management szolgáltatási szinteken is konfigurálhat.

Előfeltételek

• Azure API Management-példány létrehozása
• API importálása és közzététele

Gyorsítótárazási szabályzatok hozzáadása

A példában bemutatott gyorsítótárazási szabályokkal a teszt művelet első kérése a háttérrendszer válaszát adja vissza. Ez a válasz gyorsítótárazva lesz, és egy kulccsal lesz ellátva a megadott fejlécek és lekérdezési sztring paraméterek alapján. A művelet későbbi, egyező paraméterekkel rendelkező hívásai a gyorsítótárazott választ adják vissza, amíg a gyorsítótár időtartama lejár.

1. Jelentkezzen be az Azure Portalra.

2. Nyissa meg az API Management-példányt.

3. Válassza ki az API-kat> az a bal oldali menüben.

4. Válasszon ki egy API-t, amelyhez gyorsítótárazást szeretne konfigurálni.

5. A képernyő tetején válassza a Tervezés lapot.

6. A Bejövő feldolgozás szakaszban válassza a </> ikont:

   

7. Az elemben inbound adja hozzá a következő szabályzatot:

   <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>
   <rate-limit calls="10" renewal-period="60" />
   

   Feljegyzés

   Adjon hozzá egy sebességkorlát-szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot) a gyorsítótár-keresés után, hogy korlátozza a hívások számát, és megakadályozza a háttérszolgáltatás túlterhelését abban az esetben, ha a gyorsítótár nem érhető el.

8. Az elemben outbound adja hozzá a következő szabályzatot:

   <cache-store duration="20" />
   

   Ebben a házirendben duration a gyorsítótárazott válaszok lejárati időközét adja meg. Az intervallum 20 másodperc.

9. Válassza az Mentésgombot.

Tipp.

Ha külső gyorsítótárat használ, a Külső Redis-kompatibilis gyorsítótár használata az Azure API Managementben című cikkben leírtak szerint célszerű megadni a caching-type gyorsítótárazási szabályzatok attribútumát. További információkért tekintse meg az API Management gyorsítótárazási szabályzatát .

Művelet meghívása a gyorsítótárazás teszteléséhez

A gyorsítótárazás teszteléséhez hívjon meg egy műveletet a portálon.

1. Az Azure Portalon nyissa meg az API Management-példányt.
2. Válassza ki az API-kat> az a bal oldali menüben.
3. Válassza ki az API-t, amelyhez gyorsítótárazási házirendeket adott hozzá.
4. Válasszon ki egy tesztelni kívánt műveletet.
5. Válassza az ablak tetején található Teszt fület.
6. Válassza a Nyomkövetés lehetőséget két vagy három alkalommal gyors egymás után.
7. A HTTP-válasz területen válassza a Nyomkövetés lapot.
8. Ugorjon a bejövő szakaszra, és görgessen a cache-lookup szabályzathoz. Az alábbi képernyőképen láthatóhoz hasonló üzenetnek kell megjelennie, amely egy

Kapcsolódó tartalom

• További információt a gyorsítótárazási házirendekről az API Management házirend-referencia oktatóanyag Gyorsítótárazási házirendek szakaszában talál.
• Az elemek kulcs szerinti gyorsítótárazásával kapcsolatos információkért tekintse meg az Egyéni gyorsítótárazás az Azure API Managementben című témakört.
• További információ a külső Azure Cache for Redis vagy az Azure Managed Redis használatáról: Külső Redis-kompatibilis gyorsítótár használata az Azure API Managementben.