Udostępnij za pośrednictwem

Pobieranie wartości z pamięci podręcznej

  • Artykuł

DOTYCZY: Wszystkie warstwy usługi API Management

Użyj zasad, cache-lookup-value aby wykonać wyszukiwanie w pamięci podręcznej według klucza i zwrócić wartość z pamięci podręcznej. Klucz może mieć dowolną wartość w postaci ciągu i jest zwykle określany przy użyciu wyrażenia zasad.

Uwaga

Te zasady muszą mieć odpowiednią wartość magazynu w zasadach pamięci podręcznej .

Ważne

Wbudowana pamięć podręczna jest niestabilna i współużytkowana przez wszystkie jednostki w tym samym regionie w tej samej usłudze API Management.

Uwaga

Ustaw elementy zasad i elementy podrzędne w kolejności podanej w instrukcji zasad. Dowiedz się więcej na temat ustawiania lub edytowania zasad usługi API Management.

Instrukcja zasad

<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" />

Atrybuty

Atrybut opis Wymagani Wartość domyślna
Typ buforowania Wybierz między następującymi wartościami atrybutu:
- internaldo korzystania z wbudowanej pamięci podręcznej usługi API Management,
- external aby używać zewnętrznej pamięci podręcznej zgodnie z opisem w temacie Używanie zewnętrznej pamięci podręcznej Azure Cache for Redis w usłudze Azure API Management,
- prefer-external do korzystania z zewnętrznej pamięci podręcznej, jeśli skonfigurowano lub wewnętrzną pamięć podręczną.

Wyrażenia zasad nie są dozwolone.		 Nie. prefer-external
wartość domyślna Wartość, która zostanie przypisana do zmiennej, jeśli wyszukiwanie klucza pamięci podręcznej spowodowało chybienie. Jeśli ten atrybut nie zostanie określony, null zostanie przypisany. Wyrażenia zasad są dozwolone. Nie. null
key Wartość klucza pamięci podręcznej do użycia w wyszukiwaniu. Wyrażenia zasad są dozwolone. Tak Nie dotyczy
variable-name Nazwa zmiennej kontekstowej , do której zostanie przypisana wyszukana wartość, jeśli wyszukiwanie zakończy się pomyślnie. Jeśli wyszukiwanie spowoduje chybicie, zmienna nie zostanie ustawiona. Wyrażenia zasad nie są dozwolone. Tak Nie dotyczy

Użycie

  • Sekcje zasad: ruch przychodzący, wychodzący, zaplecze, błąd
  • Zakresy zasad: globalny, obszar roboczy, produkt, interfejs API, operacja
  • Bramy: klasyczne, v2, zużycie, self-hosted, obszar roboczy

Przykład

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

Aby uzyskać więcej informacji i przykłady tych zasad, zobacz Niestandardowe buforowanie w usłudze Azure API Management.

Powiązana zawartość

Aby uzyskać więcej informacji na temat pracy z zasadami, zobacz: