Přidání ukládání do mezipaměti ke zlepšení výkonu služby Azure API Management

PLATÍ PRO: Vývojář | Základní | Basic v2 | Standardní | Standard v2 | Premium | Premium v2 | Izolovaný

Rozhraní API a operace ve službě API Management je možné nakonfigurovat pomocí ukládání odpovědí do mezipaměti. Ukládání odpovědí do mezipaměti může výrazně snížit latenci volajících rozhraní API a zatížení back-endu poskytovatelů rozhraní API. Tento článek popisuje, jak do rozhraní API přidat ukládání do mezipaměti.

• Základní informace a scénáře pro ukládání do mezipaměti najdete v tématu Přehled ukládání do mezipaměti.
• Informace o použití externí mezipaměti najdete v tématu Použití externí mezipaměti kompatibilní s Redis ve službě Azure API Management.
• Podrobnější informace o ukládání do mezipaměti najdete v částech věnovaných zásadám ukládání do mezipaměti služby API Management a vlastnímu ukládání do mezipaměti ve službě Azure API Management.

Důležité

Integrovaná mezipaměť je nestálá a sdílí ji všechny jednotky ve stejné oblasti ve stejné instanci služby API Management. Bez ohledu na použitý typ mezipaměti (interní nebo externí), pokud se operace související s mezipamětí nepodaří připojit k mezipaměti kvůli nestálosti mezipaměti nebo z jakéhokoli jiného důvodu, volání rozhraní API, které používá operaci související s mezipamětí, nevyvolá chybu a operace mezipaměti se úspěšně dokončí. V případě operace čtení se volajícímu výrazu zásad vrátí hodnota null. Kód zásad by měl být navržený tak, aby se zajistilo, že existuje záložní mechanismus pro načtení dat, která se v mezipaměti nenašla.

V tomto článku se dozvíte:

• Přidat ukládání odpovědí do mezipaměti pro vaše rozhraní API
• Ověřte, že ukládání do mezipaměti funguje.

Poznámka:

Interní ukládání do mezipaměti není dostupné na úrovni Consumption služby Azure API Management. Místo toho můžete použít externí službu Azure Cache for Redis . Můžete také nakonfigurovat externí mezipaměť v jiných úrovních služby API Management.

Požadavky

• Vytvoření instance Azure API Managementu
• Import a publikování rozhraní API

Přidat zásady ukládání do mezipaměti

Když jsou zásady ukládání do mezipaměti uvedené v tomto příkladu, první požadavek na testovací operaci vrátí odpověď z back-endové služby. Tato odpověď se uloží do mezipaměti, kam bude zadaná podle určených hlaviček a parametrů řetězce dotazu. Následná volání operace s odpovídajícími parametry vrátí odpověď uloženou v mezipaměti, dokud nevyprší interval doby trvání mezipaměti.

1. Přihlaste se k portálu Azure.

2. Přejděte do instance služby API Management.

3. V nabídce na levé straně vyberte rozhraní API>rozhraní API.

4. Vyberte rozhraní API, pro které chcete nakonfigurovat ukládání do mezipaměti.

5. V horní části obrazovky vyberte kartu Návrh .

6. V části Zpracování příchozích dat vyberte ikonu< />:

   

7. Do elementu inbound přidejte následující zásadu:

   <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" />
   

   Poznámka:

   Po vyhledávání cache přidejte politiku omezení rychlosti (nebo politiku omezení podle klíčů ), která pomůže omezit počet hovorů a zabrání přetížení backendové služby v případě, že cache není dostupná.

8. Do elementu outbound přidejte následující zásadu:

   <cache-store duration="20" />
   

   V této zásadě duration určuje interval vypršení platnosti odpovědí uložených v mezipaměti. Interval je 20 sekund.

9. Vyberte Uložit.

Návod

Pokud používáte externí mezipaměť, jak je popsáno v tématu Použití externí mezipaměti kompatibilní s Redis ve službě Azure API Management, můžete chtít zadat caching-type atribut zásad ukládání do mezipaměti. Další informace najdete v tématu Zásady ukládání do mezipaměti služby API Management .

Zavolejte operaci pro otestování ukládání do mezipaměti

Pokud chcete otestovat ukládání do mezipaměti, zavolejte operaci v portálu.

1. Na webu Azure Portal přejděte do vaší instance služby API Management.
2. V nabídce na levé straně vyberte rozhraní API>rozhraní API.
3. Vyberte rozhraní API, ke kterému jste přidali zásady ukládání do mezipaměti.
4. Vyberte operaci, která se má otestovat.
5. Vyberte kartu Test v horní části okna.
6. V rychlém sledu vyberte trasování dvakrát nebo třikrát.
7. V části Odpověď HTTP vyberte kartu Trasování .
8. Přejděte do části Příchozí a posuňte se k zásadám cache-lookup . Na následujícím snímku obrazovky by se měla zobrazit zpráva podobná té, která označuje přístup do mezipaměti:

Související obsah

• Další informace o zásadách ukládání do mezipaměti najdete v části Zásady ukládání do mezipaměti v článku Zásady API managementu.
• Informace o ukládání položek do mezipaměti podle klíče pomocí výrazů zásad najdete v tématu Vlastní ukládání do mezipaměti ve službě Azure API Management.
• Další informace o použití externí mezipaměti Azure Cache for Redis nebo Azure Managed Redis najdete v tématu Použití externí mezipaměti kompatibilní s Redis ve službě Azure API Management.