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

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление 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" />

Атрибуты

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

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

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

Пример

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

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

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

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