Udostępnij za pośrednictwem

Przechowywanie wartości w pamięci podręcznej

  • Artykuł

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

Przykład

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