Sdílet prostřednictvím

Získání hodnoty z mezipaměti

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

cache-lookup-value Pomocí zásad můžete provést vyhledávání v mezipaměti podle klíče a vrátit hodnotu uloženou v mezipaměti. Klíč může mít libovolnou řetězcovou hodnotu a obvykle se zadává prostřednictvím výrazu zásad.

Poznámka:

Tato zásada musí mít odpovídající hodnotu úložiště v zásadách mezipaměti .

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-lookup-value key="cache key value"
    default-value="value to use if cache lookup resulted in a miss"
    variable-name="name of a variable looked up value is assigned to"
    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
default-value Hodnota, která se přiřadí proměnné v případě, že vyhledání klíče mezipaměti vedlo k chybě. Pokud tento atribut není zadán, null je přiřazen. Výrazy zásad jsou povolené. Ne null
klíč Hodnota klíče mezipaměti, která se má použít ve vyhledávání. Výrazy zásad jsou povolené. Ano –
název proměnné Název kontextové proměnné , ke které bude vyhledávací hodnota přiřazena, pokud bude vyhledávání úspěšné. Pokud výsledkem vyhledávání bude neúspěšná, proměnná se nenastaví. Výrazy zásad nejsou 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.
  • Tato zásada není podporována uvnitř fragmentu zásad.
  • 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-lookup-value zásad načíst profil uživatele z mezipaměti. Klíč pro vyhledávání mezipaměti je vytvořen pomocí výrazu zásady, který kombinuje řetězec s hodnotou enduserid kontextové proměnné.

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á.

Podívejte se na příklad hodnoty úložiště mezipaměti pro uložení profilu uživatele do mezipaměti.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

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