Partager via

Stocker la valeur dans le 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 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
durée 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
clé Clé de cache sous laquelle la valeur est stockée. Les expressions de stratégie sont autorisées. Oui N/A
valeur Valeur à mettre en cache. Les expressions de stratégie sont 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.
  • 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-store-value stratégie pour stocker un profil utilisateur dans le cache. La clé de l’entrée 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.

Consultez un exemple de valeur de recherche de cache pour récupérer le profil utilisateur à partir du cache.

<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.

Contenu connexe

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

  • Last updated on