Udostępnij przez

Pobieranie wartości z pamięci podręcznej

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
klucz Wartość klucza pamięci podręcznej do użycia w wyszukiwaniu. Wyrażenia zasad są dozwolone. Tak Nie dotyczy
nazwa-zmiennej 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

Uwagi dotyczące użycia

  • Usługa API Management buforuje tylko odpowiedzi na żądania HTTP GET.
  • Te zasady można użyć tylko raz w sekcji zasad.
  • Te zasady nie są obsługiwane wewnątrz fragmentu zasad.
  • Zalecamy skonfigurowanie zasad limitu szybkości (lub zasad rate-limit-by-key ) natychmiast po każdym wyszukiwaniu w pamięci podręcznej. Dzięki temu usługa zaplecza nie jest przeciążona, jeśli pamięć podręczna nie jest dostępna.

Przykład

W tym przykładzie pokazano, jak używać cache-lookup-value zasad do pobierania profilu użytkownika z pamięci podręcznej. Klucz wyszukiwania pamięci podręcznej jest konstruowany przy użyciu wyrażenia zasad, które łączy ciąg z wartością zmiennej enduserid kontekstowej.

Uwaga

Dodaj zasady limitu szybkości (lub zasady rate-limit-by-key ) po wyszukiwaniu pamięci podręcznej, aby pomóc ograniczyć liczbę wywołań i zapobiec przeciążeniu usługi zaplecza, jeśli pamięć podręczna nie jest dostępna.

Zobacz przykład cache-store-value do przechowywania profilu użytkownika w pamięci podręcznej.

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

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:

  • Last updated on