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é.
No 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é. No null
key Hodnota klíče mezipaměti, která se má použít ve vyhledávání. Výrazy zásad jsou povolené. Yes
variable-name 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é. Yes

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-hosted

Příklad

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />

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.

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