Créer et modifier un cache d'environnement

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

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 conformes à la norme PCI et à la loi 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.

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 des propriétés pour le 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 le 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 correspond à l'adresse IP ou au nom DNS du nœud du serveur de gestion.
  2. Sélectionnez API > Configuration de l'environnement > Caches.
  3. Sélectionnez l'environnement pour lequel vous souhaitez configurer des caches, tel que test ou prod.
  4. Pour créer un cache :
    1. Cliquez sur Modifier.
    2. Cliquez sur + Cache.
    3. Saisissez les valeurs des propriétés pour le 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 en secondes Définit le délai d'expiration des entrées du cache. La valeur TTL (Time To Live) d'entrée peut correspondre à un nombre spécifié de secondes après la création, à une heure précise de la journée ou à une date spécifiée. Remarque:Les stratégies 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ègle de cache de réponse.
      Expiration Pour le délai avant expiration 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/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. Par exemple, 14:30:00 pour 14h30 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 ne peut pas être 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 le cache, cliquez sur Effacer à côté du cache de votre choix.
  7. Pour supprimer un cache :
    1. Cliquez sur Modifier.
    2. Cliquez sur Supprimer à côté du cache que vous souhaitez supprimer.

Insertion du cache...

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