Créer et modifier un cache d'environnement

Vous consultez la documentation sur Apigee Edge.
Consultez la documentation sur Apigee X.

Lorsque vous ne souhaitez pas utiliser le cache partagé inclus, vous pouvez créer et configurer votre propre cache. Vous pouvez utiliser le cache que vous créez sous des règles de mise en cache au lieu du cache partagé.

Vous pouvez également créer un cache à l'aide d'une API Apigee. Pour plus d'informations, consultez la section Créer un cache dans un environnement.

Limites de cache : consultez la section Limites pour connaître les différentes limites qui s'appliquent aux caches, telles que le nom et la taille des valeurs, le nombre total de caches, le nombre d'éléments dans un cache et les délais d'expiration.

À propos du chiffrement du cache

Edge pour le cloud public:le cache est chiffré uniquement dans les organisations PCI et HIPAA. Le chiffrement de ces organisations est configuré lors de la gestion de leurs comptes.

Définir une ressource de cache

Vous pouvez créer plusieurs ressources de cache dans chaque environnement. Lorsque vous configurez une règle de mise en cache, vous spécifiez si celle-ci doit utiliser le cache partagé inclus ou un cache que vous avez créé.

Pour la séparation des données, le champ d'application d'un cache est limité à l'environnement dans lequel vous avez créé le cache. (Par exemple, les proxys d'API exécutés dans un environnement de test ne peuvent pas accéder aux données d'un cache s'exécutant en production.) Une fois que vous avez créé un cache, les règles peuvent le remplir avec toutes les données sérialisables. Pour en savoir plus, consultez l'article Exemple : mise en cache à usage général.

Voir également Règle de réponse du cache.

Gérer vos caches

Gérez vos caches, comme décrit ci-dessous.

En périphérie

Pour gérer vos caches à l’aide de l’interface utilisateur Edge:

  1. Connectez-vous à apigee.com/edge.
  2. Sélectionnez Admin > Environnements > Caches dans la barre de navigation de gauche.
  3. Pour créer un cache :
    1. Cliquez sur + Cache.
    2. Saisissez les valeurs de propriété du nouveau cache, comme décrit ci-dessous.
      Nom Description
      Nom Nom du cache. Doit être unique dans l'environnement. Référencez ce nom à partir des règles qui interagissent avec la ressource de cache.
      Description Facultatif. Description de la ressource de cache.
      Expire Heure à laquelle un cache arrive à expiration. L'heure d'expiration peut être spécifiée sous la forme d'un nombre de secondes après la création, d'une heure de la journée ou d'une date spécifique.
      Remarque : Les règles suivantes remplacent les paramètres d'expiration avec les entrées de cache qu'elles créent : règle d'insertion du cache et règle de réponse du cache.
    3. Cliquez sur Ajouter un cache.
  4. Pour modifier un cache :
    1. Placez votre curseur sur le cache de la liste pour afficher le menu Actions.
    2. Cliquez sur .
    3. Mettez à jour les paramètres du cache.
    4. Cliquez sur Mettre à jour le cache.
  5. Pour vider un cache :
    1. Placez votre curseur sur le cache de la liste pour afficher le menu Actions.
    2. Cliquez sur .
  6. Pour supprimer un cache :
    1. Placez votre curseur sur le cache de la liste pour afficher le menu Actions.
    2. Cliquez sur .
    3. Cliquez sur Supprimer pour confirmer la suppression.

Classic Edge (cloud privé)

Pour gérer vos caches à l'aide de l'interface utilisateur Classic Edge:

  1. Connectez-vous à http://ms-ip:9000, où ms-ip est l'adresse IP ou le nom DNS du nœud du serveur de gestion.
  2. Sélectionnez API > Environment Configuration > Caches (API > Configuration de l'environnement > Caches).
  3. Sélectionnez l'environnement pour lequel vous souhaitez configurer des caches, par exemple test ou prod.
  4. Pour créer un cache :
    1. Cliquez sur Modifier.
    2. Cliquez sur + Cache.
    3. Saisissez les valeurs de propriété du nouveau cache, comme décrit ci-dessous.
      Nom de propriété Valeur par défaut Description
      Nom N/A Nom du cache. Doit être unique dans l'environnement. Référencez ce nom à partir des règles qui interagissent avec la ressource de cache.
      Description N/A Description facultative de la ressource de cache.
      Type d'expiration Délai avant expiration exprimé en secondes Définit le délai d'expiration des entrées de cache. La valeur TTL d'entrée peut être un nombre de secondes après la création, un moment de la journée ou une date spécifiée. Remarque:Les règles suivantes remplacent les paramètres d'expiration par les entrées de cache qu'elles créent: Renseigner la stratégie de cache et Réponse au cache de réponse.
      Expiration Délai avant expiration en secondes: 300 (secondes)

      Heure de la journée: 12:00:00

      For date (pour la date) : date actuelle (dd-MM-yyyy)

      Paramètre de configuration (entier ou date/heure) pour la sélection que vous avez effectuée dans le menu déroulant Expiration.

      Saisissez l'heure au format HH:mm:ss, où HH représente l'heure au format 24 heures. Exemple : 14:30:00 pour 2:30 l'après-midi.

      Pour l'heure de la journée, les paramètres régionaux et le fuseau horaire par défaut varient en fonction de l'emplacement d'exécution du code (qui n'est pas connu au moment de la configuration).
    4. Cliquez sur Enregistrer.
  5. Pour modifier un cache :
    1. Cliquez sur Modifier.
    2. Modifiez les valeurs du cache.
    3. Cliquez sur Enregistrer.
  6. Pour vider un cache, cliquez sur Effacer à côté du cache que vous souhaitez vider.
  7. Pour supprimer un cache :
    1. Cliquez sur Modifier.
    2. Cliquez sur Supprimer à côté du cache que vous souhaitez supprimer.

Remplir le cache

Vous pouvez remplir le cache lors de l'exécution du proxy de l'API comme suit :