Store value in cache
S’APPLIQUE À : tous les niveaux de Gestion des API
La stratégie cache-store-value effectue le stockage du cache par clé. La clé peut avoir une valeur de chaîne arbitraire ; elle est généralement fournie par le biais d’une expression de stratégie.
Notes
L’opération de stockage de la valeur dans le cache que cette stratégie effectue est asynchrone. Il est possible de récupérer la valeur stockée à l’aide de la stratégie Get value from cache. Toutefois, il se peut que la valeur stockée ne soit pas immédiatement disponible pour la récupération, car l’opération asynchrone qui stocke la valeur dans le cache peut être encore en cours.
Important
Le cache intégré est volatile et partagé par toutes les unités de la même région dans le même service de gestion des API.
Notes
Définissez les éléments enfants et de stratégie dans l’ordre fourni dans l’instruction de stratégie. En savoir plus sur comment définir ou modifier des stratégies du service Gestion des API.
Instruction de la stratégie
<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />
Attributs
| Attribut | Description | Obligatoire | Default |
|---|---|---|---|
| caching-type | Choisissez entre les valeurs suivantes de l’attribut : - internal pour utiliser le cache Gestion des API intégré,- external pour utiliser le cache externe (voir - ,- prefer-external pour utiliser un cache externe (si configuré) ou un cache interne sinon.Les expressions de stratégie ne sont pas autorisées. |
Non | prefer-external |
| duration | La valeur est mise en cache pendant la durée spécifiée en secondes. Les expressions de stratégie sont autorisées. | Oui | N/A |
| key | Clé de cache sous laquelle la valeur est stockée. Les expressions de stratégie sont autorisées. | Oui | N/A |
| value | Valeur à mettre en cache. Les expressions de stratégie sont autorisées. | Oui | N/A |
Usage
- Sections de la stratégie : inbound, outbound, backend, on-error
- Étendues de la stratégie : global, espace de travail, produit, API, opération
- Passerelles : classiques, v2, de consommation, auto-hébergées
Exemple
<cache-store-value
key="@("userprofile-" + context.Variables["enduserid"])"
value="@((string)context.Variables["userprofile"])" duration="100000" />
Pour plus d’informations et d’exemples sur cette stratégie, consultez Mise en cache personnalisée dans Gestion des API Azure.
Stratégies connexes
Contenu connexe
Pour plus d’informations sur l’utilisation des stratégies, consultez :
- Tutoriel : Transformer et protéger votre API
- Référence de stratégie pour obtenir la liste complète des instructions et des paramètres de stratégie
- Expressions de stratégie
- Définir ou modifier des stratégies
- Réutilisation de configurations de stratégie
- Référentiel d’extrait de stratégie
- Créer des stratégies à l’aide de Microsoft Copilot pour Azure