Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление 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 |
Использование
- Разделы политики: inbound, outbound, backend, on-error.
- Области политики: глобальная, рабочая область, продукт, API, операция
- Шлюзы: классическая, версия 2, потребление, локальное размещение, рабочая область
Пример
В следующем примере показано, как использовать cache-remove-value политику для удаления профиля пользователя из кэша. Ключ для удаления кэша создается с помощью выражения политики, которое объединяет строку со значением контекстной enduserid переменной.
<cache-remove-value
key="@("userprofile-" + context.Variables["enduserid"])" />
Дополнительные сведения и примеры этой политики см. в статье Custom caching in Azure API Management (Пользовательское кэширование в службе управления API Azure).
Связанные политики
Связанный контент
Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.
- Руководство. Преобразование и защита API
- Полный перечень операторов политик и их параметров см. в справочнике по политикам.
- Выражения политики
- Настройка или изменение политик
- Повторное использование конфигураций политик
- Репозиторий фрагментов политик
- репозиторий Policy
- Набор средств политики Управление API Azure
- Получите помощь Copilot для создания, объяснения и устранения неполадок в политике