Удаление значения из кэша

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

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

Примечание.

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

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

<cache-remove-value key="cache key value" caching-type="prefer-external | external | internal" fail-on-cache-removal-error="true | false" />

Атрибуты

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

Выражения политики не допускаются.
нет prefer-external
ключ Ключ кэшированного ранее значения, которое нужно удалить из кэша. Допустимы выражения политики. Да Н/П
fail-on-cache-removal-error Установите на true неудачное выполнение запроса, если операция удаления кэша не удалась. Настройте на false игнорирование ошибок удаления кэша. Допустимы выражения политики. нет false

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

Пример

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

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

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

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