Udostępnij przez

Przechowywanie wartości w pamięci podręcznej

DOTYCZY: Wszystkie warstwy usługi API Management

Funkcja cache-store-value wykonuje magazyn pamięci podręcznej według klucza. Klucz może mieć dowolną wartość w postaci ciągu i jest zwykle określany przy użyciu wyrażenia zasad.

Uwaga

Operacja przechowywania wartości w pamięci podręcznej wykonywana przez te zasady jest asynchroniczna. Przechowywaną wartość można pobrać przy użyciu zasad Pobierz wartość z pamięci podręcznej . Jednak przechowywana wartość może nie być natychmiast dostępna do pobrania, ponieważ operacja asynchroniczna, która przechowuje wartość w pamięci podręcznej, może nadal być w toku.

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-store-value key="cache key value" value="value to cache" duration="seconds" 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
czas trwania Wartość zostanie buforowana dla podanej wartości czasu trwania określonej w sekundach. Wyrażenia zasad są dozwolone. Tak Nie dotyczy
klucz Klucz pamięci podręcznej wartość będzie przechowywana w obszarze. Wyrażenia zasad są dozwolone. Tak Nie dotyczy
wartość Wartość do buforowania. Wyrażenia zasad 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.
  • 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-store-value zasad do przechowywania profilu użytkownika w pamięci podręcznej. Klucz wpisu pamięci podręcznej jest konstruowany przy użyciu wyrażenia zasad, które łączy ciąg z wartością zmiennej enduserid kontekstowej.

Zobacz przykład cache-lookup-value , aby pobrać profil użytkownika z pamięci podręcznej.

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

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