Problemas conocidos de Apigee

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Selecciona una o más de las siguientes opciones para filtrar esta página:

En esta sección, se enumeran los problemas conocidos de los componentes de Apigee. Para obtener una lista de errores, funciones nuevas y más información sobre actualizaciones, consulta las notas de la versión.

ID del problema Qué se afectó Estado Descripción
543171828 hybrid 1.14.7, hybrid 1.15.7 y hybrid 1.16.8 CORREGIDO en la versión hybrid 1.16.9 El DaemonSet apigee-logger no está programado en ningún nodo, por lo que los registros del entorno de ejecución de Apigee dejan de llegar a Cloud Logging.

Después de instalar o actualizar a una versión afectada, kubectl get daemonset apigee-logger -n apigee informa un recuento deseado de 0 y no se crean Pods de registrador.

El gráfico apigee-telemetry siempre envió un logger.nodeSelector predeterminado de apigee.cloud.google.com/apigee-logger-enabled: "true", lo que requiere que etiquetes los nodos que deben ejecutar el registrador. Las versiones anteriores a las afectadas ignoraban los selectores de nodos a nivel de componente, por lo que el registrador se programaba en los grupos de nodos de Apigee, aunque los nodos no estuvieran etiquetados. Las versiones afectadas aplican correctamente los selectores de nodos a nivel de componente, por lo que ahora se aplica el valor predeterminado y el DaemonSet no coincide con ningún nodo.

Solo se ven afectadas las implementaciones que configuran logger.enabled: true.

Solución alternativa: Elige una de las siguientes opciones y, luego, actualiza el gráfico de apigee-telemetry.

Para ejecutar el registrador en cada nodo, lo que coincide con el comportamiento de las versiones anteriores, borra el selector de nodos predeterminado en tu archivo overrides.yaml:

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

Para restringir el registrador a un conjunto específico de nodos, conserva el selector de nodos predeterminado y etiqueta cada uno de esos nodos:

kubectl label nodes NODE_NAME apigee.cloud.google.com/apigee-logger-enabled=true
534420582 Apigee
Apigee Hybrid		 CORREGIDO en la versión hybrid 1.15.8 Las cargas útiles de JSON con claves duplicadas pueden interpretarse de manera diferente según las políticas de Apigee y los servicios de backend, lo que puede debilitar las verificaciones de seguridad basadas en el contenido.

La política ExtractVariables usa JSONPath, que resuelve las claves JSON duplicadas con la semántica last-wins. En cambio, algunos backends, en especial las APIs de Google Cloud que aceptan JSON de proto3, combinan las claves repetidas (por ejemplo, concatenan campos de array repetidos). Si un proxy de Apigee depende de ExtractVariables + JSONPath + RaiseFault para inspeccionar y bloquear cuerpos de solicitudes con privilegios, un atacante puede ocultar contenido malicioso en una clave duplicada que la política de Apigee no ve, pero que el backend sigue procesando.

Solución alternativa: No dependas de ExtractVariables con JSONPath solo como un límite de seguridad para los backends que aceptan JSON de proto3. Agrega una política JSONThreatProtection al flujo de solicitud antes de ExtractVariables y configura <ObjectEntryCount> y otros límites para que coincidan con tu contrato de API. Para obtener una protección más sólida, usa una política de JavaScript para analizar el cuerpo de la solicitud con JSON.parse() y rechazar las cargas útiles que contengan claves duplicadas antes de que se ejecute la extracción.
523085517 IU ABIERTA La vista de seguimiento de depuración de Apigee puede parpadear o renderizarse con lentitud en sesiones de depuración grandes.

Cuando ves una sesión de depuración en la IU de Apigee, el mapa de transacciones y los detalles del seguimiento pueden aparecer y desaparecer de forma repetida (parpadeo) o tardar mucho tiempo en renderizarse. Este comportamiento se nota más en las sesiones de depuración que contienen una gran cantidad de eventos y en las máquinas de menor potencia, y puede dificultar la inspección del flujo de una solicitud a la API.

Solución alternativa: En el panel View options de la vista de seguimiento de depuración, desmarca todas las casillas de verificación para reducir la cantidad de elementos renderizados. También puedes intentar ver la sesión de depuración en otro navegador.
513032450 hybrid 1.16.2 CORREGIDO en hybrid 1.16.11 y hybrid 1.17.1 apigee-connect-agent primeras cuñas de conexión en clústeres de RKE2 en GKE después de la actualización de la cadena de herramientas de Go 1.26.3.

El Pod apigee-connect-agent no puede detectar la conexión bloqueada. La causa raíz aún se está investigando, pero puede estar en Cloud NAT, que usan nuestros clústeres de prueba.

Solución alternativa: Usa más de un Pod de apigee-connect-agent. El segundo Pod se recuperará, y el primero restablecerá la conexión después de 2 horas y se recuperará a partir de ese momento.
515424331 hybrid 1.16.3 CORREGIDO en la versión hybrid 1.16.4 La secuencia de comandos apigee-pull-push.sh falla en la versión 1.16.3 porque algunas imágenes transferidas de la versión 1.16.2 no se volvieron a etiquetar con la etiqueta 1.16.3 en el repositorio gcr.io/apigee-release/hybrid/.

Cuando apigee-pull-push.sh (o cualquier docker pull manual) solicitó una imagen afectada en la etiqueta 1.16.3, el registro devolvió un error image not known y la secuencia de comandos se anuló. Las actualizaciones realizadas a través de los gráficos de Helm de Apigee Hybrid no se vieron afectadas, ya que los gráficos hacen referencia directamente a los resúmenes de imágenes correctos.

Solución alternativa: Para cada imagen afectada, extrae la etiqueta 1.16.2 en lugar de 1.16.3, o actualiza directamente a 1.16.4, que vuelve a publicar todas las imágenes con la etiqueta coincidente.
512866352 hybrid 1.16.2 RESUELTO en la versión híbrida 1.16.3 Los almacenes de secretos externos (como HashiCorp Vault) no funcionan con la imagen de apigee-redis debido a una discrepancia en la versión de glibc.

Solución alternativa: No configures la integración del almacén de secretos externos (ESS) para apigee-redis en Apigee Hybrid 1.16.2. Usa la configuración predeterminada del Secret hasta que haya una solución disponible.
415061771 Apigee
Apigee Hybrid		 ABIERTA Mensaje de error del controlador "Se modificó el objeto"

Los clientes de Hybrid podrían observar los mensajes recurrentes "object has been modified; please apply your changes to the última versión and try again." en los registros del controlador. Estos mensajes son un efecto secundario inofensivo de los mecanismos de seguridad integrados de Apigee y Apigee Hybrid, y no indican ningún riesgo para los entornos de Apigee o Apigee Hybrid. Para garantizar una confiabilidad total, el sistema está diseñado para verificar y volver a verificar su configuración interna varias veces por minuto para asegurarse de que coincida exactamente con la configuración deseada. Estos errores significan que dos subcontroladores intentaron actualizar sus "especificaciones" internas al mismo tiempo; la primera actualización se realiza correctamente y la segunda genera el mensaje y realizará la actualización nueva más tarde. Debido a que se trata de actualizaciones administrativas puramente internas y no cambian la forma en que las APIs procesan el tráfico, los servicios deben permanecer estables y sin verse afectados.
499322601 hybrid 1.16.0-hotfix.1,
hybrid 1.15.2,
hybrid 1.14.4		 CORREGIDO en la versión hybrid 1.16.2 Apigee no admitirá un proxy de reenvío que tenga aplicada la credencial de autenticación básica.
495305258 Apigee (solución de Marketplace) ABIERTA Interrupción de la implementación del portal de Apigee Drupal a través de Cloud Marketplace

Estamos realizando la transición de la solución de Marketplace del portal de Drupal de Apigee para usar Infrastructure Manager en lugar de Cloud Deployment Manager. Durante este período de transición, es posible que algunas funciones de implementación y administración no estén disponibles.

Impacto:

  • Implementaciones nuevas: A partir del 1 de abril de 2026, es posible que falle el intento de implementar una nueva instancia del portal de Apigee Drupal con el botón "Implementar" en Cloud Marketplace.
  • Implementaciones existentes: Tus recursos subyacentes (como las VMs y las bases de datos de Cloud SQL) no se verán afectados y seguirán ejecutándose con normalidad. Sin embargo, es posible que falle el uso de las funciones basadas en Deployment Manager para administrar la implementación a través de la IU de Cloud Marketplace o la herramienta de gcloud deployment-manager.

Solución alternativa: Realiza cualquier cambio de configuración o tarea de administración directamente en los recursos individuales de Google Cloud (Compute Engine, Cloud SQL, etc.). en lugar de hacerlo a través de la IU de Cloud Marketplace.
496552286 Apigee ABIERTA La implementación falla para los proxies de descubrimiento de MCP en regiones con limitaciones de capacidad.

La implementación de la infraestructura de MCP puede estar sujeta a limitaciones de capacidad en las siguientes regiones:

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

Si ves un error relacionado con una falla en el aprovisionamiento del balanceador de cargas o el estado de aprovisionamiento nunca cambia a Implementado, es posible que se deba a límites temporales de capacidad de la infraestructura en la región seleccionada. Intenta implementar el proxy en un entorno de otra región.
490308770 hybrid 1.12.x, hybrid 1.15.x, hybrid 1.16.0 CORREGIDO en 1.16.0-hotfix.1 y 1.15.2 Las configuraciones de proxy HTTP autenticadas fallan debido a cadenas de URL con formato incorrecto en las plantillas de Helm.

Cuando se configura un proxy de salida autenticado con httpProxy.username y httpProxy.password, los gráficos de Helm de Apigee Hybrid generan cadenas http_proxy y https_proxy con formato incorrecto. Las plantillas insertan de forma incorrecta comillas dobles en el medio de la URL, lo que provoca que componentes como los Pods de validación de la protección fallen con un error net/url: invalid userinfo.

Solución alternativa: Edita de forma manual los archivos de plantilla de Helm para quitar la función quote de los campos de nombre de usuario y contraseña en la construcción de la URL del proxy. Por ejemplo, en apigee-operator/templates/apigee-operators-guardrails.yaml, modifica las definiciones de las variable de entorno del proxy para asegurarte de que las credenciales no se citen de forma individual dentro de la cadena de la URL.
482077193 Hybrid 1.15.0 y versiones posteriores CORREGIDO en 1.16.0-hotfix.1 El encadenamiento de proxy falla con el error 404 route_not_found en configuraciones de varias organizaciones y un solo espacio de nombres.

En los entornos de Apigee Hybrid en los que varias organizaciones comparten un solo espacio de nombres de Kubernetes, el encadenamiento de proxies puede fallar de forma intermitente con un error de HTTP 404 route_not_found. Esto ocurre porque las puertas de enlace de encadenamiento interno para diferentes organizaciones usan el mismo selector ingress_name, lo que hace que Envoy cargue las reglas de enrutamiento de forma incoherente.

Solución alternativa: Asigna un nombre único a la puerta de enlace de encadenamiento para cada organización en tu archivo overrides.yaml para garantizar el aislamiento del selector:

apigeeChainingGateway:
  name: internal-chaining-UNIQUE_SUFFIX

Además, asegúrate de que tus selectores de hosts virtuales y cualquier servicio de Kubernetes dedicado se actualicen para hacer referencia a este nombre único.
479040521 hybrid 1.16.0 CORREGIDO en la versión hybrid 1.16.0-hotfix.1 apigee-operator-guardrails-sa no se creó en AKS/EKS con Workload Identity federada.

La ServiceAccount de Kubernetes apigee-operator-guardrails-sa no se crea cuando se instala o actualiza el chart apigee-operator en Apigee Hybrid 1.16.0 en plataformas que no son de GKE en las que está habilitada la federación de Workload Identity (WIF).

Solución alternativa: Aplica un parche de forma manual a la plantilla del gráfico de Helm apigee-operator:

  1. Edita el archivo de plantilla del gráfico de Helm apigee-operator apigee-operator/templates/apigee-operator-guardrails-sa.yaml.

    Actualiza la condición if inicial para incluir la verificación de federatedWorkloadIdentity:

    {{ - if or (.Values.serviceAccountSecretProviderClass) (.Values.gcp.workloadIdentity.enabled) (.Values.gcp.federatedWorkloadIdentity.enabled) } }
  2. Edita el archivo de plantilla de gráfico de Helm apigee-operator apigee-operator/templates/apigee-operator-guardrails.yaml (Nota: Este es el archivo de plantilla apigee-operator-guardrails.yaml, no el archivo apigee-operator-guardrails-sa).

    Actualiza la condición if inicial en la línea 17 inmediatamente después de spec: para incluir la verificación de federatedWorkloadIdentity:

    {{ - if or (.Values.serviceAccountSecretProviderClass) (.Values.gcp.workloadIdentity.enabled) (.Values.gcp.federatedWorkloadIdentity.enabled) } }
  3. Aplica los cambios al gráfico de apigee-operator.
479872706 hybrid 1.16.0 (EKS con WIF y proxy de reenvío) CORREGIDO en la versión hybrid 1.16.0-hotfix.1 No se pueden cargar los productos de API, las apps ni los desarrolladores después de migrar los datos a Apigee Hybrid 1.16.

Después de actualizar a Apigee Hybrid 1.16.0, es posible que los entornos que usan la federación de identidades para cargas de trabajo (WIF) junto con un proxy de reenvío HTTP no carguen las entidades de administración (productos de API, apps y desarrolladores) debido a una regresión de conversión de credenciales en MART.

Solución alternativa: Aplica la actualización 1.16.0-hotfix.1 actualizando las propiedades image.url y image.tag para los componentes del operador y MART en tu archivo 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 CORREGIDO en la versión hybrid 1.16.0-hotfix.1 La implementación del proxy no se completa debido a que faltan permisos de RBAC en Hybrid v1.16.0.

Existe un problema conocido en la versión 1.16.0 en el que los clústeres híbridos pueden no informar el estado de implementación de los proxies. Esto se debe a que falta un permiso en el rol apigee-manager-role.

Solución alternativa: Agrega el permiso a la plantilla del gráfico de Helm apigee-operator:

  1. Edita el archivo de plantilla del gráfico de Helm apigee-operator apigee-operator/templates/apigee-operators.yaml.
  2. Agrega el verbo - watch al recurso deployments, después del verbo - update en la línea 584.
  3. Actualiza la versión de Helm de apigee-operator.
418274570 hybrid 1.16.0 corregidas La página de notas de la versión de Hybrid no se actualizó con la información de 1.16.0-hotfix.1.

En la página de notas de la versión de Hybrid, no se muestra la información de actualización de la versión 1.16.0-hotfix.1. Consulta las notas de la versión de Apigee Hybrid v1.16.0-hotfix.1 para obtener detalles de la actualización.
484366184 hybrid 1.14.x, hybrid 1.15.x CORREGIDO en la versión hybrid 1.16.0 Las versiones 1.14 y 1.15 de Apigee Hybrid encuentran un bucle de fallas en el apigee-ingressgateway-manager cuando se usa la API de Kubernetes Gateway v1.4.0 o una versión posterior.

Apigee Hybrid 1.16 no se ve afectado por este problema.

Solución alternativa: Si necesitas usar la API de Kubernetes Gateway con las versiones 1.14 o 1.15 de Apigee Hybrid, instala la versión v1.3.x de la API de Gateway. Por ejemplo:

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

Consulta lo siguiente:
471125841 hybrid 1.14.x,hybrid 1.15.x CORREGIDO en la versión hybrid 1.16.x Cuando se crea y se implementa una nueva revisión del proxy de API con un valor io.timeout.millis actualizado, es posible que el valor nuevo no se respete de forma coherente.

El valor actualizado de io.timeout.millis no se respeta de forma intermitente para las solicitudes a la API. Esto sucede cuando se usan varios servidores en <LoadBalancer> en el TargetEndpoint.

Solución alternativa: Después de implementar el proxy de API, reinicia los pods de apigee-runtime uno por uno para que el cambio se propague correctamente.

480997525 Apigee 1-17-0-apigee-1 CORREGIDO en Apigee 1-17-0-apigee-2 Las llamadas de proxy fallan con el error The URI contain illegal characters después de la actualización de Netty.

En la versión 1-17-0-apigee-1 de Apigee, una actualización de Netty a la versión 4.1.129.Final introdujo una regresión. Esto puede provocar que las llamadas al proxy de API fallen con un código de estado 400 y el mensaje de error The URI contain illegal characters. Se realiza un seguimiento externo de este problema en netty/netty#16020.

511240460 Actualizaciones de Hybrid 1.15.x a Hybrid 1.16.0 y versiones posteriores ABIERTO (no se planea corregir) Cuando actualizas el operador de Apigee Hybrid 1.15.x a 1.16.x, se reinician los pods de entorno de ejecución, sincronizador, MART, adaptador de Envoy y migración en todos los entornos.

Apigee Hybrid 1.16 agrega una activación de volumen a la plantilla de Pod de estos componentes. En la primera actualización del operador de la versión 1.15.x a la 1.16.x, los Pods de entorno de ejecución, sincronizador, MART, adaptador de Envoy y migración se reinician una vez en cada entorno. Este reinicio se produce independientemente de si la rotación de certificados está habilitada o no.

Cada reinicio es una actualización progresiva, por lo que cada carga de trabajo ejecuta brevemente Pods adicionales (de aumento). En un clúster con muchos entornos, estos pods de aumento se inician al mismo tiempo.

No se reinicia el programador de tareas de Mint. El cambio se aplicará en la próxima ejecución programada.

El reinicio se produce solo una vez, en la actualización de la versión 1.15.x a la 1.16.x. Las actualizaciones posteriores, como de la versión 1.16.x a la 1.17.x, no lo causan. Las versiones posteriores de Apigee Hybrid necesitan la activación del volumen, por lo que no se planea ninguna corrección.

Solución alternativa: Antes de actualizar el operador, asegúrate de que tu clúster tenga capacidad para pods de aumento para todos los entornos al mismo tiempo o actualiza durante un período de poco tráfico.

Consulta los siguientes vínculos:
465834046 hybrid 1.14.3, hybrid 1.15.1 y hybrid 1.16.0 y versiones posteriores para actualizaciones CORREGIDO en hybrid 1.14.3, hybrid 1.15.1 y hybrid 1.16.0 para instalaciones nuevas Las versiones 1.18 y posteriores de cert-manager cambiaron el valor predeterminado de la política de rotación de claves privadas de Never a Always. Si se rota la clave privada de apigee-ca, se verá afectado el tráfico

Las versiones más recientes de cert-manager (v1.18 y posteriores) ahora rotan automáticamente las claves privadas. Cuando se rote esta clave para el certificado apigee-ca, se producirá una interrupción.

Solución alternativa: Para evitar este problema, puedes elegir una de las siguientes opciones:

  • No actualices cert-manager a una versión posterior a la 1.17.x.
  • Edita el certificado apigee-ca en el espacio de nombres cert-manager y establece spec.privateKey.rotationPolicy como Never. Usa el siguiente procedimiento para editar tu certificado apigee-ca y actualizar cert-manager:
    1. Verifica el contenido de tu certificado apigee-ca para ver si se estableció rotationPolicy: 
      kubectl get certificate apigee-ca -n cert-manager -o yaml

      Busca los valores en spec.privateKey en el resultado:

      ...
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 no está configurado o si se configura como Always, edita el certificado apigee-ca para establecer el valor de rotationPolicy en Never:
      1. Realiza primero una ejecución de prueba: 
        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. Aplica un parche al certificado: 
        kubectl patch Certificate \
  -n cert-manager \
  --type=json \
  -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \
  -o=yaml \
  apigee-ca
    3. Verifica que el valor de rotationPolicy ahora esté establecido en Never: 
      kubectl get certificate apigee-ca -n cert-manager -o yaml

      El resultado debería ser similar al siguiente:

      ...
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. Actualiza cert-manager. Con el siguiente comando, se descargará e instalará cert-manager v0.14.2: 
      kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v0.14.2/cert-manager.yaml

Consulta los siguientes vínculos:
458417250 Apigee 1-16-0-apigee-4 CORREGIDO en Apigee 1-16-0-apigee-6 El Message Processor devuelve el error 500 con "Duplicate Header "authorization"".

Cuando hay varios encabezados de autorización en una solicitud, la puerta de enlace de entrada de Apigee no los concatena en un solo encabezado. Esto hace que el Message Processor devuelva un error 500 con un mensaje "Duplicate Header "authorization"".

Solución alternativa: Si hay varios encabezados de autorización en la solicitud, concatenalos en un solo encabezado. Por ejemplo: 

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

Por el momento, la IU de Apigee no ofrece la opción de aprovisionar organizaciones de Apigee con un Google-owned and Google-managed encryption key.

La IU de Apigee no ofrece la opción de seleccionar una Google-owned and Google-managed encryption key cuando se aprovisionan organizaciones de suscripción.

Solución alternativa: Usa las APIs de Apigee para crear organizaciones basadas en suscripciones con un Google-owned and Google-managed encryption key.

Como se menciona en la documentación de la API de Apigee, cuando creas la organización de Apigee, puedes crearla con un Google-owned and Google-managed encryption key sin proporcionar valores para los campos runtimeDatabaseEncryptionKeyName, apiConsumerDataEncryptionKeyName y controlPlaneEncryptionKeyName.

460431753 Apigee, Apigee hybrid ABIERTA Las políticas de Model Armor de Apigee no son compatibles con WebSockets.

Por el momento, las políticas de Apigee Model Armor, incluidas SanitizeUserPrompt y SanitizeModelResponse, no funcionan como se espera cuando se usan en proxies de API que controlan conexiones de WebSocket. Consulta WebSockets con Apigee para obtener más información sobre la configuración de WebSocket.
433759657 Apigee CORREGIDO en 1-16-0-apigee-3 o versiones posteriores

Después de la actualización a 1-16-0-apigee-3, algunas organizaciones de Apigee pueden encontrar errores HTTP 500 que provienen de un java.lang.NoClassDefFoundError dentro de una política de Java Callout. El error se ve similar al siguiente: 

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

Este error se produce cuando una política de Java Callout depende de forma incorrecta de bibliotecas destinadas al uso interno de Apigee en lugar de proporcionar sus propias dependencias.

Acción obligatoria: Para evitar este problema, los desarrolladores deben asegurarse de que todas las llamadas de código Java sean independientes y utilicen sus propias bibliotecas dedicadas, lo que evita cualquier dependencia de la ruta de clase interna de Apigee.

En el proxy de API que usa la biblioteca JAR de Apache Commons, importa el archivo JAR de Apache Commons para incluirlo como recurso del proxy. Para obtener más información, consulta los lineamientos de recursos de Java.

451841788 hybrid 1.14.3 y hybrid 1.15.1 corregidas Apigee Hybrid requiere la propiedad mintTaskScheduler.serviceAccountPath incluso cuando la monetización no está habilitada.

La actualización del gráfico de apigee-org puede fallar si no se establece la propiedad mintTaskScheduler.serviceAccountPath, incluso si la monetización no está habilitada: 

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

Solución alternativa: Quita los archivos apigee-org/templates/mint-task-scheduler-gsa-secret.yaml y apitee-org/templates/mint-task-scheduler-sa.yaml.

De manera opcional, puedes mover los archivos a una ubicación separada fuera del directorio del gráfico de Helm. Como alternativa, puedes volver a descargarlos si quieres habilitar la monetización en el futuro. Para ello, sigue las instrucciones que se indican en el Paso 2: Descarga los gráficos de Helm para Apigee.

Por ejemplo, desde el directorio helm-charts/:

  1. ls apigee-org/templates/

    Resultado:

    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. (Opcional:) 
    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/

    Resultado:

    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 CORREGIDO en la versión hybrid 1.15.1

La secuencia de comandos apigee-pull-push.sh puede devolver un mensaje de error No such image, por ejemplo:

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

Solución alternativa: Edita la secuencia de comandos HELM_CHARTS_DIR/apigee-operator/etc/tools/apigee-pull-push.sh para cambiar la línea 114 en la función docker_tag() de la siguiente manera: 

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

Para: 

  docker tag "${source}/$i:${TAG}" "${dest}/$i:${TAG}"
405936071 hybrid 1.15.0 CORREGIDO en la versión hybrid 1.15.1

Cuando se especifica metrics.serviceAccountRef o metrics.serviceAccountSecretProviderClass en el archivo overrides.yaml, el rol de telemetría se orientará a la cuenta de servicio incorrecta.

Solución alternativa: Aplica un parche a _helper.tpl en el gráfico de apigee-operator/ y vuelve a aplicarlo.

  1. Edita apigee-operator/templates/_helpers.tpl y quita las siguientes líneas en negrita: 

    {{- 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 sección resultante debería verse de la siguiente manera: 

    {{- 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. Vuelve a aplicar el gráfico de apigee-operator. 

    helm upgrade operator apigee-operator/ \
    --namespace APIGEE_NAMESPACE \
    --atomic \
    -f overrides.yaml
419856132 hybrid 1.14.2 y versiones posteriores CORREGIDO en la versión híbrida 1.14.3 y 1.15.0 Si gateway.networking.k8s.io/v1 está instalado en tu clúster,es posible que no se pueda actualizar apigee-ingressgateway-manager.

Para obtener una solución alternativa, sigue los pasos que se indican en el problema conocido 416634326.

378686709 Apigee
Apigee Hybrid		 CORREGIDO en Apigee (se requiere una llamada de asistencia)
CORREGIDO en Hybrid 1.14.3 y Hybrid 1.15.1 (se requiere un procedimiento)

El uso de comodines (*) en las rutas base del proxy de Apigee puede entrar en conflicto con otras rutas base explícitas, lo que genera un error 404. Por ejemplo, el uso de las siguientes rutas base para dos proxies implementados en el mismo entorno puede generar un error 404 cuando se llama a Proxy-2: 

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

En este caso, las llamadas a la ruta de acceso base explícita se resolverán correctamente, pero las llamadas a Proxy-2 pueden devolver un 404 si la ruta de acceso comodín se evalúa como /a/v1/c.

Se corrigió: Este problema se corrigió en Apigee y en Hybrid 1.14.3 y versiones posteriores. Sin embargo, la corrección no está habilitada de forma predeterminada. Si deseas habilitar el uso de comodines en las rutas de acceso base, haz lo siguiente:

  • Los clientes con organizaciones de Apigee deben comunicarse con el equipo de asistencia de Apigee para habilitar la corrección si es necesario.
  • Los clientes con organizaciones de Apigee Hybrid deben usar el siguiente procedimiento para habilitar la corrección si es necesario.

Procedimiento: Para habilitar el uso de comodines (*) en las rutas de acceso base del proxy de Apigee en Apigee Hybrid, sigue estos pasos:

  1. Agrega la siguiente estrofa a tu archivo overrides.yaml antes de actualizar a la versión híbrida 1.14.3 o posterior: 
    runtime:
  cwcAppend:
    conf_message-processor-communication_classificationV2.enabled: "true"
  2. Aplica los cambios al gráfico de apigee-env. Repite el cambio para cada entorno en tu instalación. 
    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
    • ENV_RELEASE_NAME es un nombre que se usa para hacer un seguimiento de la instalación y las actualizaciones del gráfico de apigee-env. Este nombre debe ser único entre los demás nombres de versiones de Helm de tu instalación. Por lo general, es igual a ENV_NAME. Sin embargo, si tu entorno tiene el mismo nombre que tu grupo de entornos, debes usar nombres de versión diferentes para el entorno y el grupo de entornos, por ejemplo, dev-env-release y dev-envgroup-release. Para obtener más información sobre las versiones en Helm, consulta Tres conceptos importantes en la documentación de Helm.
    • ENV_NAME es el nombre del entorno que estás actualizando.
    • OVERRIDES_FILE es tu archivo de anulaciones.
  3. Actualiza a la versión 1.14.3 o posterior de Hybrid.
382565315 hybrid 1.13.0,
hybrid 1.13.1,
hybrid 1.13.2,
hybrid 1.14.0		 CORREGIDO en la versión híbrida 1.13.3 y en la versión híbrida 1.14.1

El uso de LogTimer en SecurityPolicy puede causar una fuga de memoria.

En algunas circunstancias, los subprocesos del registrador de Apigee Hybrid podrían consumir toda la memoria disponible. Por ejemplo, las entradas de registro frecuentes que documentan errores de permisos asociados con Javacallout podrían causar OOM.

421190799 Apigee CORREGIDO en Apigee 1-15-0-apigee-7

El procesador de extensiones de Apigee no admite más de 100 KB de procesamiento de datos como parte de los eventos del cuerpo de la solicitud y la respuesta.
432315283 Apigee ABIERTA

Cuando actualizas un almacén de claves o un almacén de certificados de confianza sin crear uno nuevo, las actualizaciones del entorno de ejecución pueden fallar y causar el siguiente error intermitente: 

  {"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"}}}

El error es intermitente porque la actualización del almacén de claves o del almacén de certificados de confianza puede fallar en un Pod del entorno de ejecución, pero tener éxito en otros Pods. Para evitar este problema, actualiza el almacén de claves o el almacén de certificados de confianza creando uno nuevo. Vuelve a dirigir tu referencia al nuevo almacén de claves o almacén de certificados de confianza, como se describe en Cuando vence un certificado.
412740465 hybrid 1.14.0 y versiones posteriores CORREGIDO en la versión híbrida 1.14.3 y 1.15.1

A partir de la versión 1.14.0 de Apigee Hybrid, se quitó la adición automática de encabezados de seguimiento de Zipkin (x-b3-*).

N/A

 Apigee Hybrid ABIERTA Si configuras el reenvío de proxy que no es de API con httpProxy sin establecer también envs.httpProxy, no se aplicará la configuración del proxy a las llamadas externas del entorno de ejecución de Apigee a servicios como Pub/Sub o a otras APIs de Google Cloud.

Si solo especificas httpProxy, también debes asegurarte de que *.googleapis.com esté en la lista de entidades permitidas para tus Pods del entorno de ejecución de Apigee para habilitar la conectividad con estos servicios.

Consulta Configura el proxy de reenvío para los proxies de API.

416634326 Hybrid 1.14.2 y versiones posteriores CORREGIDO en la versión híbrida 1.14.3 y 1.15.1

La presencia de definiciones de recursos personalizados (CRD) de istio.io en un clúster de Apigee Hybrid puede causar fallas en los Pods de apigee-ingressgateway-manager.

Durante la actualización de Apigee Hybrid de versiones anteriores a la 1.14.2 o posterior, la presencia de CRD de istio.io existentes puede causar fallas en los sondeos de preparación en los contenedores discovery de los Pods de apigee-ingressgateway-manager.

Solución alternativa: Apigee Hybrid v1.14.2 o versiones posteriores no requieren las CRD de istio.io. Existen dos opciones para solucionar este problema:

  • Borra las CRD de istio.io si no usas Istio para ningún otro propósito que no sea Apigee en tu clúster.
  • Actualiza el apigee-ingressgateway-manager clusterrole para agregar permisos para istio.io.

Después de cada una de las opciones anteriores, deberás reiniciar tus Pods de apigee-ingressgateway-manager.

Borra las CRD

  1. Enumera los CRD de istio.io en tu clúster en un archivo CSV: 
    kubectl get crd -o custom-columns=NAME:metadata.name | grep istio.io > istio-crd.csv
  2. Opcional: Guarda las CRD de forma local en caso de que necesites volver a crearlas: 
    kubectl get crd $(cat istio-crd.csv) -o yaml > istio-crd.yaml
  3. Borra las CRD de istio.io:

    Prueba de validación:

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

    Ejecución:

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

Actualiza el clusterrole

  1. Obtén el clusterrole apigee-ingressgateway-manager actual: 
    kubectl get clusterrole apigee-ingressgateway-manager-apigee -o yaml > apigee-ingressgateway-manager-apigee-clusterrole.yaml
  2. Copia el clusterrole en una ubicación nueva: 
    cp apigee-ingressgateway-manager-apigee-clusterrole.yaml apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml
  3. Agrega los siguientes permisos adicionales al final del archivo: 
    - 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. Aplica el rol: 
    kubectl -n APIGEE_NAMESPACE apply -f apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml

Después de completar las opciones anteriores, deberás reiniciar tus pods de apigee-ingressgateway-manager.

  1. Enumera los Pods de ingress-manager que se reinstalarán o volverán a crear: 
    kubectl get deployments -n APIGEE_NAMESPACE

    Resultado de ejemplo:

    NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager       1/1     1            1           32d
apigee-ingressgateway-manager   2/2     2            2           32d
  2. Reinicia los Pods ingress-manager: 
    kubectl rollout restart deployment -n APIGEE_NAMESPACE apigee-ingressgateway-manager
  3. Después de unos minutos, supervisa los Pods de apigee-ingressgateway-manager: 
    watch -n 10 kubectl -n APIGEE_NAMESPACE get pods -l app=apigee-ingressgateway-manager

    Resultado de ejemplo:

    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 CORREGIDO en la versión híbrida 1.14.3 y 1.15.0

ApigeeTelemetry puede quedar atascado en el estado creating.

Este problema se detectó en las instalaciones de OpenShift.

Solución alternativa: Modifica la plantilla del gráfico de apigee-operator para crear el acceso correcto al rol de clúster.

  1. Edita el archivo de plantilla helm-charts/apigee-operator/templates/apigee-operators.yaml y busca la definición del clusterrole -apigee-manager-role-. Comienza con lo siguiente: 
    kind: ClusterRole
metadata:
  name: apigee-manager-role-{{ include 'namespace' }}
rules:
  ...
  2. Busca el bloque - apiGroups: apiregistration.k8s.io y agrega el recurso apiservices/finalizers a la lista de recursos: 
    - apiGroups:
  - apiregistration.k8s.io
  resources:
  - apiservices
  - apiservices/finalizers
  verbs:
  - create
  - delete
  - get
  - patch
  - update
  3. Busca el bloque - apiGroups: authorization.k8s.io y agrega el bloque - apiGroups: apigee.cloud.google.com después del final del bloque con el siguiente texto: 
    - apiGroups:
  - apigee.cloud.google.com
  resources:
  - apigeetelemetries/finalizers
  verbs:
  - get
  - patch
  - update

    Por ejemplo:

    - apiGroups:
  - authorization.k8s.io
  resources:
  - subjectaccessreviews
  verbs:
  - create
  - get
  - list
- apiGroups:
  - apigee.cloud.google.com
  resources:
  - apigeetelemetries/finalizers
  verbs:
  - get
  - patch
  - update
  4. Aplica los cambios al gráfico de apigee-operator:

    Prueba de validación:

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

    actualiza el gráfico:

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

Los productos de API están limitados a 50 rutas de acceso. Si agregas rutas adicionales, se mostrará un mensaje de error: Operation group limit of 51 exceeded in Operation Config

Solución alternativa: Usa patrones de comodines para combinar rutas de acceso a recursos y operaciones, como se describe en Configura rutas de acceso a recursos.

Solución alternativa: Crea varios productos de API. Esta solución alternativa se verificó y es viable para quienes agregan muchos proxies de API a un producto de API. La app asociada con tus productos de API debería actualizarse para incluir el nuevo, pero se demostró que no es necesario cambiar las credenciales ni los detalles de la solicitud del cliente.

291294211 Apigee ABIERTA

Se produce un error cuando se usan las APIs de informes personalizados y estadísticas al seleccionar por tipo de tarifa para las instalaciones que usan la monetización.

Solución alternativa: Recupera todos los tipos de tarifas del lado del cliente antes de filtrar.

391140293 Apigee
Apigee Hybrid		 corregidas

El escalamiento de los Pods de entrada de Istio puede causar un error 503.

El escalamiento de los Pods de entrada de Istio puede provocar, en ocasiones, un error 503. Si se produce un error 503, los registros del balanceador de cargas muestran el siguiente mensaje: statusDetails: backend_connection_closed_before_data_sent_to_client.

Solución alternativa: Escala manualmente los Pods de entrada de Istio.

368155212 hybrid 1.14.0
hybrid 1.14.1		 CORREGIDO en la versión hybrid 1.14.2

La rotación de credenciales de Cassandra de ESS y no ESS no funciona en organizaciones con límites de proxy mejorados.

El tráfico del entorno de ejecución no se ve afectado.

401624396 hybrid 1.13.x
hybrid 1.14.x		 ABIERTA El trabajo de restablecimiento de Apigee falla mientras se restablecen las copias de seguridad de GCP o HYBRID de los proveedores de servicios en la nube tomadas de una configuración multirregional. Este problema no afecta el restablecimiento de CSI.

Las copias de seguridad que se toman de la configuración multirregional con los proveedores de servicios en la nube de GCP y HYBRID contienen información sobre todas las regiones de Hybrid que existían cuando se tomó la instantánea. Y, como esas regiones ya no existen, el trabajo de restablecimiento entrará en conflicto con el estado actual de Cassandra y fallará con el siguiente error: Unrecognized strategy option passed to NetworkTopologyStrategy.

401746333 Apigee
hybrid 1.12.4
hybrid 1.13.3
hybrid 1.14.1		 corregidas

La biblioteca Nimbus JOSE + JWT puede causar un java.lang.ClassCircularityError cuando se usa una política de JavaCallout .

Si tienes una organización habilitada para Apigee Hybrid con una política de JavaCallout que usa la biblioteca Nimbus JOSE + JWT, no actualices a Hybrid 1.12.4, Hybrid 1.13.3 ni Hybrid 1.14.1.
397693324 hybrid 1.14.0
hybrid 1.14.1		 CORREGIDO en la versión hybrid 1.14.2

La rotación de credenciales de Cassandra multirregional de ESS y no ESS fallará en todas las regiones, excepto en la primera.

El tráfico del entorno de ejecución no se ve afectado.

Sigue la solución alternativa proporcionada para resolver este problema.

391861216 hybrid 1.13.x
hybrid 1.14.x		 CORREGIDO en la versión híbrida 1.13.3 y en la versión híbrida 1.14.1 Reiniciar los Pods de Cassandra en un clúster de Hybrid que se restableció con los proveedores de servicios en la nube GCP o HYBRID hará que los Pods entren en el estado CrashLoopBackoff. Este problema no afecta el restablecimiento de CSI.

Los Pods de Cassandra se reiniciarán después de aplicar los cambios de anulación de Cassandra, como cuando se vuelve a habilitar la copia de seguridad, lo que activará este problema. Los registros de un Pod de Cassandra en el estado CrashLoopBackoff mostrarán el siguiente error: Cannot change the number of tokens from 512 to 256.

Sigue la solución alternativa proporcionada para resolver este problema.

388608440 hybrid 1.11.x
hybrid 1.12.x		 CORREGIDO en la versión 1.12.4 de Hybrid y posteriores El trabajo de copia de seguridad de Apigee no limpia las instantáneas intermedias de Cassandra.

En algunos casos excepcionales, el trabajo de copia de seguridad de Apigee no limpia las instantáneas intermedias de Cassandra que crea mientras realiza copias de seguridad con los proveedores de servicios en la nube de HYBRID o GCP. Esto solo sucede si un problema subyacente impide que el proceso de copia de seguridad se conecte correctamente al servidor remoto o a Cloud Storage. Si el problema de conexión persiste, esas instantáneas de Cassandra restantes pueden acumularse con el tiempo y usar el almacenamiento en los discos de Cassandra. Si te afecta, corrige el problema de conexión subyacente y, luego, sigue los pasos que se indican en la guía de solución de problemas de Cassandra para borrar las instantáneas de Cassandra de forma manual.

392135466 hybrid 1.14.0 ABIERTA No se admite el encadenamiento de proxies con mTLS cuando se usan límites de proxy mejorados por entorno
383334511 Apigee ABIERTA Se creó la entrada de KVM con un nombre inesperado

Cuando se usa una política KeyValueMapOperations con el alcance apiproxy y se llama a la operación <Put> de la política en un flujo compartido a través de un hook de flujo, la entrada de KVM se crea con el nombre del flujo compartido. Se espera que se cree con el nombre del proxy de API.

384937220

 hybrid 1.14.0 corregidas Es posible que falle la creación de la versión de Helm cuando hay varios hosts virtuales.

Cuando hay varios hosts virtuales, la creación de la versión de Helm puede fallar debido a nombres de ApigeeRoute en conflicto. La solución alternativa es ejecutar los siguientes comandos para cada host virtual cuando se crea:

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

Donde:

  • PROJECT_ID_SUFFIX es un sufijo único para el encadenamiento interno de tu proyecto en Kubernetes. Puedes encontrar este sufijo con el siguiente comando: 
    kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining

    El resultado se verá similar a lo siguiente:

    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

    En el resultado de ejemplo, my-project--1234567 es el PROJECT_ID_SUFFIX.

  • APIGEE_NAMESPACE es el espacio de nombres de Apigee.
  • NEW_ENV_GROUP_NAME es el nombre del grupo de entornos adicional. Actualiza este valor para cada host virtual.

N/A

 Apigee Hybrid ABIERTA Una cuenta de servicio no válida puede enviar la API de UpdateControlPlaneAccess a un bucle de reintento.

Si un usuario proporciona una cuenta de servicio no válida a la API de UpdateControlPlaneAccess, la operación entra en un bucle de reintento que bloquea de manera efectiva a la organización para que no invoque la API hasta que se agote el tiempo de espera de la operación.
373722434 hybrid 1.13.x CORREGIDO a partir de la versión 1.13.2 de Hybrid El trabajo de copia de seguridad de Apigee no puede subir datos a buckets de Cloud Storage con políticas de retención.

Cuando se usa el proveedor de servicios en la nube de GCP, el trabajo de copia de seguridad de Apigee no puede subir a los buckets de Cloud Storage con políticas de retención. Es posible que los archivos de copia de seguridad se dejen en el bucket de Cloud Storage con un tamaño de archivo de 0 bytes.

Solución alternativa: Inhabilita las políticas de retención en el bucket de Cloud Storage.

341099433

 Apigee Hybrid ABIERTA El componente apigee-logger no admite la federación de identidades para cargas de trabajo.

apigee-logger utiliza cuentas de servicio de IAM de Google para enviar registros a Cloud Logging. Esto se debe a que FluentBit no es compatible con la federación de identidades de cargas de trabajo, lo que impide que apigee-logger use esta función.

N/A

 Apigee Hybrid ABIERTA El seguimiento distribuido en Apigee Hybrid no es compatible con las organizaciones que usan la residencia de datos.

N/A

 Apigee ABIERTA Apigee no admite la nueva encriptación de claves, lo que significa que, incluso después de la rotación, se seguirá usando la versión de clave anterior y no podrás cambiar la clave de CMEK después de crear la organización.

270574696

 Apigee corregidas Apigee no admite Cloud External Key Manager.

268104619

 Apigee
Apigee Hybrid		 ABIERTA En la política OASValidation, cuando especificas un tipo de array en el encabezado, el MP arrojará un error, incluso si la entrada es válida.

364872027

 Apigee
Apigee Hybrid		 corregidas Error de análisis de PEM en las políticas de JWT/JWS debido a un formato no estándar

En el caso de Apigee y Apigee Hybrid 1.13 y versiones posteriores, cualquier desviación en el formato PEM requerido de las claves que se usan en las políticas de JWS o JWT de Apigee puede generar un error de análisis. Por ejemplo, no se permite colocar ningún carácter que no sea una línea nueva (/n) inmediatamente antes de la línea "-----END" (límite posterior al encapsulamiento), lo que generará un error.

Para evitar este error, asegúrate de que no haya caracteres distintos de una línea nueva, como espacios finales o barras, que precedan inmediatamente al límite posterior al encapsulamiento.

Para obtener más información sobre la codificación que se usa para las claves públicas o privadas, consulta RFC 7468 de IETF.

310191899

 Apigee
Apigee Hybrid		 ABIERTA Tiempo de espera cuando se implementan proxies de API y flujos compartidos

Es posible que los siguientes extremos experimenten tiempos de espera cuando se usen con un volumen alto de consultas por segundo (QPS):

Para reducir la probabilidad de que se produzcan tiempos de espera, te recomendamos que establezcas un objetivo de 1 QPS cuando uses estos extremos o que verifiques el estado de una implementación antes de intentar otra.

329304975

 Apigee corregidas Límite en la cantidad de rutas de acceso base por entorno

Apigee aplica un límite temporal de 1,000 rutas de acceso base por entorno para evitar posibles fallas cuando se implementan revisiones del proxy de API.

Mientras este límite esté vigente, puedes implementar hasta 1,000 revisiones del proxy de API (cada una con una sola ruta de acceso base) por entorno. Si tus proxies de API o revisiones contienen más de una ruta de acceso base, la cantidad total de rutas de acceso base por entorno no debe superar las 1,000.

333791378

 Hybrid 1.12.0 ABIERTA La herramienta de migración de Helm no admite las funciones de copia de seguridad y restablecimiento de Cassandra

Si deseas conocer los pasos necesarios para instalar un parche para la solución alternativa, consulta Soluciona problemas.

310384001

 hybrid 1.11.0 ABIERTA Las fallas de validación de certificados pueden mostrar un error 502 en lugar de una respuesta de error 503 cuando los usuarios agregan la etiqueta <Enforce>true</Enforce> en el bloque <SSLInfo> de destino para la validación predeterminada de certificados TLS de extremo de destino.

289583112

 Apigee ABIERTA La política OASValidation no funciona con los requisitos de seguridad globales en las especificaciones de OpenAPI.

Si la política OASValidation especifica un <OASResource> con requisitos de seguridad establecidos a nivel global, no se aplicarán los requisitos de seguridad.

Solución alternativa: Para garantizar la aplicación, todos los requisitos de seguridad deben establecerse en el nivel de operación en la especificación de OpenAPI que se pasa en el elemento <OASResource> de la política OASValidation.

205666368

 Apigee
Hybrid 1.10.2
Hybrid 1.10.3		 CORREGIDO en Apigee 1-10-0-apigee-6 y, además,
Hybrid 1.10.3-hotfix.1		 Apigee Hybrid no valida el certificado de destino de forma predeterminada.

Consulta Información para configurar opciones de TLS en un extremo o un servidor de destino.

295929616

 Hybrid 1.10.0 y versiones posteriores RESUELTO en la versión Hybrid 1.10.3 La instalación de Apigee Hybrid 1.10 en OpenShift (OSE) puede fallar con errores de memoria insuficiente.

La instalación o actualización de Apigee Hybrid 1.10.0 a 1.10.2 puede fallar en OSE debido a errores de memoria insuficiente. Se corrigió en la versión 1.10.3 de Apigee Hybrid.

292118812

 híbrido 1.10.1 corregidas Es posible que apigee-udca no respete la configuración del Proxy HTTP.

Si el firewall fuerza todo el tráfico a través de un proxy de reenvío, apigee-udca puede pasar a un estado de retirada del bucle de fallas.

292558790

 Apigee
hybrid 1.8.0 y versiones posteriores		 ABIERTA La política OASValidation falla con el error Unable to parse JSON.
  • La política OASValidation falla cuando el contenido JSON no coincide con el patrón previsto. Por ejemplo, si un encabezado espera un valor en el formato <text>@<text> y se propaga con texto al que le falta el símbolo @, la política fallará y mostrará el error Unable to parse JSON.
  • Si la política OASValidation especifica un <OASResource> que contiene un parámetro path que usa un esquema $ref, la política generará un error Unable to parse JSON - Unrecognized token.

    Solución alternativa: No uses $ref en los parámetros path de la especificación de OpenAPI especificada en el elemento <OASResource>.

297012500

 Apigee
hybrid 1.8.0 y versiones posteriores		 ABIERTA Problemas de implementación con la validación de OAS cuando se usa una referencia circular
  • La implementación de Apigee fallará en la política de validación de OAS cuando se usen referencias circulares para la especificación de OpenAPI 3.0.0, ya que entra en un bucle infinito.

    • Solución alternativa: Usa un archivo yaml de especificación de OpenAPI sin referencias circulares.

289254725

 Apigee
Apigee 1-10-0-apigee-3
híbrido 1.8.8
híbrido 1.9.3		 CORREGIDO en Apigee 1-10-0-apigee-5
CORREGIDO en el híbrido		 Es posible que fallen las implementaciones de proxy que incluyan la política OASValidation.

Las implementaciones de proxy que incluyen la política OASValidation pueden fallar si se cumple lo siguiente:

  • La especificación de OpenAPI que se usa para la validación en la política OASValidation está en formato YAML.
  • La especificación de OpenAPI con formato YAML contiene un número de punto flotante. Por ejemplo: 
    schema:
type: number
example: 2.345

284500460

 Apigee
Apigee 1-10-0-apigee-1		 corregidas Aumento de la latencia para la política de Message Logging cuando se usa con Cloud Logging.

Para evitar el aumento de la latencia en las respuestas al cliente, la política de Message Logging debe estar adjunta a PostClientFlow. Para obtener más información sobre el uso de políticas en PostClientFlows, consulta Controla proxies de API con flujos.

282997216

 Hybrid 1.8.0 y versiones posteriores
Hybrid 1.9.0 y versiones posteriores		 ABIERTA Caracteres especiales no permitidos en la contraseña de Cassandra Jolokia

Usa solo caracteres alfanuméricos para la contraseña de Cassandra Jolokia. El uso de caracteres especiales (incluidos, sin limitaciones, “!”, “@”, “#”, “$”, “%”, “^”, “&”, y “*”) puede causar que el inicio de Cassandra falle.

270371160

 hybrid 1.9.0 y versiones posteriores corregidas La puerta de enlace de entrada de Apigee solo admite algoritmos de cifrado o protocolo TLS1.2+

La puerta de enlace de entrada de Apigee solo es compatible con TLS1.2+, y no con versiones anteriores de TLS.

269139342

 hybrid 1.7.0 y versiones posteriores corregidas apigeectl getOrg no sigue la configuración de HTTP_PROXY en overrides.yaml

La validación de la organización de Apigee no sigue las reglas del proxy de reenvío HTTP establecidas en overrides.yaml. Configura validateOrg: false para omitir esta validación.

266452840

 Apigee
Hybrid 1.7.0 y versiones posteriores
Hybrid 1.8.0 y versiones posteriores
Hybrid 1.9.0 y versiones posteriores		 corregidas Los sockets web no funcionan con Anthos Service Mesh 1.15.3 en Apigee X y Apigee Hybrid

En ciertas circunstancias, los sockets web no funcionan para Apigee X y Apigee Hybrid cuando se usa Anthos Service Mesh 1.15.3-asm.6.

287922301

 Apigee ABIERTA Inexactitudes en las tarifas de monetización en torno a los umbrales de bandas por volumen

Debido al diseño actual, es posible que se evalúen tarifas de monetización inexactas para las transacciones que se realicen cerca de un umbral de banda de volumen. Esto se manifiesta como demasiadas transacciones que se evalúan con la tarifa previa al umbral y es más probable que ocurra cuando se producen muchas transacciones para una combinación determinada de desarrollador y plan tarifario en un período de 30 segundos. Esto significa que los informes de monetización informarán en exceso los cargos con tarifas por bandas decrecientes y, en defecto, los cargos cuando aumenten las tarifas por bandas. Este problema se produce en Apigee X y Apigee Hybrid, y no tiene una solución alternativa conocida. La resolución ya comenzó y estará disponible en una versión futura.

242213234

 Apigee corregidas El producto de API no se carga con el error “no hay conexiones disponibles”

Este error puede mostrarse cuando se intentan cargar productos de API: “Los productos no se cargaron correctamente. Error: No hay conexiones disponibles en los agentes de conexión de Apigee”.

El problema se produce después de habilitar el control del servicio de VPC en el proyecto de Google Cloud y agregar iamcredentials.googleapis.com como uno de los servicios restringidos en el perímetro de servicio.

Solución: Crea una regla de salida de forma manual, como la siguiente: 

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

247540503

 Hybrid 1.7.0 y versiones posteriores
Hybrid 1.8.0 y versiones posteriores		 corregidas Una condición de carrera con búsqueda de claves de encriptación puede causar fallas en la búsqueda de KVM.

En determinadas circunstancias, con una capacidad de procesamiento muy alta, una condición de carrera con la búsqueda de claves de encriptación puede causar fallas en la búsqueda de KVM.

258699204

 hybrid 1.8.0 y versiones posteriores corregidas Las solicitudes de memoria y los límites predeterminados de los Pods de métricas cambiaron involuntariamente en 1.8.x.

Si observas problemas con los Pods de apigee-telemetry-app o apigee-telemetry-proxy que no se ejecutan, cambia las propiedades de metrics solicitudes de recursos y límites de recursos para que coincidan con los siguientes valores predeterminados en Referencia de la propiedad de configuración: métricas.

Propiedad de configuración Valor predeterminado
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

Aplica los cambios con apigeectl apply con la marca ‑‑telemetry: 

apigeectl apply --telemetry -f overrides.yaml

260324159

 Apigee 1-9-0-apigee-16 corregidas Implementaciones de flujo compartido y proxy de API de hasta 30 minutos.

Los proxies de API y los flujos compartidos pueden tardar entre 20 y 30 minutos en implementarse en el plano del entorno de ejecución en ciertas circunstancias debido a un error de “socket cerrado” en el sincronizador.

214447386

 Todos ABIERTA El mensaje "config not modified" se muestra en los registros de auditoría de acceso a los datos de la API de Apigee como un Error.

Se espera que esto suceda cada minuto y no afecta tu costo de facturación.

260772383

 hybrid 1.8.0 y versiones posteriores ABIERTA Error de vinculación de socket en la plataforma AKS

Si instalas hybrid en AKS, es posible que veas este error:

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

Solución: Agrega la siguiente estrofa svcAnnotations al archivo de anulaciones:

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

Consulta Configura el entorno de ejecución de hybrid. Consulta también Usa un balanceador de cargas interno con AKS.

241786534

 hybrid 1.8.0 y versiones posteriores corregidas A veces, MART no puede conectarse con FluentD.

Cuando se usa UDCA con permiso de organización, a veces, MART no puede conectarse a FluentD. El UDCA con permiso de la organización es el predeterminado en la versión hybrid 1.8 de Apigee. Consulta orgScopedUDCA en la referencia de la propiedad de configuración.

N/A hybrid 1.6.0 y versiones posteriores ABIERTA apigee-logger no funciona en Anthos BareMetal con CentOS o RHEL.

Después de la migración de apigee-logger de fluend a fluent-bit en la versión 1.6.6 de Apigee Hybrid, el registrador dejó de funcionar en Anthos BareMetal con CentOS o RHEL.
207762842 hybrid 1.5.0 y versiones posteriores corregidas Apigee-logger no envió los registros a Cloud Logging.

Los parámetros de configuración actuales de apigee-logger, incluidos los sondeos en funcionamiento, no son compatibles con el entorno de ejecución de Kubernetes, por lo que los registros no se envían a Cloud Logging como se espera. Este problema también hace que los Pods de apigee-logger fallen con regularidad. Este problema afecta las instalaciones de Apigee Hybrid en AKS, Anthos Bare Metal y otras plataformas. Ten en cuenta que, en algunos casos, este problema genera un volumen de registro excesivo.

191291501, 191000617 Apigee corregidas No se podrá cambiar la dirección de correo electrónico de una entidad de desarrollador en la IU.
191002224 hybrid 1.5.0 y versiones posteriores corregidas No se puede cambiar una dirección de correo electrónico cuando se usa la API de PUT /organizations/{org_name}/developers/{developer_email}.
184555974 hybrid 1.5.0 y versiones posteriores corregidas Fluentd apigee-logger no puede analizar registros en el clúster de OpenShift.
N/A Archivar implementaciones ABIERTA No se admite la administración y depuración de implementaciones de archivos de Apigee en la IU

En la IU de Apigee, puedes hacer lo siguiente:no se puede ver, confirmar el estado de implementación o administrar tus implementaciones de archivo, como se describeImplementa un proxy de API o usa la IU de depuración como se describe enUsa la depuración. Como solución alternativa, puedes usar gcloud o la API para enumerar todas las implementaciones de archivo en un entorno y usar la API de depuración.

N/A Archivar implementaciones ABIERTA No se admite la reversión de una implementación de archivo

Por el momento, no se admite la reversión de una implementación de archivos. Para quitar una versión de una implementación de archivo, debes volver a implementar una versión anterior de un archivo o borrar el entorno.

421402073

 Apigee en VS Code ABIERTA La autenticación de Google en las políticas no es compatible con Apigee en Visual Studio Code (VS Code)

La autenticación de Google en las políticas ServiceCallout y ExternalCallout, como se describe en Usa la autenticación de Google, no es compatible con Apigee en VS Code.
422757662 Apigee 1-15-0-apigee-5
hybrid 1.15.0		 CORREGIDO en Apigee 1-15-0-apigee-7 y Apigee 1-15-0-apigee-8

Los encabezados x-b3 no están disponibles cuando DistributedTrace está inhabilitado

En las versiones 1-15-0-apigee-5 y 1.15.0 de Apigee Hybrid, Apigee dejó de enviar encabezados x-b3 a los extremos de destino cuando se inhabilita el seguimiento distribuido. Sin embargo, algunas instalaciones de Apigee dependían de que se enviaran encabezados x-b3, independientemente de si el seguimiento distribuido estaba habilitado o inhabilitado. Por lo tanto, este cambio se revirtió a partir de Apigee 1-15-0-apigee-7.

146222881 hybrid 1.3.0 y versiones posteriores corregidas Error de encabezado HTTP no válido

Error de encabezado HTTP no válido: la entrada de Istio cambia todas las respuestas de destino entrantes al protocolo HTTP2. Debido a que el Message Processor híbrido solo admite HTTP1, es posible que veas el siguiente error cuando se llama a un proxy de API:

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

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

Si ves este error, puedes realizar alguna de las siguientes acciones para corregir el problema:

  • Modifica el servicio de destino para omitir el encabezado de host en la respuesta.
  • Si es necesario, quita el encabezado de host con la política AssignMessage en el proxy de API.

420985360

 Portal integrado ABIERTA SmartDocs
  • Apigee admite la especificación de OpenAPI 3.0 cuando publicas tus APIs mediante SmartDocs en tu portal, aunque aún no se admite un subconjunto de funciones. Por ejemplo, las propiedades allOf para combinar y extender esquemas.

    En caso de que se haga referencia a una función no admitida en la especificación de OpenAPI, en algunos casos las herramientas la ignorarán la función, pero renderizarán la documentación de referencia de la API. En otros casos, una función no admitida generará errores que impiden la correcta renderización de la documentación de referencia de la API. En cualquier caso, deberás modificar la especificación de OpenAPI para evitar el uso de la función no compatible hasta que se admita en una versión futura.

  • La función Prueba esta API tiene las siguientes limitaciones:
    • El encabezado Accept se configura como application/json, sin importar el valor establecido para consumes en la especificación de OpenAPI.
    • No se admiten los encabezados de la solicitud de un tipo que no sea de cadena.
N/A Portal integrado ABIERTA Administrador del portal

  • En este momento, no se admiten las actualizaciones simultáneas del portal (como ediciones a las páginas, el tema, CSS o las secuencias de comandos) por parte de múltiples usuarios.
  • Si borras una página de documentación de referencia de la API del portal, no hay manera de volver a crearla. Deberás eliminar y volver a agregar el producto API y volver a generar la documentación de referencia de la API.
  • Cuando personalizas el tema de tu portal, los cambios pueden tardar hasta 5 minutos en aplicarse por completo.
N/A Portal integrado ABIERTA Funciones del portal

La Búsqueda se integrará al portal integrado en una versión futura.

N/A Portal integrado ABIERTA Proveedor de identidad SAML

El cierre de sesión único (SLO) con el proveedor de identidad SAML no es compatible con los dominios personalizados. Para habilitar un dominio personalizado con un proveedor de identidad SAML, deja el campo URL de cierre de sesión en blanco cuando establezcas la configuración de SAML.

191815997 hybrid 1.6.0 y versiones posteriores corregidas Si un cliente híbrido configura un proxy de reenvío para el proxy de API, el token de Google no funcionará, a menos que tenga acceso directo a *.googleapis.com.
N/A Apigee CORREGIDO en Apigee 1-12-0-apigee-2 y, además, Hybrid 1.12.0 La supervisión de API y Cloud Monitoring muestran aumentos anormales

  • Los recuentos de solicitudes y respuestas de proxy de API (para proxy y destinos) muestran aumentos repentinos anormales

    Este es un ejemplo que muestra un aumento repentino:

    (aumentar el tamaño de la imagen)

  • Debido a un error, el sistema registra el recuento de forma incorrecta durante un período breve y se corrige el recuento. Esto sucede cuando hay una reducción en el tráfico de la API (lo que da como resultado una reducción de la escala verticalmente de las puertas de enlace de API).
  • Para distinguir los aumentos repentinos reales en las solicitudes y este problema, consulta la página Estadísticas de proxies y Rendimiento objetivo de la página de estadísticas de la API

Métricas afectadas:

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

Métricas nuevas

Puedes usar las métricas nuevas para evitar este problema.

Métrica Descripción
apigee.googleapis.com/proxy/request_count Cantidad de solicitudes al proxy de Apigee desde que se registró la última muestra.
apigee.googleapis.com/proxy/response_count Cantidad de respuestas que envía el proxy de API de Apigee.
apigee.googleapis.com/proxy/latencies Distribución de latencias, que se calculan desde el momento en que el proxy de Apigee recibió la solicitud hasta el momento en que se envió la respuesta del proxy de Apigee al cliente.
apigee.googleapis.com/target/request_count Cantidad de solicitudes enviadas al destino de Apigee desde que se registró el último muestreo.
apigee.googleapis.com/target/response_count Cantidad de respuestas recibidas del destino de Apigee desde que se registró la última muestra.
apigee.googleapis.com/target/latencies Distribución de latencias, que se calculan desde el momento en que se envió la solicitud al objetivo de Apigee hasta el momento en que el proxy de Apigee recibió la respuesta. Este tiempo no incluye la sobrecarga del proxy de API de Apigee.

Para Apigee Hybrid, consulta Descripción general de la recopilación de métricas y Visualiza las métricas.

203778087 Hybrid 1.5.3 y versiones posteriores ABIERTA apigee-stackdriver-logging-agent se ejecuta como raíz.

Solución alternativa: Inhabilita el agente de Logging en hybrid.

205629443 Apigee corregidas Si ServiceCallout se envía y se olvida (sin etiqueta <Response>), puede ocurrir una condición de carrera si se produce otra política después de ella.

Solución: Para mantener el comportamiento enviar y olvidar, haz lo siguiente:

  1. Agrega <Response>calloutResponse</Response> a ServiceCallout.
  2. Establece continueOnError en true.
207719377 Apigee CORREGIDO en Apigee 1-11-0-apigee-1 Si hay más de una política de SpikeArrest en un paquete, se producirán errores 502.

Solución: Evita usar más de una política de SpikeArrest en el proxy para evitar el problema.

209097822 Hybrid 1.5.0 y versiones posteriores
Apigee		 corregidas Es posible que las actualizaciones dinámicas que se realicen a una tasa de protección contra aumentos de tráfico no se reflejen de inmediato

Para una clave en particular, si hay tráfico continuo, es posible que la clave no esté limitada por la frecuencia actualizada. Si hay cinco minutos sin tráfico para una clave en particular, la tarifa se reflejará.

Solución: Vuelve a implementar el proxy con una variable de referencia nueva si la velocidad tiene efecto de inmediato. También puedes usar dos protecciones de aumento condicionales con diferentes variables de flujo para ajustar la velocidad.

221305498 Apigee ABIERTA La supervisión de API puede mostrar el código de error de “(no se configuró)”.

La supervisión de API de proxies de API configurables puede mostrar un código de error de “(no se configuró)” para las respuestas del objetivo con un estado que no sea 2xx.
246774745 Apigee corregidas No se respeta el valor de io.timeout.millis cuando se usa con varios destinos dinámicos.

Si un proxy establece dos o más valores io.timeout.millis en dos o más flujos con el mismo host de destino, solo se respeta un valor io.timeout.millis.

245664917 hybrid 1.8.x corregidas Se puede ignorar el error de actualización de Apigee Hybrid

Durante la actualización a Apigee Hybrid 1.8.x, después de ejecutar apigeectl init y confirmar que check-ready se realizó de forma correcta, es posible que notes que el trabajo de validación del esquema de Cassandra está en un estado de error si ves los Pods. Esta es una condición inofensiva y puedes avanzar con seguridad al siguiente paso en el procedimiento de actualización.

300660653 Apigee corregidas Debería aparecer un error, pero no se muestra, cuando se implementan proxies con la misma ruta de acceso en varios entornos que están adjuntos a la misma instancia y al mismo grupo de entornos.

No se permite implementar proxies con la misma ruta de acceso en varios entornos que estén conectados a la misma instancia y al mismo grupo de entornos, y se debe mostrar un mensaje de advertencia sobre un conflicto de ruta de acceso base. En cambio, no se muestra ningún error y las implementaciones parecen ser exitosas.

Solución alternativa: Cuando realices la implementación y después de ella, verifica que no haya conflictos de rutas de acceso base con los proxies implementados y corrígelos según sea necesario.

301458133 Apigee corregidas Algunos intentos de implementación de proxy muestran un error que indica que la revisión es inmutable.

Cuando se intenta guardar un proxy implementado anteriormente, es posible que la implementación falle con un error que indique que la revisión es inmutable.

Solución alternativa: Haz clic en la flecha desplegable junto al botón Guardar y selecciona Guardar como revisión nueva. Luego, vuelve a intentar la implementación.

301845257 Apigee corregidas Si intentas implementar más de 800 proxies en un grupo de entornos, se producirá un error. El límite en el que se muestra un error es inferior a 800 cuando las rutas de acceso base son más largas que 15 caracteres.

315820718 Apigee corregidas Con las solicitudes de proxy de gRPC, los finalizadores de gRPC se quitan de la respuesta

Cuando se realiza una llamada a un servidor de destino de gRPC, el único finalizador que se muestra es "grpc-status". Todos los demás finalizadores se quitan de la respuesta.
341157011 Apigee corregidas Las especificaciones generadas con Gemini Code Assist en Cloud Code que también incluyen caracteres UTF-8 que no son ASCII no se analizan correctamente cuando se suben al concentrador de APIs.

Como resultado, el concentrador de APIs no extraerá las operaciones, las definiciones y otros metadatos correctamente.
338285095 Apigee corregidas Las apps asociadas con un AppGroup no aparecen en la lista de apps de la IU de Apigee. Como resultado, los usuarios no pueden acceder a la página Detalles de la app de la aplicación en la consola. No se admite el uso de la búsqueda en la consola con un nombre de app parcial o una búsqueda de clave de API para la app hasta que se resuelva este problema.

Las organizaciones de Apigee Hybrid no se ven afectadas por este problema, ya que usan la IU clásica para ver los detalles de la app.

Solución alternativa parcial: Hay una lista de todas las apps disponible con las APIs. Consulta organizations.apps.list.
355714868 Monetización
Apigee Hybrid		 CORREGIDO en la versión hybrid 1.14.3, hybrid 1.15.1 y hybrid 1.16.0 Los datos de las tarifas recurrentes, de configuración y de recarga no se registran ni facturan para las organizaciones híbridas

En el caso de las organizaciones híbridas con monetización, los datos de las tarifas recurrentes (RECURRING_FEE), de configuración (SETUP_FEE) y de recarga (TOPUP_FEE) no se registran ni facturan para la facturación pospago. En el caso de la facturación prepaga, la deducción de la billetera se realiza para estas tarifas, pero no se informa.
438850078 Apigee ABIERTA

Se produce una recursión infinita dentro de la política OASValidation cuando una respuesta del backend contiene un tipo de discriminador que es el mismo que el esquema superior. Este problema puede provocar un StackOverflowError.
449012244 Apigee ABIERTA

Usa definiciones de extremos de destino independientes para los destinos de SSE (evento enviado por el servidor). Mezclar extremos de destino SSE y no SSE puede generar un comportamiento incoherente, como variables de flujo response.content vacías.
445936920 Apigee 1-16-0-apigee-2 y versiones posteriores ABIERTA

Es posible que los problemas de configuración de DNS que no se detectaron antes ahora causen errores de DNS. Apigee quitó la funcionalidad de resguardo automático de DNS que estaba en 1-16-0-apigee-2. Esta eliminación quita la resiliencia de la plataforma a los errores de configuración de DNS y ahora podría generar errores de DNS.

Busca errores relacionados en los registros del entorno de ejecución para encontrar errores de resolución de DNS.
383372330 Versiones 1.13.0 del emulador de Apigee hasta la 1.15.1, sin incluirla CORREGIDO en las versiones 1.15.1 y posteriores del emulador de Apigee

Todas las implementaciones de proxy fallan de forma local con mensajes de error, incluido 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
 Solución: Actualiza a una versión 1.15.1 o posterior del emulador de Apigee.