Partager via

Obtenir une valeur à partir du 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 Descriptif Obligatoire Par défaut
mise en cache-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
valeur par défaut 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
clé Valeur de clé de cache à utiliser dans la recherche. Les expressions de stratégie sont autorisées. Oui N/A
nom de variable 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

Utilisation

Notes d’utilisation

  • Gestion des API met uniquement en cache les réponses aux requêtes HTTP GET.
  • Cette stratégie ne peut être employée qu’une seule fois dans une section stratégie.
  • Cette stratégie n’est pas prise en charge à l’intérieur d’un fragment de stratégie.
  • Nous vous recommandons de configurer une stratégie de limite de débit (ou une stratégie de limite de débit par clé ) immédiatement après toute recherche de cache. Cela permet à votre service principal d’être surchargé si le cache n’est pas disponible.

Exemple

Cet exemple montre comment utiliser la cache-lookup-value stratégie pour récupérer un profil utilisateur à partir du cache. La clé de la recherche de cache est construite à l’aide d’une expression de stratégie qui combine une chaîne avec la valeur de la enduserid variable de contexte.

Notes

Ajoutez une stratégie de limite de débit (ou une stratégie de limite de débit par clé ) après la recherche du cache pour limiter le nombre d’appels et empêcher la surcharge sur le service principal si le cache n’est pas disponible.

Consultez un exemple cache-store-value pour stocker le profil utilisateur dans le cache.

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />
<rate-limit calls="10" renewal-period="60" />

Pour plus d’informations et d’exemples sur cette stratégie, consultez Mise en cache personnalisée dans Gestion des API Azure.

Contenu connexe

Pour plus d’informations sur l’utilisation des stratégies, consultez :

  • Last updated on