Créer et modifier un cache d'environnement

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

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 n'est chiffré que dans les organisations compatibles 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.

Edge

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, procédez comme suit :
    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.
      Expiration 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, procédez comme suit :
    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.

Edge classique (cloud privé)

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

  1. Connectez-vous à http://ms-ip:9000, où ms-ip est l'adresse IP ou le nom DNS du nœud de serveur de gestion.
  2. Sélectionnez 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 la 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 la manière dont les entrées de cache expirent. La durée de vie de l'entrée peut être un nombre spécifié de secondes après la création, une heure de la journée spécifié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: la règle PopulateCache et la règle ResponseCache.
      Expiration Pour le délai avant expiration exprimé en secondes: 300 (secondes)

      Pour l'heure de la journée: 12:00:00

      Pour la date: date actuelle (jj/mm/aaaa)

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

      Saisissez l'heure de la journée au format HH:mm:ss, où HH représente l'heure au format 24 heures. Par exemple, 14:30:00 pour 2:30 dans 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 d'où est exécuté le code (ce qui n'est pas connaissable 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 Vider à 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 :