Problèmes connus liés à Apigee

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Sélectionnez un ou plusieurs des éléments suivants pour filtrer cette page :

Cette section répertorie les problèmes connus pour les composants Apigee. Pour obtenir une liste des bugs, des nouvelles fonctionnalités et d'autres informations de version, consultez les notes de version.

ID du problème Concerne État Description
543171828 hybrid 1.14.7, hybrid 1.15.7 et hybrid 1.16.8 CORRIGÉ dans hybrid 1.16.9 Le DaemonSet apigee-logger n'est planifié sur aucun nœud. Par conséquent, les journaux d'exécution Apigee n'atteignent plus Cloud Logging.

Après l'installation ou la mise à niveau vers une version concernée, kubectl get daemonset apigee-logger -n apigee indique un nombre souhaité de 0 et aucun pod d'enregistreur n'est créé.

Le graphique apigee-telemetry a toujours fourni un logger.nodeSelector par défaut de apigee.cloud.google.com/apigee-logger-enabled: "true", ce qui vous oblige à étiqueter les nœuds qui doivent exécuter l'enregistreur. Les versions antérieures aux versions concernées ignoraient les sélecteurs de nœuds au niveau du composant. L'enregistreur était donc planifié sur les pools de nœuds Apigee, même si les nœuds n'étaient pas étiquetés. Les versions concernées appliquent correctement les sélecteurs de nœuds au niveau des composants. La valeur par défaut prend donc effet et le DaemonSet ne correspond à aucun nœud.

Seuls les déploiements qui définissent logger.enabled: true sont concernés.

Solution : choisissez l'une des options suivantes, puis mettez à niveau le graphique apigee-telemetry.

Pour exécuter l'enregistreur sur chaque nœud, ce qui correspond au comportement des versions précédentes, effacez le sélecteur de nœud par défaut dans votre fichier overrides.yaml :

logger:
  enabled: true
  nodeSelector:
    key: ""
    value: ""

Pour limiter l'enregistreur à un ensemble spécifique de nœuds, conservez le sélecteur de nœuds par défaut et ajoutez un libellé à chacun de ces nœuds :

kubectl label nodes NODE_NAME apigee.cloud.google.com/apigee-logger-enabled=true
534420582 Apigee
Apigee hybrid		 CORRIGÉ dans hybrid 1.15.8 Les charges utiles JSON avec des clés en double peuvent être interprétées différemment par les règles Apigee et par les services de backend, ce qui peut affaiblir les contrôles de sécurité basés sur le contenu.

La règle ExtractVariables utilise JSONPath, qui résout les clés JSON en double à l'aide de la sémantique last-wins. Certains backends, notamment les API Google Cloud qui acceptent le format JSON proto3, fusionnent les clés répétées (par exemple, en concaténant les champs de tableau répétés). Si un proxy Apigee s'appuie sur ExtractVariables + JSONPath + RaiseFault pour inspecter et bloquer les corps de requête privilégiés, un pirate informatique peut masquer du contenu malveillant dans une clé en double que la règle Apigee ne voit pas, mais que le backend traite toujours.

Solution : Ne vous fiez pas à ExtractVariables avec JSONPath seul comme limite de sécurité pour les backends qui acceptent le format JSON proto3. Ajoutez une règle JSONThreatProtection au flux de requête avant ExtractVariables, puis configurez <ObjectEntryCount> et d'autres limites pour qu'elles correspondent à votre contrat d'API. Pour une protection renforcée, utilisez une règle JavaScript pour analyser le corps de la requête avec JSON.parse() et rejeter les charges utiles contenant des clés en double avant l'extraction.
523085517 UI OUVERT La vue de trace de débogage Apigee peut scintiller ou s'afficher lentement pour les sessions de débogage volumineuses.

Lorsque vous affichez une session de débogage dans l'UI Apigee, la carte des transactions et les détails de la trace peuvent apparaître et disparaître à plusieurs reprises (scintillement) ou prendre beaucoup de temps à s'afficher. Ce comportement est particulièrement visible pour les sessions de débogage contenant un grand nombre d'événements et sur les machines moins puissantes. Il peut rendre difficile l'inspection du flux d'une requête API.

Solution : dans le volet Options d'affichage de la vue de trace de débogage, décochez toutes les cases pour réduire le nombre d'éléments affichés. Vous pouvez également essayer d'afficher la session de débogage dans un autre navigateur.
513032450 hybrid 1.16.2 CORRIGÉ dans hybrid 1.16.11 et hybrid 1.17.1 apigee-connect-agent : premiers problèmes de blocage de Tether sur les clusters RKE2-on-GKE après la mise à niveau de la chaîne d'outils Go 1.26.3.

La connexion bloquée n'est pas détectable par le pod apigee-connect-agent. La cause principale fait toujours l'objet d'une enquête, mais elle pourrait être liée à Cloud NAT, qui est utilisé par nos clusters de test.

Solution : utilisez plusieurs pods apigee-connect-agent. Le deuxième pod sera opérationnel, et le premier réinitialisera la connexion après deux heures et deviendra opérationnel par la suite.
515424331 hybrid 1.16.3 CORRIGÉ dans hybrid 1.16.4 Le script apigee-pull-push.sh échoue sur la version 1.16.3, car certaines images transférées depuis la version 1.16.2 n'ont pas été taguées à nouveau avec le tag 1.16.3 dans le dépôt gcr.io/apigee-release/hybrid/.

Lorsque apigee-pull-push.sh (ou tout docker pull manuel) demandait une image concernée au niveau du tag 1.16.3, le registre renvoyait une erreur image not known et le script s'interrompait. Les mises à niveau effectuées via les charts Helm Apigee hybrid n'ont pas été affectées, car les charts référencent directement les condensés d'images corrects.

Solution : Pour chaque image concernée, extrayez le tag 1.16.2 au lieu de 1.16.3, ou passez directement à 1.16.4, qui republie toutes les images avec le tag correspondant.
512866352 hybrid 1.16.2 CORRIGÉ dans hybrid 1.16.3 Les stockages de secrets externes (comme HashiCorp Vault) ne fonctionnent pas avec l'image apigee-redis en raison d'une incompatibilité de version de glibc.

Solution : Ne configurez pas l'intégration du store de secrets externe (ESS) pour apigee-redis sur Apigee hybrid 1.16.2. Utilisez la configuration de secret par défaut jusqu'à ce qu'un correctif soit disponible.
415061771 Apigee
Apigee hybrid		 OUVERT Message d'erreur du contrôleur "Object has been modified" (L'objet a été modifié)

Les clients hybrides peuvent observer les messages récurrents "object has been modified; please apply your changes to the latest version and try again" (l'objet a été modifié ; veuillez appliquer vos modifications à la dernière version et réessayer) dans les journaux du contrôleur. Ces messages sont un effet secondaire inoffensif des mécanismes de sécurité intégrés d'Apigee et d'Apigee hybrid. Ils n'indiquent aucun risque pour les environnements Apigee ou Apigee hybrid. Pour garantir une fiabilité totale, le système est conçu pour vérifier et revérifier ses paramètres internes plusieurs fois par minute afin de s'assurer qu'ils correspondent exactement à la configuration souhaitée. Ces erreurs signifient que deux sous-contrôleurs ont tenté de mettre à jour leurs "spécifications" internes en même temps. La première mise à jour réussit, et la seconde génère le message et effectue la nouvelle mise à jour ultérieurement. Comme il s'agit de mises à jour administratives purement internes qui ne modifient pas la façon dont les API traitent le trafic, les services devraient rester stables et ne pas être affectés.
499322601 hybrid 1.16.0-hotfix.1,
hybrid 1.15.2,
hybrid 1.14.4		 CORRIGÉ dans hybrid 1.16.2 Apigee n'est pas compatible avec un proxy de transfert pour lequel l'authentification de base est appliquée.
495305258 Apigee (solution Marketplace) OUVERT Interruption du déploiement du portail Apigee Drupal via Cloud Marketplace

Nous sommes en train de faire évoluer la solution Apigee Drupal Portal Marketplace pour qu'elle utilise Infrastructure Manager au lieu de Cloud Deployment Manager. Pendant cette période de transition, certaines fonctionnalités de déploiement et de gestion peuvent ne pas être disponibles.

Impact :

  • Nouveaux déploiements : à partir du 1er avril 2026, toute tentative de déploiement d'une nouvelle instance de portail Apigee Drupal à l'aide du bouton "Déployer" de Cloud Marketplace pourra échouer.
  • Déploiements existants : vos ressources sous-jacentes (telles que les VM et les bases de données Cloud SQL) ne sont pas affectées et continueront de s'exécuter normalement. Toutefois, l'utilisation de fonctionnalités basées sur Deployment Manager pour gérer le déploiement via l'interface utilisateur de Cloud Marketplace ou l'outil gcloud deployment-manager peut échouer.

Solution : effectuez les modifications de configuration ou les tâches de gestion directement sur les ressources Google Cloud individuelles (Compute Engine, Cloud SQL, etc.). plutôt que via l'UI de Cloud Marketplace.
496552286 Apigee OUVERT Échec du déploiement des proxys de découverte MCP dans les régions présentant des limites de capacité.

Le déploiement de l'infrastructure MCP peut être soumis à des limites de capacité dans les régions suivantes :

  • asia-east2
  • asia-northeast3
  • asia-southeast2
  • australia-southeast1
  • europe-central2
  • europe-west12
  • europe-west9
  • me-central2
  • us-central2

Si vous voyez une erreur liée à l'échec du provisionnement de l'équilibreur de charge ou si l'état de provisionnement ne passe jamais à Déployé, cela peut être dû à des limites de capacité d'infrastructure temporaires dans la région sélectionnée. Essayez de déployer le proxy dans un environnement situé dans une autre région.
490308770 hybrid 1.12.x, hybrid 1.15.x, hybrid 1.16.0 CORRIGÉ dans 1.16.0-hotfix.1 et 1.15.2 Les configurations de proxy HTTP authentifiées échouent en raison de chaînes d'URL incorrectes dans les modèles Helm.

Lorsqu'un proxy sortant authentifié est configuré à l'aide de httpProxy.username et httpProxy.password, les charts Helm Apigee hybrid génèrent des chaînes http_proxy et https_proxy incorrectes. Les modèles injectent incorrectement des guillemets au milieu de l'URL, ce qui entraîne le plantage de composants tels que les pods de validation des garde-fous avec une erreur net/url: invalid userinfo.

Solution de contournement : modifiez manuellement les fichiers de modèle Helm pour supprimer la fonction quote des champs de nom d'utilisateur et de mot de passe dans la construction de l'URL du proxy. Par exemple, dans apigee-operator/templates/apigee-operators-guardrails.yaml, modifiez les définitions des variable d'environnement du proxy pour vous assurer que les identifiants ne sont pas placés individuellement entre guillemets dans la chaîne d'URL.
482077193 hybrid 1.15.0 et versions ultérieures CORRIGÉ dans 1.16.0-hotfix.1 Le chaînage de proxys échoue avec l'erreur 404 route_not_found dans les configurations multi-organisations à espace de noms unique.

Dans les environnements Apigee hybrid où plusieurs organisations partagent un même espace de noms Kubernetes, le chaînage de proxys peut échouer par intermittence avec une erreur HTTP 404 route_not_found. Cela se produit, car les passerelles de chaînage internes de différentes organisations utilisent le même sélecteur ingress_name, ce qui entraîne un chargement incohérent des règles de routage par Envoy.

Solution : attribuez un nom unique à la passerelle de chaînage pour chaque organisation de votre fichier overrides.yaml afin d'isoler les sélecteurs :

apigeeChainingGateway:
  name: internal-chaining-UNIQUE_SUFFIX

Assurez-vous également que vos sélecteurs d'hôte virtuel et tous les services Kubernetes dédiés sont mis à jour pour référencer ce nom unique.
479040521 hybrid 1.16.0 CORRIGÉ dans hybrid 1.16.0-hotfix.1 apigee-operator-guardrails-sa n'a pas été créé sur AKS/EKS avec la fédération d'identité de charge de travail.

Le ServiceAccount Kubernetes apigee-operator-guardrails-sa n'est pas créé lors de l'installation ou de la mise à niveau du chart apigee-operator dans Apigee Hybrid 1.16.0 sur les plates-formes non-GKE où Workload Identity (WIF) est activé.

Solution : corrigez manuellement le modèle de chart Helm apigee-operator :

  1. Modifiez le fichier de modèle de chart Helm apigee-operator apigee-operator/templates/apigee-operator-guardrails-sa.yaml.

    Mettez à jour la condition if initiale pour inclure la vérification de federatedWorkloadIdentity :

    {{ - if or (.Values.serviceAccountSecretProviderClass) (.Values.gcp.workloadIdentity.enabled) (.Values.gcp.federatedWorkloadIdentity.enabled) } }
  2. Modifiez le fichier de modèle de chart Helm apigee-operator/templates/apigee-operator-guardrails.yaml de apigee-operator (Remarque : il s'agit du fichier de modèle apigee-operator-guardrails.yaml, et non du fichier apigee-operator-guardrails-sa).

    Mettez à jour la condition if initiale à la ligne 17 immédiatement après spec: pour inclure la vérification de federatedWorkloadIdentity :

    {{ - if or (.Values.serviceAccountSecretProviderClass) (.Values.gcp.workloadIdentity.enabled) (.Values.gcp.federatedWorkloadIdentity.enabled) } }
  3. Appliquez les modifications au chart apigee-operator.
479872706 hybrid 1.16.0 (EKS avec WIF et proxy de transfert) CORRIGÉ dans hybrid 1.16.0-hotfix.1 Impossible de charger les produits d'API, les applications et les développeurs après la migration des données vers Apigee Hybrid 1.16.

Après la mise à niveau vers Apigee Hybrid 1.16.0, les environnements utilisant la fédération d'identité de charge de travail (WIF) conjointement avec un proxy de transfert HTTP peuvent ne pas charger les entités de gestion (produits d'API, applications, développeurs) en raison d'une régression de la conversion des identifiants dans MART.

Solution : Appliquez la mise à jour 1.16.0-hotfix.1 en mettant à jour les propriétés image.url et image.tag pour les composants de l'opérateur et de MART dans votre fichier overrides.yaml :

ao:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-operators"
    tag: "1.16.0-hotfix.1"
mart:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-mart-server"
    tag: "1.16.0-hotfix.1"
482209901 hybrid 1.16.0 CORRIGÉ dans hybrid 1.16.0-hotfix.1 Le déploiement du proxy ne se termine pas en raison d'autorisations RBAC manquantes dans Hybrid v1.16.0.

Il existe un problème connu dans la version 1.16.0, qui peut empêcher les clusters hybrides de signaler l'état de déploiement des proxys. Cela est dû à une autorisation manquante dans le rôle apigee-manager-role.

Solution : ajoutez l'autorisation au modèle de chart Helm apigee-operator :

  1. Modifiez le fichier de modèle de chart Helm apigee-operator apigee-operator/templates/apigee-operators.yaml.
  2. Ajoutez le verbe - watch à la ressource deployments, après le verbe - update à la ligne 584.
  3. Mettez à jour la version Helm apigee-operator.
418274570 hybrid 1.16.0 CORRECTION La page des notes de version d'Apigee Hybrid n'a pas été mise à jour avec les informations sur la version 1.16.0-hotfix.1.

La page des notes de version d'Apigee hybrid n'affiche pas les informations sur la mise à jour 1.16.0-hotfix.1. Pour en savoir plus sur la mise à jour, consultez les notes de version d'Apigee hybrid v1.16.0-hotfix.1.
484366184 hybrid 1.14.x, hybrid 1.15.x CORRIGÉ dans hybrid 1.16.0 Les versions 1.14 et 1.15 d'Apigee Hybrid rencontrent une boucle de plantage dans apigee-ingressgateway-manager lorsque l'API Kubernetes Gateway v1.4.0 ou une version ultérieure est utilisée.

Apigee Hybrid 1.16 n'est pas concerné par ce problème.

Solution : si vous devez utiliser l'API Kubernetes Gateway avec Apigee hybrid version 1.14 ou 1.15, installez la version 1.3.x de l'API Gateway. Exemple :

kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.3.0/standard-install.yaml

Voir également :
471125841 hybrid 1.14.x,hybrid 1.15.x CORRIGÉ dans hybrid 1.16.x Lorsqu'une nouvelle révision de proxy d'API est créée et déployée avec une valeur io.timeout.millis mise à jour, il est possible que la nouvelle valeur ne soit pas systématiquement respectée.

La valeur mise à jour de io.timeout.millis n'est pas respectée par intermittence pour les requêtes API. Cela se produit lorsque plusieurs serveurs sont utilisés sous <LoadBalancer> dans le TargetEndpoint.

Solution : après le déploiement du proxy d'API, redémarrez les pods apigee-runtime un par un pour que la modification soit correctement propagée.

480997525 Apigee 1-17-0-apigee-1 CORRIGÉ dans Apigee 1-17-0-apigee-2 Les appels de proxy échouent avec l'erreur The URI contain illegal characters après la mise à niveau de Netty.

Dans la version 1-17-0-apigee-1 d'Apigee, une mise à niveau de Netty vers la version 4.1.129.Final a introduit une régression. Cela peut entraîner l'échec des appels de proxy d'API avec un code d'état 400 et le message d'erreur The URI contain illegal characters. Ce problème est suivi en externe dans netty/netty#16020.

511240460 Mises à niveau d'hybrid 1.15.x vers hybrid 1.16.0 et versions ultérieures OPEN (aucune correction prévue) La mise à niveau de l'opérateur d'Apigee hybrid 1.15.x vers la version 1.16.x redémarre l'environnement d'exécution, le synchronisateur, MART, l'adaptateur Envoy et les pods de migration dans chaque environnement.

Apigee hybrid 1.16 ajoute un montage de volume au modèle de pod de ces composants. Lors de la première mise à niveau de l'opérateur de la version 1.15.x vers la version 1.16.x, les pods d'exécution, de synchronisation, MART, d'adaptateur Envoy et de migration redémarrent une fois dans chaque environnement. Ce redémarrage se produit, que la rotation des certificats soit activée ou non.

Chaque redémarrage est une mise à jour progressive. Chaque charge de travail exécute donc brièvement des pods supplémentaires (surutilisation). Dans un cluster comportant de nombreux environnements, ces pods de surutilisation démarrent tous en même temps.

Le planificateur de tâches Mint n'est pas redémarré. La modification est prise en compte lors de la prochaine exécution planifiée.

Le redémarrage n'a lieu qu'une seule fois, lors de la mise à niveau de la version 1.15.x vers la version 1.16.x. Les mises à niveau ultérieures, par exemple de la version 1.16.x vers la version 1.17.x, ne provoquent pas ce problème. Les versions ultérieures d'Apigee hybrid nécessitent l'installation du volume. Aucun correctif n'est donc prévu.

Solution : Avant de mettre à niveau l'opérateur, assurez-vous que votre cluster dispose d'une capacité suffisante pour les pods de surutilisation pour tous les environnements en même temps, ou effectuez la mise à niveau pendant une période de faible trafic.

Consultez les pages suivantes :
465834046 hybrid 1.14.3, hybrid 1.15.1 et hybrid 1.16.0 et versions ultérieures pour les mises à niveau CORRIGÉ dans hybrid 1.14.3, hybrid 1.15.1 et hybrid 1.16.0 pour les nouvelles installations Les versions 1.18 et ultérieures de cert-manager ont remplacé la valeur par défaut de la règle de rotation des clés privées de Never par Always. Si la clé privée de apigee-ca est alternée, cela aura un impact sur le trafic

Les versions plus récentes de cert-manager (v1.18+) effectuent désormais automatiquement la rotation des clés privées. La rotation de cette clé pour le certificat apigee-ca entraînera une interruption de service.

Solution : pour éviter ce problème, vous pouvez choisir l'une des options suivantes :

  • Ne mettez pas à niveau cert-manager vers une version supérieure à la version 1.17.x.
  • Modifiez le certificat apigee-ca dans l'espace de noms cert-manager et définissez spec.privateKey.rotationPolicy sur Never. Suivez la procédure ci-dessous pour modifier votre certificat apigee-ca et mettre à niveau cert-manager :
    1. Vérifiez le contenu de votre certificat apigee-ca pour voir si rotationPolicy est défini : 
      kubectl get certificate apigee-ca -n cert-manager -o yaml

      Recherchez les valeurs sous spec.privateKey dans le résultat :

      ...
spec:
  commonName: apigee-hybrid
  duration: 87600h
  isCA: true
  issuerRef:
    group: cert-manager.io
    kind: ClusterIssuer
    name: apigee-root-certificate-issuer
  privateKey:
    algorithm: ECDSA
    # Note: rotationPolicy would appear here if it is set.
    size: 256
  secretName: apigee-ca
...
    2. Si rotationPolicy n'est pas défini ou s'il est défini sur Always, modifiez le certificat apigee-ca pour définir la valeur de rotationPolicy sur Never :
      1. Effectuez d'abord un dry run : 
        kubectl patch Certificate \
  --dry-run=server \
  -n cert-manager \
  --type=json \
  -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \
  -o=yaml \
  apigee-ca
      2. Appliquez un correctif au certificat : 
        kubectl patch Certificate \
  -n cert-manager \
  --type=json \
  -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \
  -o=yaml \
  apigee-ca
    3. Vérifiez que la valeur de rotationPolicy est désormais définie sur Never : 
      kubectl get certificate apigee-ca -n cert-manager -o yaml

      Le résultat doit ressembler à ce qui suit :

      ...
spec:
  commonName: apigee-hybrid
  duration: 87600h
  isCA: true
  issuerRef:
    group: cert-manager.io
    kind: ClusterIssuer
    name: apigee-root-certificate-issuer
  privateKey:
    algorithm: ECDSA
    rotationPolicy: Never
    size: 256
  secretName: apigee-ca
...
    4. Mettez à niveau cert-manager. La commande suivante télécharge et installe cert-manager v0.14.2 : 
      kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v0.14.2/cert-manager.yaml

Consultez les pages suivantes :
458417250 Apigee 1-16-0-apigee-4 CORRIGÉ dans Apigee 1-16-0-apigee-6 Le processeur de messages renvoie une erreur 500 avec "Duplicate Header "authorization"".

Lorsque plusieurs en-têtes d'autorisation sont présents dans une requête, la passerelle d'entrée Apigee ne les concatène pas dans un seul en-tête. Le processeur de messages renvoie alors une erreur 500 avec un message "Duplicate Header "authorization"".

Solution : si plusieurs en-têtes d'autorisation sont présents dans la requête, concaténez-les en un seul en-tête. Exemple : 

curl -s https://my-hostname.net/mocktarget/echo \
          -H 'authorization: a, b'
462685598 UI OUVERT

L'UI Apigee ne permet actuellement pas de provisionner des organisations Apigee avec un Google-owned and Google-managed encryption key.

L'interface utilisateur d'Apigee ne permet pas de sélectionner un Google-owned and Google-managed encryption key lors du provisionnement des organisations d'abonnement.

Solution : utilisez les API Apigee pour créer des organisations par abonnement avec un Google-owned and Google-managed encryption key.

Comme indiqué dans la documentation de l'API Apigee, lors de la création de l'organisation Apigee, vous pouvez créer l'organisation à l'aide d'un Google-owned and Google-managed encryption key en ne fournissant pas de valeurs pour les champs runtimeDatabaseEncryptionKeyName, apiConsumerDataEncryptionKeyName et controlPlaneEncryptionKeyName.

460431753 Apigee, Apigee hybrid OUVERT Les règles Apigee Model Armor ne sont pas compatibles avec WebSockets.

Les règles Apigee Model Armor, y compris SanitizeUserPrompt et SanitizeModelResponse, ne fonctionnent actuellement pas comme prévu lorsqu'elles sont utilisées dans des proxys d'API gérant des connexions WebSocket. Pour en savoir plus sur la configuration de WebSocket, consultez WebSockets avec Apigee.
433759657 Apigee CORRIGÉ dans la version 1-16-0-apigee-3 ou ultérieure

Après la mise à niveau vers 1-16-0-apigee-3, certaines organisations Apigee peuvent rencontrer des erreurs HTTP 500 provenant d'une java.lang.NoClassDefFoundError dans une règle d'appel Java. L'erreur se présente comme suit : 

{"fault":{"faultstring":"Failed to execute JavaCallout. org/apache/commons/lang/StringUtils","detail":{"errorcode":"steps.javacallout.ExecutionError"}}}

Cette erreur se produit lorsqu'une règle d'appel Java dépend de manière incorrecte de bibliothèques destinées à un usage interne d'Apigee au lieu de fournir ses propres dépendances.

Action requise : pour éviter ce problème, les développeurs doivent s'assurer que tous les appels Java sont autonomes et utilisent leurs propres bibliothèques dédiées, en évitant de dépendre du chemin de classe interne d'Apigee.

Dans le proxy d'API qui utilise la bibliothèque JAR Apache Commons, importez le fichier JAR Apache Commons à inclure en tant que ressource pour le proxy. Pour en savoir plus, consultez les consignes concernant les ressources Java.

451841788 hybrid 1.14.3 et hybrid 1.15.1 CORRECTION Apigee hybrid nécessite la propriété mintTaskScheduler.serviceAccountPath même lorsque la monétisation n'est pas activée.

La mise à niveau du graphique apigee-org peut échouer si la propriété mintTaskScheduler.serviceAccountPath n'est pas définie, même si la monétisation n'est pas activée : 

Error: UPGRADE FAILED: execution error at (apigee-org/templates/mint-task-scheduler-gsa-secret.yaml:12:63): mintTaskScheduler.serviceAccountPath is required!

Solution : supprimez les fichiers apigee-org/templates/mint-task-scheduler-gsa-secret.yaml et apitee-org/templates/mint-task-scheduler-sa.yaml.

Vous pouvez éventuellement déplacer les fichiers vers un emplacement distinct en dehors du répertoire du chart Helm. Vous pouvez également les télécharger à nouveau si vous souhaitez activer la monétisation ultérieurement, en suivant les instructions de l'Étape 2 : Télécharger les charts Helm Apigee.

Par exemple, à partir du répertoire helm-charts/ :

  1. ls apigee-org/templates/

    Résultat :

    apigee-org-guardrails.yaml              mart-sa.yaml
apigee-proxy-chaining-certificate.yaml  mint-task-scheduler-gsa-secret.yaml
apigee-proxy-chaining-route.yaml        mint-task-scheduler-sa.yaml
ax-hash-salt-secret.yaml                NOTES.txt
connect-agent-gsa-secret.yaml           organization.yaml
connect-agent-sa.yaml                   udca-gsa-secret.yaml
data-encryption-secret.yaml             udca-sa.yaml
encryption-keys-secret.yaml             watcher-gsa-secret.yaml
_helpers.tpl                            watcher-sa.yaml
mart-gsa-secret.yaml
  2. (Facultatif) : 
    cp apigee-org/templates/mint-task-scheduler-gsa-secret.yaml /tmp/
cp apigee-org/templates/mint-task-scheduler-sa.yaml /tmp/
  3. rm apigee-org/templates/mint-task-scheduler-gsa-secret.yaml
  4. rm apigee-org/templates/mint-task-scheduler-sa.yaml
  5. ls apigee-org/templates/

    Résultat :

    apigee-org-guardrails.yaml              mart-gsa-secret.yaml
apigee-proxy-chaining-certificate.yaml  mart-sa.yaml
apigee-proxy-chaining-route.yaml        NOTES.txt
ax-hash-salt-secret.yaml                organization.yaml
connect-agent-gsa-secret.yaml           udca-gsa-secret.yaml
connect-agent-sa.yaml                   udca-sa.yaml
data-encryption-secret.yaml             watcher-gsa-secret.yaml
encryption-keys-secret.yaml             watcher-sa.yaml
_helpers.tpl
451375397 hybrid 1.14.3 CORRIGÉ dans hybrid 1.15.1

Le script apigee-pull-push.sh peut renvoyer un message d'erreur No such image, par exemple :

Error response from daemon: No such image: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:latest

Solution : modifiez le script HELM_CHARTS_DIR/apigee-operator/etc/tools/apigee-pull-push.sh pour remplacer la ligne 114 de la fonction docker_tag() : 

  docker tag "${source}/$i" "${dest}/$i:${TAG}"

À : 

  docker tag "${source}/$i:${TAG}" "${dest}/$i:${TAG}"
405936071 hybrid 1.15.0 CORRIGÉ dans hybrid 1.15.1

Lorsque metrics.serviceAccountRef ou metrics.serviceAccountSecretProviderClass est spécifié dans le fichier overrides.yaml, le rôle de télémétrie cible le mauvais compte de service.

Solution : appliquez un correctif à _helper.tpl dans le graphique apigee-operator/ et réappliquez-le.

  1. Modifiez apigee-operator/templates/_helpers.tpl et supprimez les lignes suivantes en gras : 

    {{- define "metricsSA" -}}
  {{- $metricsName := "apigee-metrics" }}
  {{- $telemetryName := "apigee-telemetry" -}}
  {{- $generatedName := include "orgScopeEncodedName" (dict "name" .Values.org) -}}
  {{- if .Values.gcp.workloadIdentity.enabled -}}
  {{- printf "%s-sa" $metricsName -}}
  {{- else if .Values.serviceAccountSecretProviderClass -}}  <-- DELETE
  {{- .Values.serviceAccountSecretProviderClass -}}          <-- DELETE
  {{- else if .Values.metrics.serviceAccountRef -}}          <-- DELETE
  {{- .Values.metrics.serviceAccountRef -}}                  <-- DELETE
  {{- else if .Values.multiOrgCluster -}}
  {{- printf "%s-%s" $metricsName $generatedName -}}
  {{- else -}}
  {{- printf "%s-%s" $metricsName $telemetryName -}}
  {{- end -}}
{{- end -}}

    La section obtenue doit se présenter comme suit : 

    {{- define "metricsSA" -}}
  {{- $metricsName := "apigee-metrics" }}
  {{- $telemetryName := "apigee-telemetry" -}}
  {{- $generatedName := include "orgScopeEncodedName" (dict "name" .Values.org) -}}
  {{- if .Values.gcp.workloadIdentity.enabled -}}
  {{- printf "%s-sa" $metricsName -}}
  {{- else if .Values.multiOrgCluster -}}
  {{- printf "%s-%s" $metricsName $generatedName -}}
  {{- else -}}
  {{- printf "%s-%s" $metricsName $telemetryName -}}
  {{- end -}}
{{- end -}}

  2. Appliquez à nouveau le graphique apigee-operator. 

    helm upgrade operator apigee-operator/ \
    --namespace APIGEE_NAMESPACE \
    --atomic \
    -f overrides.yaml
419856132 hybrid 1.14.2 et versions ultérieures CORRIGÉ dans hybrid 1.14.3 et hybrid 1.15.0 Si gateway.networking.k8s.io/v1 est installé dans votre cluster,la mise à niveau de apigee-ingressgateway-manager peut échouer.

Pour contourner ce problème, suivez la procédure décrite dans Problème connu 416634326.

378686709 Apigee
Apigee hybrid		 CORRIGÉ dans Apigee (demande d'assistance requise)
CORRIGÉ dans hybrid 1.14.3 et hybrid 1.15.1 (procédure requise)

L'utilisation de caractères génériques (*) dans les chemins de base des proxys Apigee peut entrer en conflit avec d'autres chemins de base explicites, ce qui entraîne une erreur 404. Par exemple, l'utilisation des chemins de base suivants pour deux proxys déployés dans le même environnement peut entraîner une erreur 404 lors de l'appel de Proxy-2 : 

Proxy-1: /a/v1/b
Proxy-2: /a/*/c

Dans ce cas, les appels au chemin de base explicite aboutiront, mais les appels à Proxy-2 pourront renvoyer une erreur 404 si le chemin générique est évalué comme /a/v1/c.

Corrigé : ce problème est résolu dans Apigee et dans la version 1.14.3 et ultérieures d'Apigee hybrid. Toutefois, le correctif n'est pas activé par défaut. Si vous souhaitez activer l'utilisation de caractères génériques dans les chemins de base :

  • Les clients disposant d'organisations Apigee doivent contacter l'assistance Apigee pour activer le correctif si nécessaire.
  • Les clients disposant d'organisations Apigee hybrid doivent suivre la procédure ci-dessous pour activer le correctif si nécessaire.

Procédure : Pour activer l'utilisation de caractères génériques (*) dans les chemins de base des proxys Apigee dans Apigee hybrid :

  1. Ajoutez le stanza suivant à votre fichier overrides.yaml avant de passer à la version 1.14.3 ou ultérieure d'Apigee hybrid : 
    runtime:
  cwcAppend:
    conf_message-processor-communication_classificationV2.enabled: "true"
  2. Appliquez les modifications au chart apigee-env. Répétez la modification pour chaque environnement de votre installation. 
    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
    • ENV_RELEASE_NAME est un nom utilisé pour suivre l'installation et les mises à niveau du chart apigee-env. Ce nom doit être différent des autres noms de version Helm de votre installation. Il s'agit généralement de la même valeur que ENV_NAME. Toutefois, si votre environnement porte le même nom que votre groupe d'environnements, vous devez utiliser des noms de version différents pour l'environnement et le groupe d'environnements, par exemple dev-env-release et dev-envgroup-release. Pour en savoir plus sur les versions dans Helm, consultez Trois grands concepts dans la documentation Helm.
    • ENV_NAME est le nom de l'environnement que vous mettez à niveau.
    • OVERRIDES_FILE est votre fichier de remplacement.
  3. Passez à la version 1.14.3 ou ultérieure d'Apigee hybrid.
382565315 hybrid 1.13.0,
hybrid 1.13.1,
hybrid 1.13.2,
hybrid 1.14.0		 CORRIGÉ dans hybrid 1.13.3 et hybrid 1.14.1

L'utilisation de LogTimer dans SecurityPolicy peut entraîner une fuite de mémoire.

Dans certains cas, les threads de l'enregistreur d'Apigee hybrid peuvent consommer toute la mémoire disponible. Par exemple, des entrées de journal fréquentes documentant des erreurs d'autorisation associées à JavaCallout peuvent provoquer une erreur de mémoire insuffisante.

421190799 Apigee CORRIGÉ dans Apigee 1-15-0-apigee-7

Le processeur d'extension Apigee ne prend pas en charge le traitement de plus de 100 ko de données dans le cadre des événements de corps de requête et de réponse.
432315283 Apigee OUVERT

Lorsque vous mettez à jour un keystore ou un truststore sans en créer un, les mises à jour de l'environnement d'exécution peuvent échouer et provoquer l'erreur intermittente suivante : 

  {"fault":{"faultstring":"SSL Handshake failed sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target","detail":{"errorcode":"messaging.adaptors.http.flow.SslHandshakeFailed"}}}

L'erreur est intermittente, car la mise à jour du keystore ou du truststore peut échouer sur un pod d'exécution, mais réussir sur d'autres pods. Pour éviter ce problème, mettez à jour le keystore ou le truststore en créant un nouveau keystore ou truststore. Redirigez votre référence vers le nouveau keystore ou truststore, comme décrit dans Lorsqu'un certificat expire.
412740465 hybrid 1.14.0 et versions ultérieures CORRIGÉ dans hybrid 1.14.3 et hybrid 1.15.1

À partir de la version 1.14.0 d'Apigee hybrid, l'ajout automatique d'en-têtes de trace Zipkin (x-b3-*) a été supprimé.

N/A

 Apigee hybrid OUVERT Si vous configurez le transfert de proxy non-API à l'aide de httpProxy sans définir également envs.httpProxy, la configuration du proxy ne sera pas appliquée aux appels externes de l'environnement d'exécution Apigee vers des services tels que Pub/Sub ou d'autres API Google Cloud.

Si vous ne spécifiez que httpProxy, vous devez également vous assurer que *.googleapis.com est ajouté à la liste d'autorisation de vos pods d'exécution Apigee pour permettre la connectivité à ces services.

Consultez Configurer le proxy de transfert pour les proxys d'API.

416634326 hybrid 1.14.2 et versions ultérieures CORRIGÉ dans hybrid 1.14.3 et hybrid 1.15.1

La présence de définitions de ressources personnalisées (CRD) istio.io dans un cluster Apigee hybrid peut entraîner l'échec des pods apigee-ingressgateway-manager.

Lors de la mise à niveau d'Apigee hybrid d'une version antérieure vers la version 1.14.2 ou ultérieure, la présence de CRD istio.io existants peut entraîner l'échec des vérifications d'aptitude dans les conteneurs discovery des pods apigee-ingressgateway-manager.

Solution : Les CRD istio.io ne sont pas requis par Apigee hybrid v1.14.2 ou version ultérieure. Vous pouvez résoudre ce problème de deux manières :

  • Supprimez les CRD istio.io si vous n'utilisez pas Istio à d'autres fins qu'Apigee dans votre cluster.
  • Mettez à jour apigee-ingressgateway-manager clusterrole pour ajouter des autorisations pour istio.io.

Après avoir appliqué l'une des options ci-dessus, vous devrez redémarrer vos pods apigee-ingressgateway-manager.

Supprimer les CRD

  1. Répertoriez les CRD istio.io de votre cluster dans un fichier CSV : 
    kubectl get crd -o custom-columns=NAME:metadata.name | grep istio.io > istio-crd.csv
  2. Facultatif : Enregistrez les CRD localement au cas où vous devriez les recréer : 
    kubectl get crd $(cat istio-crd.csv) -o yaml > istio-crd.yaml
  3. Supprimez les CRD istio.io :

    Effectuez un dry run :

    kubectl delete crd $(cat istio-crd.csv) --dry-run=client

    Exécution :

    kubectl delete crd $(cat istio-crd.csv)

Mettre à jour le clusterrole

  1. Obtenez le clusterrole apigee-ingressgateway-manager actuel : 
    kubectl get clusterrole apigee-ingressgateway-manager-apigee -o yaml > apigee-ingressgateway-manager-apigee-clusterrole.yaml
  2. Copiez le clusterrole vers un nouvel emplacement : 
    cp apigee-ingressgateway-manager-apigee-clusterrole.yaml apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml
  3. Ajoutez les autorisations supplémentaires suivantes à la fin du fichier : 
    - apiGroups:
  - gateway.networking.k8s.io
  resources:
  - gatewayclasses
  - gateways
  - grpcroutes
  - httproutes
  - referencegrants
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - networking.istio.io
  resources:
  - sidecars
  - destinationrules
  - gateways
  - virtualservices
  - envoyfilters
  - workloadentries
  - serviceentries
  - workloadgroups
  - proxyconfigs
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - security.istio.io
  resources:
  - peerauthentications
  - authorizationpolicies
  - requestauthentications
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - telemetry.istio.io
  resources:
  - telemetries
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - extensions.istio.io
  resources:
  - wasmplugins
  verbs:
  - get
  - list
  - watch
  4. Appliquez le rôle : 
    kubectl -n APIGEE_NAMESPACE apply -f apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml

Après avoir effectué les opérations ci-dessus, vous devrez redémarrer vos pods apigee-ingressgateway-manager.

  1. Répertoriez les pods ingress-manager à réinstaller ou à recréer : 
    kubectl get deployments -n APIGEE_NAMESPACE

    Exemple de résultat :

    NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager       1/1     1            1           32d
apigee-ingressgateway-manager   2/2     2            2           32d
  2. Redémarrez les pods ingress-manager : 
    kubectl rollout restart deployment -n APIGEE_NAMESPACE apigee-ingressgateway-manager
  3. Après quelques minutes, surveillez les pods apigee-ingressgateway-manager : 
    watch -n 10 kubectl -n APIGEE_NAMESPACE get pods -l app=apigee-ingressgateway-manager

    Exemple de résultat :

    NAME                                             READY   STATUS    RESTARTS   AGE
apigee-ingressgateway-manager-12345abcde-678wx   3/3     Running   0          10m
apigee-ingressgateway-manager-12345abcde-901yz   3/3     Running   0          10m
414499328 hybrid 1.14.1 CORRIGÉ dans hybrid 1.14.3 et hybrid 1.15.0

ApigeeTelemetry peut se bloquer à l'état creating.

Ce problème a été constaté sur les installations OpenShift.

Solution : modifiez le modèle de graphique apigee-operator pour créer l'accès clusterrole approprié.

  1. Modifiez le fichier de modèle helm-charts/apigee-operator/templates/apigee-operators.yaml et recherchez la définition du clusterrole -apigee-manager-role-. Voici leur description : 
    kind: ClusterRole
metadata:
  name: apigee-manager-role-{{ include 'namespace' }}
rules:
  ...
  2. Recherchez le bloc - apiGroups: apiregistration.k8s.io et ajoutez la ressource apiservices/finalizers à la liste des ressources : 
    - apiGroups:
  - apiregistration.k8s.io
  resources:
  - apiservices
  - apiservices/finalizers
  verbs:
  - create
  - delete
  - get
  - patch
  - update
  3. Recherchez le bloc - apiGroups: authorization.k8s.io, puis ajoutez le bloc - apiGroups: apigee.cloud.google.com après la fin du bloc avec le texte suivant : 
    - apiGroups:
  - apigee.cloud.google.com
  resources:
  - apigeetelemetries/finalizers
  verbs:
  - get
  - patch
  - update

    Exemple :

    - apiGroups:
  - authorization.k8s.io
  resources:
  - subjectaccessreviews
  verbs:
  - create
  - get
  - list
- apiGroups:
  - apigee.cloud.google.com
  resources:
  - apigeetelemetries/finalizers
  verbs:
  - get
  - patch
  - update
  4. Appliquez les modifications au chart apigee-operator :

    Effectuez un dry run :

    helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE \
  --dry-run=server

    Mettez à niveau le chart :

    helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE \
402739748 Apigee OUVERT

Les produits d'API sont limités à 50 chemins d'accès. Si vous ajoutez des chemins d'accès supplémentaires, un message d'erreur s'affiche : Operation group limit of 51 exceeded in Operation Config

Solution : utilisez des modèles de caractères génériques pour combiner des chemins de ressources et des opérations, comme décrit dans Configurer des chemins de ressources.

Solution : créez plusieurs produits d'API. Cette solution de contournement a été vérifiée et est viable pour les utilisateurs qui ajoutent de nombreux proxys d'API à un produit d'API. L'application associée à vos produits d'API doit être mise à jour pour inclure le nouveau produit, mais il a été prouvé que les identifiants et les détails de la requête côté client n'ont pas besoin d'être modifiés.

291294211 Apigee OUVERT

Erreur lors de l'utilisation des API rapport personnalisé et Stats lors de la sélection par type de frais pour les installations utilisant la monétisation.

Solution : Récupérez tous les types de frais côté client avant de filtrer.

391140293 Apigee
Apigee hybrid		 CORRECTION

Le scaling des pods d'entrée Istio peut entraîner une erreur 503.

Le scaling des pods d'entrée Istio peut parfois provoquer une erreur 503. Si une erreur 503 se produit, les journaux de l'équilibreur de charge affichent le message suivant : statusDetails: backend_connection_closed_before_data_sent_to_client.

Solution : effectuez un scaling manuel des pods d'entrée Istio.

368155212 hybrid 1.14.0
hybrid 1.14.1		 CORRIGÉ dans hybrid 1.14.2

La rotation des identifiants Cassandra ESS et non-ESS ne fonctionne pas dans les organisations avec des limites de proxy améliorées.

Le trafic d'exécution n'est pas affecté.

401624396 hybrid 1.13.x
hybrid 1.14.x		 OUVERT Le job de restauration Apigee échoue lors de la restauration des sauvegardes de fournisseurs de services cloud GCP ou HYBRID effectuées à partir d'une configuration multirégionale. Ce problème n'affecte pas la restauration de CSI.

Les sauvegardes effectuées à partir de la configuration multirégionale à l'aide des fournisseurs de services cloud GCP et HYBRID contiennent des informations sur toutes les régions hybrides qui existaient au moment de la capture de l'instantané. Comme ces régions n'existent plus, le job de restauration entrera en conflit avec l'état actuel de Cassandra et échouera avec l'erreur suivante : Unrecognized strategy option passed to NetworkTopologyStrategy.

401746333 Apigee
hybrid 1.12.4
hybrid 1.13.3
hybrid 1.14.1		 CORRECTION

La bibliothèque Nimbus JOSE + JWT peut provoquer une erreur java.lang.ClassCircularityError lors de l'utilisation d'une règle JavaCallout .

Si vous disposez d'une organisation Apigee hybrid avec une règle JavaCallout qui utilise la bibliothèque Nimbus JOSE + JWT, ne passez pas à la version 1.12.4, 1.13.3 ou 1.14.1 d'Apigee hybrid.
397693324 hybrid 1.14.0
hybrid 1.14.1		 CORRIGÉ dans hybrid 1.14.2

La rotation des identifiants Cassandra multirégionaux ESS et non-ESS échouera dans toutes les régions, sauf la première.

Le trafic d'exécution n'est pas affecté.

Suivez la solution de contournement fournie pour résoudre ce problème.

391861216 hybrid 1.13.x
hybrid 1.14.x		 CORRIGÉ dans hybrid 1.13.3 et hybrid 1.14.1 Le redémarrage des pods Cassandra sur un cluster hybride restauré à l'aide des fournisseurs de services cloud GCP ou HYBRID entraîne le passage des pods à l'état CrashLoopBackoff. Ce problème n'affecte pas la restauration de CSI.

Les pods Cassandra seront redémarrés après l'application des modifications de remplacement de Cassandra, par exemple lors de la réactivation de la sauvegarde, ce qui déclenchera ce problème. Les journaux d'un pod Cassandra à l'état CrashLoopBackoff affichent l'erreur suivante : Cannot change the number of tokens from 512 to 256.

Suivez la solution de contournement fournie pour résoudre ce problème.

388608440 hybrid 1.11.x
hybrid 1.12.x		 CORRIGÉ dans hybrid 1.12.4 et versions ultérieures Le job de sauvegarde Apigee ne nettoie pas les instantanés intermédiaires Cassandra.

Dans de rares cas, le job de sauvegarde Apigee ne nettoie pas les instantanés intermédiaires Cassandra qu'il crée lors de la sauvegarde à l'aide des fournisseurs de services cloud HYBRID ou GCP. Cela ne se produit que si un problème sous-jacent empêche le processus de sauvegarde de se connecter au serveur distant ou à Cloud Storage. Si le problème de connexion persiste, ces instantanés Cassandra restants peuvent s'accumuler au fil du temps, en utilisant l'espace de stockage sur les disques de Cassandra. Si vous êtes concerné, veuillez résoudre le problème de connexion sous-jacent, puis suivez les étapes décrites dans le guide de dépannage Cassandra pour effacer manuellement les instantanés Cassandra.

392135466 hybrid 1.14.0 OUVERT Le chaînage de proxys avec mTLS n'est pas disponible lorsque vous utilisez les limites de proxy par environnement améliorées.
383334511 Apigee OUVERT Entrée KVM créée avec un nom inattendu

Lorsqu'une règle KeyValueMapOperations est utilisée avec le champ d'application apiproxy et que l'opération <Put> de la règle est appelée dans un flux partagé via un hook de flux, l'entrée KVM est créée sous le nom du flux partagé. Il doit être créé sous le nom du proxy d'API.

384937220

 hybrid 1.14.0 CORRECTION La création d'une version Helm peut échouer s'il existe plusieurs hôtes virtuels.

En présence de plusieurs hôtes virtuels, la création de la version Helm peut échouer en raison de noms ApigeeRoute en conflit. La solution consiste à exécuter les commandes suivantes pour chaque hôte virtuel lors de la création :

kubectl annotate ar apigee-ingressgateway-internal-chaining-PROJECT_ID_SUFFIX -n APIGEE_NAMESPACE meta.helm.sh/release-name=NEW_ENV_GROUP_NAME --overwrite
kubectl annotate cert apigee-ingressgateway-internal-chaining-PROJECT_ID_SUFFIX -n APIGEE_NAMESPACE meta.helm.sh/release-name=NEW_ENV_GROUP_NAME --overwrite

où :

  • PROJECT_ID_SUFFIX est un suffixe unique pour le chaînage interne de votre projet dans Kubernetes. Vous pouvez trouver ce suffixe à l'aide de la commande suivante : 
    kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining

    Le résultat doit se présenter sous la forme suivante :

    kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining
apigee-ingressgateway-internal-chaining-my-project--1234567    ClusterIP  34.118.226.140  <none>    15021/TCP,443/TCP    5d6h

    Dans l'exemple de résultat, my-project--1234567 est le PROJECT_ID_SUFFIX.

  • APIGEE_NAMESPACE est votre espace de noms Apigee.
  • NEW_ENV_GROUP_NAME est le nom du groupe d'environnements supplémentaire. Mettez à jour cette valeur pour chaque hôte virtuel.

N/A

 Apigee hybrid OUVERT Un compte de service non valide peut envoyer l'API UpdateControlPlaneAccess dans une boucle de nouvelle tentative.

Si un utilisateur fournit un compte de service non valide à l'API UpdateControlPlaneAccess, l'opération entre dans une boucle de nouvelles tentatives, ce qui empêche l'organisation d'appeler l'API jusqu'à l'expiration du délai d'attente de l'opération.
373722434 hybrid 1.13.x CORRIGÉ à partir de la version 1.13.2 d'Apigee hybrid Le job de sauvegarde Apigee ne peut pas importer de données dans des buckets Cloud Storage avec des règles de conservation.

Lorsque vous utilisez le fournisseur de services cloud GCP, le job de sauvegarde Apigee ne peut pas importer de données dans des buckets Cloud Storage avec des règles de conservation. Les fichiers de sauvegarde peuvent être laissés dans le bucket Cloud Storage avec une taille de fichier de 0 octet.

Solution : désactivez les règles de conservation sur le bucket Cloud Storage.

341099433

 Apigee hybrid OUVERT Le composant apigee-logger n'est pas compatible avec la fédération d'identité de charge de travail.

apigee-logger utilise des comptes de service Google IAM pour envoyer des journaux à Cloud Logging. Cela est dû au fait que FluentBit n'est pas compatible avec la fédération d'identité de charge de travail, ce qui empêche apigee-logger d'utiliser cette fonctionnalité.

Non disponible

 Apigee hybrid OUVERT La trace distribuée dans Apigee hybrid n'est pas compatible avec les organisations utilisant la résidence des données.

Non disponible

 Apigee OUVERT Apigee n'est pas compatible avec le rechiffrement des clés. Par conséquent, même après la rotation, l'ancienne version de clé est toujours utilisée et vous ne pouvez pas modifier la clé CMEK après la création de l'organisation.

270574696

 Apigee CORRECTION Apigee n'est pas compatible avec Cloud External Key Manager.

268104619

 Apigee
Apigee hybrid		 OUVERT Dans la règle OASValidation, lorsque vous spécifiez un type de tableau dans l'en-tête, le processeur de messages génère une erreur, même si l'entrée est valide.

364872027

 Apigee
Apigee hybrid		 CORRECTION Erreur d'analyse PEM dans les règles JWT/JWS en raison d'un format non standard

Pour Apigee et Apigee hybrid versions 1.13 et ultérieures, tout écart par rapport au format PEM requis des clés utilisées dans les règles JWS ou JWT d'Apigee peut entraîner une erreur d'analyse. Par exemple, placer un caractère autre qu'un saut de ligne (/n) immédiatement avant la ligne "-----END" (limite de post-encapsulation) n'est pas autorisé et entraîne une erreur.

Pour éviter cette erreur, assurez-vous qu'aucun caractère autre qu'un saut de ligne, tel que des espaces de fin ou des barres obliques, ne précède immédiatement la limite de post-encapsulation.

Pour en savoir plus sur l'encodage utilisé pour les clés publiques ou privées, consultez la section sur la norme IETF RFC 7468.

310191899

 Apigee
Apigee hybrid		 OUVERT Délais avant expiration lors du déploiement de proxys d'API et de flux partagés

Les points de terminaison suivants peuvent faire l'objet de délais avant expiration lorsqu'ils sont utilisés avec un volume élevé de requêtes par seconde (RPS) :

Pour réduire la probabilité de délais avant expiration, nous vous recommandons de cibler 1 RPS lorsque vous utilisez ces points de terminaison ou de vérifier l'état d'un déploiement avant d'en tenter un autre.

329304975

 Apigee CORRECTION Limite du nombre de chemins de base par environnement

Apigee applique une limite temporaire de 1 000 chemins de base par environnement pour éviter les échecs potentiels lors du déploiement des révisions de proxy d'API.

Tant que cette limite est en place, vous pouvez déployer jusqu'à 1 000 révisions de proxy d'API (chacune contenant un seul chemin de base) par environnement. Si vos proxys d'API ou vos révisions contiennent plusieurs chemins de base, le nombre total de chemins de base par environnement ne doit pas dépasser 1 000.

333791378

 hybrid 1.12.0 OUVERT Fonctionnalités de sauvegarde et de restauration Cassandra non compatibles avec l'outil de migration Helm

Pour connaître la procédure d'installation d'un correctif pour la solution, consultez la section Dépannage.

310384001

 hybrid 1.11.0 OUVERT Les échecs de validation de certification peuvent renvoyer une réponse d'erreur 502 au lieu d'une réponse d'erreur 503 lorsque les utilisateurs ajoutent le tag <Enforce>true</Enforce> dans le bloc <SSLInfo> cible pour la validation par défaut des certificats de point de terminaison cible TLS.

289583112

 Apigee OUVERT La règle OASValidation ne fonctionne pas avec les exigences de sécurité globales dans les spécifications OpenAPI

Si la règle OASValidation spécifie une ressource <OASResource> avec des exigences de sécurité définies au niveau global, les exigences de sécurité ne sont pas appliquées.

Solution : Pour garantir qu'elles soient appliquées, toutes les exigences de sécurité doivent être définies au niveau de l'opération dans la spécification OpenAPI transmise dans l'élément <OASResource> de la règle OASValidation.

205666368

 Apigee
hybrid 1.10.2
hybrid 1.10.3		 CORRECTION dans Apigee 1-10-0-apigee-6 et
Hybrid 1.10.3-hotfix.1		 Apigee hybrid ne valide pas le certificat cible par défaut.

Consultez la section À propos de la définition des options TLS dans un point de terminaison cible ou un serveur cible.

295929616

 hybrid 1.10.0 et versions ultérieures CORRIGÉ dans hybrid 1.10.3 L'installation d'Apigee hybrid 1.10 sur OpenShift (OSE) peut échouer avec des erreurs de mémoire saturée.

L'installation ou la mise à niveau vers les versions 1.10.0 à 1.10.2 d'Apigee hybrid peut échouer sur OSE en raison de problèmes de mémoire saturée. Corrigé dans la version 1.10.3 Apigee hybrid.

292118812

 hybrid 1.10.1 CORRECTION apigee-udca peut ne pas respecter les paramètres proxy HTTP.

Si le pare-feu force tout le trafic via un proxy de transfert, apigee-udca peut passer à l'état de boucle de plantage en cas d'interruption.

292558790

 Apigee
hybrid 1.8.0 et versions ultérieures		 OUVERT La règle OASValidation échoue et renvoie l'erreur Unable to parse JSON.
  • La stratégie OASValidation échoue lorsque le contenu JSON ne correspond pas au format attendu. Par exemple, si un en-tête attend une valeur au format <text>@<text> et qu'il est renseigné avec du texte sans le symbole @, la règle échouera avec une erreur Unable to parse JSON.
  • Si la règle OASValidation spécifie une ressource <OASResource> contenant un paramètre path qui utilise un schéma $ref, la règle échoue et renvoie une erreur Unable to parse JSON - Unrecognized token.

    Solution : n'utilisez pas $ref dans les paramètres path de la spécification OpenAPI spécifiée dans l'élément <OASResource>.

297012500

 Apigee
hybrid 1.8.0 et versions ultérieures		 OUVERT Problèmes de déploiement avec la validation OAS lors de l'utilisation de références circulaires
  • Le déploiement Apigee échouera pour la règle de validation OAS lors de l'utilisation de références circulaires pour la spécification OpenAPI 3.0.0 car elle entre dans une boucle infinie.

    • Solution : utilisez un fichier YAML de spécification OpenAPI sans références circulaires.

289254725

 Apigee
Apigee 1-10-0-apigee-3
hybrid 1.8.8
hybrid 1.9.3		 CORRIGÉ dans Apigee 1-10-0-apigee-5
CORRIGÉ dans Apigee hybrid		 Les déploiements de proxy qui incluent la règle OASValidation peuvent échouer.

Les déploiements de proxy qui incluent la règle OASValidation peuvent échouer si les deux conditions suivantes sont remplies :

  • La spécification OpenAPI utilisée pour la validation dans la règle OASValidation est au format YAML.
  • La spécification OpenAPI au format YAML contient un nombre flottant. Exemple : 
    schema:
type: number
example: 2.345

284500460

 Apigee
Apigee 1-10-0-apigee-1		 CORRECTION Augmentation de la latence de la règle de journalisation des messages lorsqu'elle est utilisée avec Cloud Logging.

Pour éviter d'augmenter la latence des réponses au client, la règle de journalisation des messages doit être associée au PostClientFlow. Pour en savoir plus sur l'utilisation des règles dans les PostClientFlows, consultez la section Contrôler des proxys d'API avec des flux.

282997216

 hybrid 1.8.0 et versions ultérieures
hybrid 1.9.0 et versions ultérieures		 OUVERT Caractères spéciaux non autorisés dans le mot de passe Cassandra Jolokia

N'utilisez que des caractères alphanumériques pour le mot de passe Cassandra Jolokia. L'utilisation de caractères spéciaux (y compris, mais sans s'y limiter, "!", "@", "#", "$", "%", "^", "&" et "*") peut faire échouer le démarrage de Cassandra.

270371160

 hybrid 1.9.0 et versions ultérieures CORRECTION La passerelle d'entrée Apigee n'accepte que le protocole/les algorithmes de chiffrement TLS1.2+

La passerelle d'entrée Apigee n'accepte que TLS1.2+. Elle n'est pas compatible avec les versions antérieures de TLS.

269139342

 hybrid 1.7.0 et versions ultérieures CORRECTION apigeectl getOrg ne suit pas les paramètres HTTP_PROXY dans overrides.yaml

La validation de l'organisation Apigee ne respecte pas les règles de proxy de transfert HTTP définies dans overrides.yaml. Définissez validateOrg: false pour ignorer cette validation.

266452840

 Apigee
hybrid 1.7.0 et versions ultérieures
hybrid 1.8.0 et versions ultérieures
hybrid 1.9.0 et versions ultérieures		 CORRECTION Les sockets Web ne fonctionnent pas avec Anthos Service Mesh 1.15.3 dans Apigee X et Apigee Hybrid

Dans certaines circonstances, les sockets Web ne fonctionnent pas pour Apigee X et Apigee Hybrid lorsque vous utilisez Anthos Service Mesh 1.15.3-asm.6.

287922301

 Apigee OUVERT Inexactitudes dans les taux de monétisation autour des seuils de volume

En raison de la conception actuelle, des taux de monétisation inexacts peuvent être évalués pour les transactions qui se produisent à proximité d'un seuil de bande de volume. Cela se traduit par un trop grand nombre de transactions évaluées au taux pré-seuil, et est plus susceptible de se produire lorsque de nombreuses transactions pour une combinaison de développeur et de plan tarifaire donnée se produisent dans un intervalle de 30 secondes. Cela signifie que les rapports de monétisation surestiment les frais lorsque les tarifs par tranche diminuent, et les sous-estiment lorsqu'ils augmentent. Ce problème se produit dans Apigee X et Apigee hybrid, et il n'existe aucune solution de contournement connue. La résolution a commencé et sera disponible dans une prochaine version.

242213234

 Apigee CORRECTION Échec du chargement du produit d'API avec une erreur "aucune connexion disponible"

Ce message d'erreur peut s'afficher lors de la tentative de chargement des produits d'API : "Les produits n'ont pas pu être chargés. Erreur : Aucune connexion disponible à partir des agents de connexion Apigee.

Le problème se produit après l'activation de VPC Service Controls dans le projet Google Cloud et l'ajout de iamcredentials.googleapis.com au périmètre de service en tant que service restreint.

Solution : Créez manuellement une règle de sortie, par exemple :

-egressTo:
    operations:
    -serviceName: "iamcredentials.googleapis.com"
        methodSelectors:
        -method:
    resources:
    -projects/608305225983
  egressFrom:
    identityType: ANY_IDENTITY

247540503

 hybrid 1.7.0 et versions ultérieures
hybrid 1.8.0 et versions ultérieures		 CORRECTION Une condition de concurrence avec recherche de clés de chiffrement peut entraîner des échecs de recherche de KVM.

Dans certains cas, à un débit très élevé, une condition de concurrence avec recherche de clés de chiffrement peut entraîner des échecs de recherche de KVM.

258699204

 hybrid 1.8.0 et versions ultérieures CORRECTION Les requêtes et limites de mémoire par défaut pour les pods de métriques ont été modifiées accidentellement dans la version 1.8.x.

Si vous constatez que les pods apigee-telemetry-app ou apigee-telemetry-proxy ne s'exécutent pas, modifiez les propriétés de demandes de ressources et de limites de ressources metrics pour qu'elles correspondent aux valeurs par défaut suivantes dans la Documentation de référence sur les propriétés de configuration : métriques.

Propriété de configuration Valeur par défaut
metrics.aggregator.resources.requests.memory : 512Mi
metrics.aggregator.resources.limits.memory : 3Gi
metrics.app.resources.requests.memory : 512Mi
metrics.app.resources.limits.memory : 1Gi
metrics.appStackdriverExporter.resources.requests.memory : 512Mi
metrics.appStackdriverExporter.resources.limits.memory : 1Gi
metrics.proxy.resources.requests.memory : 512Mi
metrics.proxy.resources.limits.memory : 1Gi
metrics.proxyStackdriverExporter.resources.requests.memory : 512Mi
metrics.proxyStackdriverExporter.resources.limits.memory : 1Gi

Appliquez les modifications avec apigeectl apply avec l'option ‑‑telemetry :

apigeectl apply --telemetry -f overrides.yaml

260324159

 Apigee 1-9-0-apigee-16 CORRECTION Déploiements de proxys d'API et de flux partagés prenant jusqu'à 30 minutes.

Dans certaines circonstances, le déploiement des proxys d'API et des flux partagés dans le plan d'exécution pouvait prendre aux alentours de 20 à 30 minutes en raison d'une erreur de "socket fermé" dans le synchronisateur.

214447386

 Tous OUVERT Le message "config not modified" s'affiche dans les journaux d'audit des accès aux données de l'API Apigee en tant que Error.

Ce message est censé s'afficher toutes les minutes et n'a pas d'incidence sur vos coûts de facturation.

260772383

 hybrid 1.8.0 et versions ultérieures OUVERT Erreur de liaison de socket sur la plate-forme AKS

Si vous installez Apigee hybrid sur AKS, l'erreur suivante peut s'afficher :

envoy config listener '0.0.0.0_443' failed to bind or apply socket options: cannot bind '0.0.0.0:443': Permission denied

Solution : ajoutez le stanza svcAnnotations suivant au fichier des remplacements :

ingressGateways:
- name: INGRESS_NAME
  ...
  svcAnnotations:
    service.beta.kubernetes.io/azure-load-balancer-internal: "true"

Consultez la section Configurer l'environnement d'exécution hybride. Consultez également la section Utiliser un équilibreur de charge interne avec AKS.

241786534

 hybrid 1.8.0 et versions ultérieures CORRECTION MART ne parvient pas toujours à se connecter à FluentD.

Lorsque vous utilisez l'UDCA au niveau de l'organisation, MART ne peut pas toujours se connecter à FluentD. L'UDCA au niveau de l'organisation est la valeur par défaut dans Apigee hybrid version 1.8. Consultez la section orgScopedUDCA dans la documentation de référence sur les propriétés de configuration.

Non disponible hybrid 1.6.0 et versions ultérieures OUVERT apigee-logger ne fonctionne pas sur Anthos BareMetal avec CentOS ou RHEL.

Après la migration de apigee-logger de fluend vers fluent-bit dans la version 1.6.6 d'Apigee hybrid, le logger a cessé de fonctionner sur Anthos BareMetal avec CentOS ou RHEL.
207762842 hybrid 1.5.0 et versions ultérieures CORRECTION Journaux non envoyés à Cloud Logging par apigee-logger.

Les configurations apigee-logger actuelles, y compris les vérifications d'activité, sont incompatibles avec l'environnement d'exécution Kubernetes. Par conséquent, les journaux ne seront pas envoyés à Cloud Logging comme prévu. Ce problème entraîne également le plantage régulier des pods apigee-logger. Ce problème affecte les installations Apigee hybrid sur AKS, Anthos Bare Metal et d'autres plates-formes. Notez que dans certains cas, ce problème entraîne un volume de journaux excessif.

191291501, 191000617 Apigee CORRECTION La modification de l'adresse e-mail d'une entité de développeur échouera dans l'interface utilisateur.
191002224 hybrid 1.5.0 et versions ultérieures CORRECTION La modification d'une adresse e-mail échoue lorsque vous utilisez l'API PUT /organizations/{org_name}/developers/{developer_email}.
184555974 hybrid 1.5.0 et versions ultérieures CORRECTION Le Fluentd apigee-logger ne peut pas analyser les journaux dans le cluster OpenShift.
Non disponible Déploiements d'archives OUVERT La gestion et le débogage des déploiements d'archives Apigee dans l'UI ne sont pas compatibles.

Dans l'UI Apigee, vous ne pouvez pas afficher, confirmer l'état du déploiement ou gérer vos déploiements d'archive, comme décrit dans Déployer un proxy d'API, ni utiliser l'UI de débogage comme décrit dans Utiliser l'outil Debug. Pour contourner ce problème, vous pouvez utiliser gcloud ou l'API pour lister tous les déploiements d'archives dans un environnement et utiliser l'API Debug.

Non disponible Déploiements d'archives OUVERT Le rollback d'un déploiement d'archive n'est pas possible.

Le rollback d'un déploiement d'archive n'est actuellement pas disponible. Pour supprimer une version d'un déploiement d'archive, vous devez redéployer une version précédente d'une archive ou supprimer l'environnement.

421402073

 Apigee dans VS Code OUVERT L'authentification Google dans les règles n'est pas compatible avec Apigee dans Visual Studio Code (VS Code)

L'authentification Google dans les règles ServiceCallout et ExternalCallout, comme décrit dans la page Utiliser l'authentification Google, n'est pas compatible avec Apigee dans VS Code.

422757662 Apigee 1-15-0-apigee-5
hybrid 1.15.0		 CORRIGÉ dans Apigee 1-15-0-apigee-7 et Apigee 1-15-0-apigee-8

En-têtes x-b3 non disponibles lorsque DistributedTrace est désactivé

Dans les versions Apigee 1-15-0-apigee-5 et hybrid 1.15.0, Apigee a cessé d'envoyer des en-têtes x-b3 aux points de terminaison cibles lorsque le traçage distribué est désactivé. Cependant, certaines installations Apigee s'appuyaient sur l'envoi d'en-têtes x-b3, que la trace distribuée soit activée ou non. Par conséquent, cette modification a été annulée à partir d'Apigee 1-15-0-apigee-7.

146222881 hybrid 1.3.0 et versions ultérieures CORRECTION Erreur d'en-tête HTTP non valide

Erreur d'en-tête HTTP non valide : l'entrée Istio transfère toutes les réponses cibles entrantes au protocole HTTP2. Comme le processeur de messages hybride n'accepte que le protocole HTTP1, vous pouvez rencontrer l'erreur suivante lorsqu'un proxy d'API est appelé :

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,

name: [:authority], value: [domain_name]

Si cette erreur s'affiche, vous pouvez effectuer l'une des actions suivantes pour corriger le problème :

  • Modifiez le service cible pour omettre l'en-tête "Host" dans la réponse.
  • Si nécessaire, supprimez l'en-tête "Host" à l'aide de la règle AssignMessage dans votre proxy d'API.

420985360

 Portail intégré OUVERT SmartDocs
  • Apigee est compatible avec la spécification OpenAPI 3.0 lorsque vous publiez vos API à l'aide de SmartDocs sur votre portail, mais un sous-ensemble de fonctionnalités n'est pas encore compatible. Par exemple, les propriétés allOf pour la combinaison et l'extension des schémas.

    Si une fonctionnalité incompatible est référencée dans votre Spécification OpenAPI, il arrive que les outils ignorent la fonctionnalité, mais affichent toujours la documentation de référence de l'API. Dans d'autres cas, une fonctionnalité incompatible peut entraîner des erreurs empêchant l'affichage de la documentation de référence de l'API. Dans les deux cas, vous devez modifier votre Spécification OpenAPI afin d'éviter d'utiliser la fonctionnalité non compatible jusqu'à ce qu'elle soit prise en charge dans une version ultérieure.

  • La fonctionnalité "Essayer cette API" présente les limites suivantes :
    • L'en-tête Accept est défini sur application/json, quelle que soit la valeur définie pour consumes dans la spécification OpenAPI.
    • Les en-têtes de requête d'un type autre que "chaîne" ne sont pas acceptés.
N/A Portail intégré OUVERT Administrateur de portail

  • Pour le moment, les mises à jour simultanées du portail (telles que les modifications de pages, de thèmes, de CSS ou de scripts) par plusieurs utilisateurs ne sont pas acceptées.
  • Si vous supprimez une page de documentation de référence de l'API à partir du portail, vous ne pouvez pas la recréer. Vous devrez supprimer et rajouter le produit d'API, puis générer à nouveau la documentation de référence de l'API.
  • Lorsque vous personnalisez le thème de votre portail, un délai de cinq minutes peut être nécessaire pour que les modifications soient appliquées.
Non disponible Portail intégré OUVERT Fonctionnalités de portail

La recherche sera ajoutée au portail intégré dans une prochaine version.

Non disponible Portail intégré OUVERT Fournisseur d'identité SAML

La déconnexion unique (SLO) avec le fournisseur d'identité SAML n'est pas disponible pour les domaines personnalisés. Pour activer un domaine personnalisé avec un fournisseur d'identité SAML, laissez le champ "Sign-out URL" (URL de déconnexion) vide lorsque vous configurez les paramètres SAML.

191815997 hybrid 1.6.0 et versions ultérieures CORRECTION Si un client hybride configure un proxy de transfert pour le proxy d'API, le jeton Google ne fonctionnera que s'il dispose d'un accès direct à *.googleapis.com.
Non disponible Apigee CORRIGÉ dans Apigee 1-12-0-apigee-2 et hybrid 1.12.0 Surveillance des API et Cloud Monitoring montrent des pics anormaux.

  • Les nombres de requêtes et de réponses de proxy d'API (pour les proxys et les cibles) montrent des pics anormaux.

    Voici un exemple illustrant un tel pic :

    (Agrandir l'image)

  • En raison d'un bug, le système enregistre le nombre de manière incorrecte pour une courte période, et le nombre est corrigé. Cela se produit en cas de réduction du trafic des API (ce qui entraîne une réduction du nombre de passerelles API).
  • Pour distinguer les pics réels des requêtes de ce problème, veuillez consulter la page "Analyse des API" (en particulier les pages Performances des proxys et Performances des cibles).

Métriques concernées :

  • apigee.googleapis.com/proxyv2/request_count
  • apigee.googleapis.com/proxyv2/response_count
  • apigee.googleapis.com/targetv2/request_count
  • apigee.googleapis.com/targetv2/response_count

Nouvelles métriques

Vous pouvez utiliser les nouvelles métriques pour éviter ce problème.

Métrique Description
apigee.googleapis.com/proxy/request_count Nombre de requêtes adressées au proxy Apigee depuis l'enregistrement du dernier échantillon.
apigee.googleapis.com/proxy/response_count Nombre de réponses envoyées par le proxy d'API Apigee.
apigee.googleapis.com/proxy/latencies Répartition des latences, qui sont calculées entre le moment où la requête a été reçue par le proxy Apigee et le moment où la réponse a été envoyée depuis le proxy Apigee vers le client.
apigee.googleapis.com/target/request_count Nombre de requêtes envoyées à la cible Apigee depuis l'enregistrement du dernier échantillon.
apigee.googleapis.com/target/response_count Nombre de réponses reçues de la cible Apigee depuis l'enregistrement du dernier échantillon.
apigee.googleapis.com/target/latencies Répartition des latences, qui sont calculées entre le moment où la requête a été envoyée à la cible Apigee et le moment où la réponse a été reçue par le proxy Apigee. Ce temps n'inclut pas la surcharge du proxy d'API Apigee.

Pour Apigee hybrid, consultez les sections suivantes : Présentation de la collecte de métriques et Afficher les métriques.

203778087 hybrid 1.5.3 et versions ultérieures OUVERT apigee-stackdriver-logging-agent s'exécute actuellement en tant que racine.

Solution : désactivez l'agent Logging sur l'environnement hybride.

205629443 Apigee CORRECTION Si ServiceCallout est de type "fire and forget" (pas de tag <Response>), une condition de concurrence peut se produire si une autre règle intervient après celle-ci.

Solution : pour conserver le comportement de type "fire and forget" :

  1. Ajoutez <Response>calloutResponse</Response> à l'appel de service.
  2. Définissez continueOnError sur true.
207719377 Apigee CORRIGÉ dans Apigee 1-11-0-apigee-1 S'il existe plusieurs règles SpikeArrest dans un groupe, des erreurs 502 se produisent.

Solution : évitez d'utiliser plusieurs règles SpikeArrest dans le proxy pour éviter le problème.

209097822 hybrid 1.5.0 et versions ultérieures
Apigee		 CORRECTION Les mises à jour dynamiques du débit dans SpikeArrest peuvent ne pas s'appliquer immédiatement

Dans le cas d'une clé spécifique, en cas de trafic continu, il est possible que la limitation du débit ne soit pas appliquée au débit mis à jour. Si aucun trafic n'est enregistré pendant cinq minutes pour une clé spécifique, le débit est pris en compte.

Solution : redéployez le proxy avec une nouvelle variable de référence si le débit doit prendre effet immédiatement. Vous pouvez également utiliser deux arrêts de pics conditionnels avec des variables de flux différentes pour ajuster le débit.

221305498 Apigee OUVERT La surveillance des API peut afficher le code d'erreur « (not set) ».

La surveillance des API des proxys d'API configurables peut afficher le code d'erreur "(not set)" pour les réponses dont l'état n'est pas 2xx à partir de la cible.

246774745 Apigee CORRECTION La valeur de io.timeout.millis n'est pas respectée lorsqu'elle est utilisée avec plusieurs cibles dynamiques.

Si un proxy définit deux valeurs io.timeout.millis ou plus dans deux flux ou plus utilisant le même hôte cible, une seule valeur io.timeout.millis est honorée.
245664917 hybrid 1.8.x CORRECTION L'erreur de mise à niveau Apigee hybrid peut être ignorée

Lors de la mise à niveau vers Apigee hybrid 1.8.x, après avoir exécuté apigeectl init et vérifié que check-ready a réussi, vous pouvez remarquer que, si vous affichez les pods, le job de validation du schéma Cassandra est en état d'erreur. Cette condition est sans conséquence ; vous pouvez passer sereinement à l'étape suivante de la procédure de mise à niveau.

300660653 Apigee CORRECTION Une erreur ne doit pas être renvoyée lorsque vous déployez des proxys avec le même chemin d'accès vers plusieurs environnements associés à la même instance et au même groupe d'environnements.

Le déploiement de proxys avec le même chemin d'accès vers plusieurs environnements associés à la même instance et au même groupe d'environnements n'est pas autorisé. Un tel déploiement doit renvoyer un message d'avertissement en cas de conflit de chemin d'accès de base. Au lieu de cela, aucune erreur n'est affichée et les déploiements semblent réussir.

Solution : Lors du déploiement et après le déploiement, vérifiez qu'il n'y a pas de conflits de chemin d'accès de base avec les proxys déployés et corrigez-les si nécessaire.

301458133 Apigee CORRECTION Certaines tentatives de déploiement du proxy renvoient une erreur indiquant que la révision est immuable

Lorsque vous tentez d'enregistrer un proxy précédemment déployé, le déploiement peut échouer et renvoyer une erreur indiquant que la révision est immuable.

Solution : Cliquez sur la flèche du menu déroulant à côté du bouton Enregistrer, puis sélectionnez Enregistrer en tant que nouvelle révision. Relancez ensuite le déploiement.

301845257 Apigee CORRECTION La tentative de déploiement de plus de 800 proxys dans un groupe d'environnements échoue avec une erreur. La limite à laquelle une erreur est renvoyée est inférieure à 800 lorsque les chemins d'accès de base comportent plus de 15 caractères.

315820718 Apigee CORRECTION Avec les requêtes de proxy gRPC, les trailers gRPC sont supprimés de la réponse

Lorsqu'un appel est effectué vers un serveur cible gRPC, le seul trailer renvoyé est le trailer "grpc-status". Tous les autres trailers sont supprimés de la réponse.
341157011 Apigee CORRECTION Les spécifications générées avec Gemini Code Assist dans Cloud Code qui incluent également des caractères UTF-8 non ASCII ne sont pas analysées correctement lorsqu'elles sont importées dans le hub d'API.

Par conséquent, le hub d'API n'extraira pas correctement les opérations, les définitions et les autres métadonnées.
338285095 Apigee CORRECTION Les applications associées à un groupe d'applications n'apparaissent pas dans la liste d'applications de l'interface utilisateur d'Apigee. Par conséquent, les utilisateurs ne peuvent pas accéder à la page d'informations sur l'application dans la console. La recherche dans la console avec un nom d'application partiel ou une recherche de clé API pour l'application n'est pas compatible tant que ce problème n'est pas résolu.

Les organisations Apigee hybrid ne sont pas concernées par ce problème, car elles utilisent l'interface utilisateur classique pour afficher les informations sur l'application.

Solution partielle : une liste de toutes les applications est disponible via les API. Consultez organizations.apps.list.
355714868 Monétisation
Apigee hybrid		 CORRIGÉ dans hybrid 1.14.3, hybrid 1.15.1 et hybrid 1.16.0 Données des frais récurrents, de configuration et de crédit non collectées ni facturées pour les organisations hybrides

Pour les organisations hybrides avec monétisation, les données des frais récurrents (RECURRING_FEE), de configuration (SETUP_FEE) et de crédit (TOPUP_FEE) ne sont pas collectées ni facturées pour la facturation postpayée. Pour la facturation prépayée, la déduction du portefeuille est effectuée pour ces frais, mais n'est pas signalée.
438850078 Apigee OUVERT

Une récursion infinie se produit dans la règle OASValidation lorsqu'une réponse du backend contient un type de discriminateur identique au schéma parent. Ce problème peut entraîner une erreur StackOverflowError.
449012244 Apigee OUVERT

Utilisez des définitions de points de terminaison cibles distinctes pour les cibles SSE (événements envoyés par le serveur). Mélanger des points de terminaison cibles SSE et non SSE peut entraîner un comportement incohérent, tel que des variables de flux response.content vides.
445936920 Apigee 1-16-0-apigee-2 et versions ultérieures OUVERT

Des problèmes de configuration DNS non détectés auparavant peuvent désormais provoquer des erreurs DNS. Apigee a supprimé la fonctionnalité de remplacement automatique du DNS qui était présente dans la version 1-16-0-apigee-2. Cette suppression élimine la résilience de la plate-forme aux erreurs de configuration DNS et peut désormais entraîner des erreurs DNS.

Recherchez les erreurs associées en consultant les journaux d'exécution pour détecter les erreurs de résolution DNS.
383372330 Versions 1.13.0 à 1.15.1 (non incluse) d'Apigee Emulator CORRIGÉ dans l'émulateur Apigee 1.15.1 et versions ultérieures

Tous les déploiements de proxy échouent localement avec des messages d'erreur incluant Error parsing deployment report as JSON : 

06/13/2025 6:45 PM EMULATOR INFO Deploying environment testenv, to Container apigee-1.14.2 (1.14.2)
06/13/2025 6:45 PM EMULATOR ERROR Error parsing deployment report as JSON
06/13/2025 6:45 PM EMULATOR ERROR null
06/13/2025 6:45 PM EMULATOR ERROR Environment testenv deployment, to Container apigee-1.14.2 (1.14.2) failed with Error: 500
06/13/2025 6:45 PM EMULATOR ERROR Deploy to Container apigee-1.14.2 (1.14.2), failed with Error: Environment testenv deployment, to Container apigee-1.14.2 (1.14.2) failed with Error: 500
 Solution : passez à la version 1.15.1 ou ultérieure de l'émulateur Apigee.