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