Get value from cache
S’APPLIQUE À : tous les niveaux de Gestion des API
La stratégie cache-lookup-value permet d’effectuer une recherche dans le cache par clé et de renvoyer une valeur mise en cache. 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
Cette stratégie doit avoir une stratégie Store value in cache correspondante.
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-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" />
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 |
| default-value | Valeur attribuée à la variable si la recherche de clés de cache a échoué. Si cet attribut n’est pas spécifié, null est attribué. Les expressions de stratégie sont autorisées. |
Non | null |
| key | Valeur de clé de cache à utiliser dans la recherche. Les expressions de stratégie sont autorisées. | Oui | N/A |
| variable-name | Nom de la variable contextuelle à laquelle la valeur recherchée est attribuée, si la recherche réussit. Si la recherche aboutit à un échec, la variable n’est pas définie. Les expressions de stratégie ne sont pas 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, consommation, auto-hébergées, espace de travail
Exemple
<cache-lookup-value
key="@("userprofile-" + context.Variables["enduserid"])"
variable-name="userprofile" />
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
- Kit de ressources des stratégies Gestion des API Azure
- Créer des stratégies à l’aide de Microsoft Copilot dans Azure