Получение значения из кэша

  • Статья

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

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

Примечание.

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

Внимание

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

Примечание.

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

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

<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" />

Атрибуты

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

Выражения политики не допускаются.		 No prefer-external
default-value Значение, которое присваивается переменной, если поиск в кэше по ключу не дал результатов. Если этот атрибут не указан, присваивается значение null. Допустимы выражения политики. No null
key Значение ключа кэша, которое нужно использовать при поиске. Допустимы выражения политики. Да Н/П
имя-переменной Имя переменной контекста, которой присваивается найденное значение, если поиск завершится успешно. Если поиск не дал результатов, переменная не будет задана. Выражения политики не допускаются. Да Н/П

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

Пример

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />

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

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

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