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

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.

Důležité

Integrovaná mezipaměť je nestálá a sdílí se všemi jednotkami ve stejné oblasti ve stejné službě API Management. Bez ohledu na použitý typ mezipaměti (interní nebo externí) platí, že pokud se operacím souvisejícím s mezipamětí nepodaří připojit k mezipaměti kvůli její nestálosti nebo z jiného důvodu, volání rozhraní API, které využívá danou 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. Váš kód zásad by měl být navržený tak, aby se zajistilo, že existuje mechanismus pro načtení dat, která se v mezipaměti nenalezla. 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.

Naučíte se:

• Přidat ukládání odpovědí do mezipaměti pro vaše rozhraní API
• Ověřit ukládání do mezipaměti v akci

Poznámka:

Interní mezipaměť 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

Pro absolvování tohoto kurzu potřebujete:

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

Přidání zásad ukládání do mezipaměti

Při použití zásad ukládání do mezipaměti zobrazených 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ásledující volání operace (s odpovídající parametry) bude vracet odpověď uloženou v mezipaměti až do okamžiku vypršení doby uložení v 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.>

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>
   

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

   <cache-store duration="20" />
   

   V této zásadě doba trvání určuje interval vypršení platnosti odpovědí uložených v mezipaměti. V tomto příkladu je délka intervalu 20 sekund.

Tip

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

Volání operace a testování ukládání do mezipaměti

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

1. Na webu Azure Portal přejděte k vaší instanci služby API Management.
2. V nabídce na levé straně vyberte 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. V pravé horní nabídce vyberte kartu Test.
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á značí 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 článku Vlastní ukládání do mezipaměti ve službě Azure API Management.
• Další informace o používání externí služby Azure Cache for Redis najdete v tématu Použití externí služby Azure Cache for Redis ve službě Azure API Management.