Sdílet prostřednictvím

Uložení hodnoty v mezipaměti

PLATÍ PRO: Všechny úrovně služby API Management

Provádí cache-store-value ukládání do mezipaměti podle klíče. Klíč může mít libovolnou řetězcovou hodnotu a obvykle se zadává prostřednictvím výrazu zásad.

Poznámka:

Operace ukládání hodnoty v mezipaměti prováděné touto zásadou je asynchronní. Uloženou hodnotu lze načíst pomocí možnosti Získat hodnotu ze zásad mezipaměti . Uložená hodnota však nemusí být okamžitě k dispozici pro načtení, protože asynchronní operace, která ukládá hodnotu v mezipaměti, může stále probíhat.

Důležité

Integrovaná mezipaměť je nestálá a sdílí se všemi jednotkami ve stejné oblasti ve stejné službě API Management.

Poznámka:

Nastavte prvky zásad a podřízené prvky v pořadí uvedeném v prohlášení o zásadách. Přečtěte si další informace o tom, jak nastavit nebo upravit zásady služby API Management.

Prohlášení o zásadách

<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />

Atributy

Atribut Popis Požaduje se Výchozí
ukládání do mezipaměti Vyberte mezi následujícími hodnotami atributu:
- internal pro použití integrované mezipaměti SLUŽBY API Management,
- external použít externí mezipaměť, jak je popsáno v tématu Použití externí služby Azure Cache for Redis ve službě Azure API Management,
- prefer-external použít externí mezipaměť, pokud je nakonfigurovaná nebo interní mezipaměť jinak.

Výrazy zásad nejsou povolené.		 Ne prefer-external
doba trvání Hodnota se uloží do mezipaměti pro zadanou hodnotu doby trvání zadanou v sekundách. Výrazy zásad jsou povolené. Ano –
klíč Klíč mezipaměti, pod který se hodnota uloží. Výrazy zásad jsou povolené. Ano –
hodnota Hodnota, která se má uložit do mezipaměti. Výrazy zásad jsou povolené. Ano –

Využití

  • Oddíly zásad: příchozí, odchozí, back-end, on-error
  • Obory zásad: globální, pracovní prostor, produkt, rozhraní API, operace
  • Brány: Classic, v2, consumption, self-host, workspace

Poznámky k využití

  • Api Management ukládá odpovědi pouze do mezipaměti na požadavky HTTP GET.
  • Tuto zásadu je možné v oddílu zásad použít jenom jednou.
  • Doporučujeme nakonfigurovat zásady omezení rychlosti (nebo zásady omezení rychlosti podle klíče ) okamžitě po každém vyhledávání v mezipaměti. To pomáhá zabránit přetížení back-endové služby, pokud mezipaměť není dostupná.

Příklad

Tento příklad ukazuje, jak pomocí cache-store-value zásad uložit profil uživatele do mezipaměti. Klíč pro položku mezipaměti je vytvořen pomocí výrazu zásady, který kombinuje řetězec s hodnotou enduserid kontextové proměnné.

Podívejte se na příklad vyhledávací hodnoty mezipaměti pro načtení profilu uživatele z mezipaměti.

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

Další informace a příklady této zásady najdete v tématu Vlastní ukládání do mezipaměti ve službě Azure API Management.

Související obsah

Další informace o práci se zásadami najdete v tématech:

  • Last updated on