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-host, workspace
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.
Související zásady
Související obsah
Další informace o práci se zásadami najdete v tématech:
- Kurz: Transformace a ochrana rozhraní API
- Referenční informace o zásadách pro úplný seznam prohlášení o zásadách a jejich nastavení
- Výrazy zásad
- Nastavení nebo úprava zásad
- Opakované použití konfigurací zásad
- Úložiště fragmentů zásad
- Vytváření zásad pomocí Microsoft Copilotu v Azure