Сохранение значения в кэше

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

Политика cache-store-value выполняет сохранение в кэш по ключу. Ключ может содержать произвольное строковое значение и обычно указывается с помощью выражения политики.

Примечание.

Операция хранения значения в кэше, выполняемая этой политикой, является асинхронной. Сохраненное значение можно получить с помощью политики получения значения из кэша. Однако сохраненное значение не всегда можно получить сразу, так как асинхронная операция, хранящая значение в кэше, может быть не завершена.

Внимание

Встроенный кэш является непостоянным и совместно используется всеми единицами одного региона в той же службе Управления API.

Примечание.

Задайте элементы политики и дочерние элементы в порядке, указанном в правиле политики. Узнайте, как устанавливать или изменять политики службы управления API.

Правило политики

<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />

Атрибуты

Атрибут Описание Обязательное поле По умолчанию.
тип кэширования Выберите одно из следующих значений атрибута:
- internalдля использования встроенного кэша Управление API,
- external для использования внешнего кэша, как описано в разделе "Использование внешнего кэша, совместимого с Redis" в службе управления API Azure,
- prefer-external — использование внешнего кэша, если он настроен. В противном случае используется внутренний кэш.

Выражения политики не допускаются.		 нет prefer-external
продолжительность Кэшированные значения сохраняются в течение указанного здесь времени (в секундах). Допустимы выражения политики. Да Н/П
ключ Ключ кэша, под которым будет храниться значение. Допустимы выражения политики. Да Н/П
значение Значение, которое нужно кэшировать. Допустимы выражения политики. Да Н/П

Использование

Заметки об использовании

  • Управление API кэширует только ответы на HTTP-запросы GET.
  • Эту политику можно использовать только один раз в разделе политики.
  • Мы рекомендуем настроить политику ограничения скорости (или политику ограничения скорости по ключу ) сразу после поиска кэша. Это помогает сохранить серверную службу от перегрузки, если кэш недоступен.

Пример

В этом примере показано, как использовать cache-store-value политику для хранения профиля пользователя в кэше. Ключ для записи кэша создается с помощью выражения политики, которое объединяет строку со значением переменной контекста enduserid .

См. пример значения кэша , чтобы получить профиль пользователя из кэша.

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

Дополнительные сведения и примеры этой политики см. в статье Custom caching in Azure API Management (Пользовательское кэширование в службе управления API Azure).

Связанный контент

Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.

  • Last updated on