Outils de persistance dans Edge

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Au sommaire

Les mécanismes de mise en cache et de persistance d'Apigee Edge incluent la persistance à court terme et à long terme. Il existe des règles pour la mise en cache des réponses et la mise en cache à usage général. Utilisez l'API de gestion pour gérer les caches.

Mise en cache de réponses de backend

Vous pouvez mettre en cache la réponse d'une ressource de backend avec la règle de cache de réponse.

Cela s'avère particulièrement utile lorsque les données de backend ne sont mises à jour que périodiquement. La règle ResponseCache peut réduire les appels aux sources de données de backend.

Grâce à la stratégie ResponseCache, vous pouvez également demander à Edge d'examiner certains en-têtes de mise en cache des réponses HTTP et de prendre des mesures en fonction des directives d'en-tête. Par exemple, sur les réponses provenant de cibles backend, Edge prend en charge l'en-tête Cache-Control. Cet en-tête peut être utilisé, entre autres, pour contrôler l'âge maximal d'une réponse mise en cache. Pour en savoir plus, consultez la section Compatibilité avec les en-têtes de réponse HTTP.

Mise en cache à usage général à court terme

En utilisant des règles pour la mise en cache à usage général, vous pouvez conserver tous les objets requis par votre proxy dans plusieurs sessions de requête/réponse.

Avec les règles PopulateCache, LookupCache et InvalidateCache, vous pouvez renseigner, récupérer et purger des données mises en cache au moment de l'exécution

Par exemple, vous pouvez stocker temporairement les éléments suivants :

  • ID de session pour la gestion de session
  • Identifiants des appels sortants (tels que les clés API ou les jetons d'accès OAuth)
  • Contenu de réponse qui doit être paginé pour les applications

Au moment de l'exécution, vos règles de cache copient les valeurs entre les variables du proxy et le cache configuré que vous spécifiez. Lorsqu'une valeur est placée dans le cache, elle est copiée à partir de la variable spécifiée dans le cache. Une fois récupérée à partir du cache, elle est copiée dans la variable pour être utilisée par votre proxy.

Pour obtenir un exemple de code, consultez la section Exemple : Mise en cache à usage général.

Persistance à long terme avec des mappages de clés/valeurs (KVM)

Pour stocker indéfiniment des données structurées chiffrées ou non chiffrées, vous pouvez créer et renseigner des mappages de clés-valeurs (KVM) contenant des paires clé/valeur arbitraires. Par exemple, vous pouvez stocker les éléments suivants :

  • Un mappage associant les adresses IP aux codes de pays
  • Liste d'adresses IP à ajouter à la liste d'autorisation/de refus.
  • Un mappage associant les URL longues aux URL raccourcies.
  • Des données propres à l'environnement, telles que le nombre de quotas ou les délais d'expiration des jetons OAuth.

Les KVM peuvent avoir l'un des trois champs d'application suivants : organisation, environnement, apiproxy. Par exemple, si des paires clé/valeur doivent être utilisées pour toutes les API d'une organisation, créez un KVM au niveau de l'organisation. Si seul un proxy d'API spécifique doit avoir accès à des clés-valeurs, créez la KVM au niveau de l'apiproxy. Vous pouvez créer, gérer et récupérer des mappages de clés-valeurs de différentes manières. Pour en savoir plus, consultez la section Utiliser des mappages clé-valeur.

Gérer le cache avec l'API de gestion

Si vous souhaitez créer, afficher, mettre à jour, supprimer ou vider le cache en dehors du champ d'application des règles dans un flux de messages, vous pouvez utiliser l'API de gestion des caches.