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
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:
Přidání zásad ukládání do mezipaměti
S použitím zásad ukládání do mezipaměti zobrazených v tomto příkladu vrátí první požadavek na operaci GetSpeakers 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.
Přihlaste se k portálu Azure.
Přejděte k vaší instanci APIM.
Vyberte kartu Rozhraní API.
V seznamu rozhraní API klikněte na Demo Conference API.
Vyberte GetSpeakers.
V horní části obrazovky vyberte kartu Návrh.
V části Zpracování příchozích dat klikněte na <ikonu />.
V 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>
V elementu outbound přidejte následující zásadu:
<cache-store duration="20" />
Doba trvání určuje dobu vypršení uložení odpovědí 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
Abyste viděli ukládání do mezipaměti v akci, vyvolejte operaci z portálu pro vývojáře.
- Na webu Azure Portal přejděte k vaší instanci APIM.
- Vyberte kartu Rozhraní API.
- Vyberte rozhraní API, ke kterému jste přidali zásady ukládání do mezipaměti.
- Vyberte operaci GetSpeakers.
- V pravé horní nabídce klikněte na kartu Test.
- Stiskněte Odeslat.
Další kroky
- 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.